Compaq Software Product Description ___________________________________________________________________ PRODUCT NAME: Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 This Software Product Description describes the following two prod- ucts: o Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS VAX[TM] o Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS Alpha[TM] The Description section describes features common to both products. Any differences in product features are explicitly indicated. DESCRIPTION The DECwindows desktop environment provides a graphical user inter- face to the Compaq OpenVMS VAX and Compaq OpenVMS Alpha operating sys- tems. This interface allows users to interact with OpenVMS VAX and Open- VMS Alpha using a point-and-click technique. DECwindows includes a set of integrated desktop applications that demonstrate the ease of use of this user interface and provides OpenVMS users with a base set of desktop tools. Compaq DECwindows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX provides some new features, including Year 2000 enhancements and the ability to coexist in the same environment with Extended File Spec- ifications (EFS). In addition, Compaq DECwindows Motif Version 1.2-5 for OpenVMS Alpha delivers the New Desktop environment for OpenVMS Alpha systems, which is derived from the CDE (Common Desktop Environment) technology. CDE provides and defines a consistent user interface for end users and a consistent development environment for application developers across multiple platforms. September 1999 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 The graphical user interface that was provided in previous versions of DECwindows Motif is still available and is referred to as the DECwin- dows desktop. The DECwindows desktop is the only desktop provided for OpenVMS VAX. On OpenVMS Alpha, the installation procedure gives users the choice of installing one or both desktops and asks which desktop should be started by default. If both desktops are installed, the user can switch desktops by restarting DECwindows. Both the New Desktop and the DECwindows desktop are based on Motif[R]. Motif is a graphical user interface that is widely acknowledged as the industry standard. The DECwindows desktop provides two window managers: the Motif Win- dow Manager and the XUI Window Manager. Users can switch easily be- tween the two window managers. The DECwindows desktop productivity ap- plications use the Motif toolkit, but they also work with the XUI Win- dow Manager. The DECwindows Motif Version 1.2-5 layered product provides both run- time and programming support for the CDE Motif 1.0 toolkit (Motif Re- lease 1.2.5) and the X Consortium's specification for the X Window Sys- tem[TM], Version 11, Release 5 (X11 R5), and provides run-time sup- port for the Motif Release 1.1.3 and XUI toolkits and X11 R4. Programs developed for the Motif Release 1.2.2 and 1.2.3 toolkits that were provided in previous versions of DECwindows Motif can be run un- der the CDE Motif 1.0 toolkit. This means that users can run XUI and Motif applications, including native applications and, on OpenVMS Al- pha systems, translated applications. (See the Translated Image En- vironment section of this SPD for more information about running trans- lated applications.) X Window System standards supported as part of DECwindows Motif in- clude the X11 network protocol, a base set of workstation fonts, the C language binding for the Xlib programming library, and the C lan- guage binding for the X Toolkit library. 2 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Support of the X11 network protocol in the client library and display server components provides the OpenVMS VAX and OpenVMS Alpha operat- ing systems with the ability to interoperate with other X11-compliant systems in a distributed fashion. DECwindows supports the client/server distribution inherent in the X Window System. This client/server model allows X Window System clients to run on one node and display output to another node, using a trans- port to communicate between the nodes. The Compaq DECwindows Motif Version 1.2-5 for OpenVMS product provides four transport interfaces: local shared memory, DECnet, TCP/IP (using the DIGITAL TCP/IP Services for OpenVMS product or third-party products such as MultiNet[R] and Wollongong), and LAT. Users can also provide their own transport sub- systems and transport interfaces. To determine whether a separately orderable DECwindows Motif based lay- ered product or X application runs on or can communicate with Compaq DECwindows Motif for OpenVMS VAX or OpenVMS Alpha systems, consult the application's Software Product Description. Basic Components The Compaq DECwindows Motif for OpenVMS user environment consists of four basic components: Session Manager Session Manager provides the top-level user interface to a DECwindows workstation. From Session Manager, users can start applications, cus- tomize their session, and perform security management. Session Man- ager also lets users specify the language of the user interface for supported DECwindows applications if they have ordered, installed, and are licensed to use the appropriate DECwindows Motif for OpenVMS lan- guage variant kits. For more information about which DECwindows Motif desktop applications have translated user interfaces, refer to the SPD for that language variant. The DECwindows Motif language variant SPDs also contain in- formation on specific local hardware and software support provided in the language variant kits. 3 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Window Manager The Window Manager lets users control the size and placement of win- dows. The Motif Window Manager is provided as the default window man- ager; users can choose instead to work with the DECwindows XUI Win- dow Manager. The window manager can be chosen by an individual user or by a system manager for an entire system. FileView FileView, a graphical interface to the OpenVMS file system, allows users to navigate the file system and to perform operations on files. DECterm[TM] The DECterm terminal emulator provides workstation users with a tra- ditional character-cell interface for existing OpenVMS features and applications. It is a VT320 terminal emulator. It supports ReGIS[TM] and sixel but is not fully VT340 compatible. Programs written for VT52-, VT100-, VT220-, or VT320-class terminals and using OpenVMS terminal driver features operate without modification in this workstation win- dow. DECterm also provides workstation-oriented features, such as mouse- based cursor positioning, variable screen sizes, and cutting and past- ing of text between DECterm and other DECwindows applications. Many programs can also use these features without modification. Year 2000 Enhancements Compaq DECwindows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX contains the Year 2000 enhancements that originally shipped in ALP- MOTF03_U4012 and VAXMOTF02_U4012 kits. These enhancements are the re- sult of a rigorous and comprehensive analysis and testing of the en- tire OpenVMS operating system. For a full description of Year 2000 enhancements, see the Compaq DECwin- dows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX Release Notes, available in online format on the product media. 4 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 For more information about the OpenVMS Year 2000 Initiative, includ- ing how you can test your environment and applications for Year 2000 readiness, please visit the OpenVMS Year 2000 web page at: http://www.openvms.digital.com/openvms/products /year-2000 Extended File Specifications Extended File Specifications (EFS) optionally extends OpenVMS file names and attributes to match those of Windows 95[R] and Windows[R] NT[TM]. When coupled with Compaq Advanced Server for OpenVMS, EFS allows Open- VMS systems to act as fully functional file servers to Windows 95 and Windows NT clients. In addition, EFS allows OpenVMS system managers to perform OpenVMS system management functions on Windows NT and Win- dows 95 files from an OpenVMS account. This functionality is intended for use primarily with Compaq Advanced Server for OpenVMS, but it is possible to create and manipulate EFS extended file names using a sub- set of DCL commands. For a listing of these commands, see Chapter 4 of the OpenVMS Version 7.2 New Features Manual. For more details about EFS, see the OpenVMS Version 7.2 Cover Letters. The New Desktop Packaged with Compaq DECwindows Motif Version 1.2-5 for OpenVMS Al- pha is the New Desktop environment, which is derived from CDE (Com- mon Desktop Environment) technology. CDE provides a complete desktop environment based on the CDE Motif 1.0 toolkit (Motif Release 1.2.5) and X11 R5. The New Desktop focuses on the user interface and end-user aspects of CDE technology. The New Desktop requires OpenVMS Alpha Version 6.2 or higher. The installation procedure asks users to select the preferred desk- top. This choice determines whether the DECwindows Motif login box or the New Desktop login box appears at startup. After installation, the user can switch desktops anytime. 5 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Existing Motif R1.2.3 applications do not need to be recompiled or re- linked to run in the CDE environment. In addition, it is possible to achieve basic integration of existing applications into CDE without making changes to the application source code. The following CDE components are included in the New Desktop: o Applications - dtlogin: Login Manager, dtgreet - dthello: Screen between Login Manager and Window Manager - dtscreen: Screen saver displays - dtpad: Editor - dtclock: Clock - dtsession: Session Manager - dtstyle: Style Manager - dtwm: Window Manager, Control Panel - dtfile: File Manager, Application Manager - dtcalc: Calculator - dticon: Icon Editor - dtcreate: Action database entry creation tool - dthelpview: Help Viewer - Security options: New Style Manager control for setting and re- viewing authorized users allowed to display applications on the local workstation - Keyboard Selection dialog box - Input Methods Selection dialog box - Save/restore support for DECwindows applications - dthelpgen: utility for creating a help volume for display from the Front Panel Help Viewer 6 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 - dthelptag: compiles HelpTag source files into a run-time help file - dximageview o Libraries - dthelp: Help utility functions - dtsvc: Assorted utility routines - dtwidget: CDE custom widgets The following CDE components are replaced by existing DECwindows Mo- tif applications for this release of the New Desktop: o dtmail - Replaced by DECwindows Mail o dtcm - Replaced by DECwindows Calendar o dtterm - Replaced by DECwindows DECterm o Print Manager - Replaced by DECwindows Print widget The following CDE components are not included in this release of the New Desktop: o Application Builder o ToolTalk - ICCCM transfer mechanisms are implemented to emulate cer- tain ToolTalk functions internally, but ToolTalk messaging services APIs are not available to develop against. o Windowing Korn shell o Multipurpose Internet Mail Extensions (MIME) support Desktop Productivity Applications Compaq DECwindows Motif for OpenVMS provides a set of integrated desk- top applications that employ a common look and feel to help users eas- ily master their computing environment. 7 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 The following desktop applications are available with Compaq DECwin- dows Motif Version 1.2-5 for OpenVMS: o Bookreader[TM] - A tool for viewing the contents of books that are distributed and stored on line. o Calculator - A basic scientific calculator. o Calendar - A personal time management system. o Cardfiler - A desktop card index or flip file, similar to an on- line address or phone book. o Clock - An analog and/or digital clock with an alarm. o CDA[TM] Viewer - A tool for reading documents containing compound text, graphics, and image data on DECwindows workstations. o Computer-based instruction - An online tutorial for novice Motif users; users can learn how to use the mouse and perform other sim- ple operations with Motif. o DECsound - An easy-to-use application that lets you play recorded messages, record audio messages, mail recorded messages, and in- clude recorded audio messages in compound documents. Note that DECsound is available for use on these TURBOchannel systems only: - DEC 3000 Model 400 series - DEC 3000 Model 500 series - DEC 3000 Model 700 series - DEC 3000 Model 900 series - VAXstation[TM] 4000 Models VLC, 60, and 90 Please also note that DECsound may not be supported in future versions of Compaq OpenVMS and Compaq DECwindows Motif for OpenVMS. o Mail - A DECwindows user interface to the OpenVMS Mail facility. o Message window - A window that displays system messages, such as new mail notification or system manager messages. 8 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 o Notepad - A simple text editor. o Paint - A simple bitmap graphics editor. o Print Screen - A tool for capturing images on the screen. Images can be printed directly or saved to a file. o Puzzle - A game of numbered puzzle tiles. The DECW$EXAMPLES directory in the Compaq DECwindows Motif for Open- VMS product supplies several audio images (such as animal sounds, laugh- ter, and various alarm tones) that can be played back using DECsound on VAXstation 4000 series and DEC 3000 series workstations. The CDA Viewer can be used to view documents that contain audio images. In ad- dition, DECwindows Mail can be configured to include the audio edi- tor for sending and receiving voice mail messages. On OpenVMS VAX sys- tems, ALL-IN-1[TM] MAIL can be configured to include the audio edi- tor for sending and receiving voice mail messages. Netscape[R] Navigator[R] support Each DECwindows Motif Version 1.2-3, 1.2-4, and 1.2-5 license permits the use of Netscape Navigator for OpenVMS on a single CPU. Netscape Navigator Version 3.03 runs on OpenVMS VAX Version 6.2 or later and on OpenVMS Alpha Version 6.2 or later. The Netscape Navigator for OpenVMS Version 3.03 web browser can be down- loaded from the following location: http://www.openvms.digital.com/openvms/products/ips Netscape Navigator for OpenVMS Version 3.03 is also available on the Software Products Library CD-ROM. For a description of Netscape Nav- igator features and functionality, see the Netscape Navigator Soft- ware Product Description, available at the following URL: http://www.openvms.digital.com/openvms/products/ips Please note that, starting with Compaq DECwindows Motif Version 1.2- 5 for OpenVMS, Compaq Computer Corporation will no longer distribute or support the Spyglass[TM] Enhanced Mosaic[TM] web browser, which was 9 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 provided in previous versions of the DECwindows Motif for OpenVMS prod- uct. Compaq recommends that DECwindows Motif customers who use Spy- glass Enhanced Mosaic replace it with Netscape Navigator. Support for MIT Utility Programs Several MIT utility programs, bitmaps, and the Miscellaneous Utili- ties Library from the MIT X11 Release 4 and 5 distribution are included in the DECW$UTILS directory of the Compaq DECwindows Motif for Open- VMS layered product. The sources and images for a subset of these MIT utilities are included. The XPR (X Print) utility, which allows users to capture and print the contents of windows, is provided with Com- paq DECwindows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX. A complete list of available MIT programs is included in the Compaq DECwindows Motif Version 1.2-5 for OpenVMS Release Notes. DECwindows Motif for OpenVMS Online Help System The DECwindows Motif help system uses the familiar Bookreader inter- face to display help and retrieve help information. This help system includes a table of contents and cross-referencing through the use of hotspots. The DECwindows desktop applications use the DECwindows Motif help sys- tem. When invoking help, either from a help menu or from context-sensitive help, Bookreader is started and a help topic is displayed. Local Language Support DECwindows Motif is available in many local languages. Please contact your local Compaq office for the latest information about availabil- ity of options and supported multilingual configurations. For more de- tails on the language variants, refer to the specific language-variant SPDs. Refer also to the Ordering Information and Software Licensing sections of this SPD. Programming Support 10 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 The Compaq DECwindows Motif for OpenVMS environment includes an ex- tensive set of programming libraries and tools for use by application developers. The libraries are provided in the form of shareable im- ages. While CDE Motif 1.0 (Motif Release 1.2.5) programming support is provided, Motif Release 1.1.3, Release 1.2.2, Release 1.2.3, and XUI programming support are not. Three categories of libraries are provided: o Standard X Window System libraries, such as Xlib and the Intrin- sics (X Toolkit) o CDE Motif 1.0 Toolkit support for developing applications using the Motif user interface style o Compaq value-added libraries that give users additional capabil- ities: - DIGITAL Extensions to Motif (DXm) - CDA support - Display PostScript[R] support (XDPS). Please refer to Enhanced X Windows Display PostScript (XDPS) section of this SPD for de- tails. - Porting tools for changing applications from the XUI interface to the Motif user interface Components from each of these areas can be used in any combination to address the needs of applications. These components can also use the tools from a variety of programming languages. Motif language bindings are provided for the following programming lan- guages: o Digital Fortran for OpenVMS VAX and OpenVMS Alpha o DEC Pascal for OpenVMS VAX and OpenVMS Alpha 11 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 o DEC C for OpenVMS VAX and OpenVMS Alpha In addition, C header files supplied by the Open Group have been mod- ified to work with DEC C++. Pascal and Fortran bindings are included in the DECwindows Motif kit; Motif "strongly typed" language bindings for Ada are available in the DEC Ada[TM] for OpenVMS (VAX and Alpha) layered product. For additional programming support, the DECW$EXAMPLES directory includes the following updated programming ex- amples: o Motif widget set examples o X11 R4 and X11 R5 programming examples (Xlib examples) o Compaq supplied examples Programming Support Libraries The following sections describe the programming support libraries. X Window System (X) Programming Support The X Window System compatible X programming library (Xlib) provided by Compaq DECwindows Motif for OpenVMS supplies basic resource man- agement (windows, color maps, input devices) and bitmap graphics ser- vices. It defines a mapping of the X network protocol to a procedure library. X Window System Intrinsics Support The X Window System Intrinsics library support contains the X Consor- tium Release 5 (R5) Intrinsics (X Toolkit). The X Toolkit provides low- level routines that allow the creation of user interface objects called widgets. Motif User Interface Programming Support 12 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Motif is the user interface for Compaq and third-party software tai- lored for the DECwindows environment. It establishes the conventions and styles for graphical applications. Applications use Motif compo- nents to build user interfaces that look and feel alike. The OSF/Motif Style Guide describes the principles, philosophy, and components used to build consistent and well-integrated Motif appli- cations. In addition, the DECwindows Companion to the OSF/Motif Style Guide provides additional information concerning the style of Motif user interfaces. This manual also provides guidelines concerning ad- ditional features that Compaq provides in the Compaq DECwindows Mo- tif for OpenVMS offering, and includes a Compaq preferred terminol- ogy list for a number of supported languages for developers produc- ing Motif applications in these languages. The Motif style concepts are implemented by the Motif Toolkit. DECwin- dows Motif contains both the Motif and XUI Toolkits; application run- time support is provided for CDE Motif 1.0 (Motif Release 1.2.5) and Motif Release 1.2.3, Release 1.2.2, and Release 1.1.3 Toolkits, as well as for the XUI Toolkit. The Motif toolkit is based on the X Toolkit Intrinsics and contains three components: o Motif widgets and gadgets for implementing common user interface objects, such as scroll bars, menus, and push buttons o Utility routines that provide applications with functions for per- forming common tasks, such as cutting and pasting o Resource manager routines for loading user interface definition files and creating widgets and gadgets based on the contents of the def- inition files The Motif Toolkit is used in conjunction with the Motif User Inter- face Language (UIL) compiler. The user interface definition files pro- duced by this compiler contain the data that describes the form of DECwin- dows applications. These UIL files also allow Motif Toolkit widget and gadget information, such as menu item labels, to be stored separately from the toolkit and application run-time code. This capability al- lows application developers to prototype and easily modify user in- terface designs, to separate form from function in applications, and 13 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 to support translatable products that do not require recompilation of source files. DIGITAL Extensions to Motif The DECwindows Motif product adds value to the standard Motif Toolkit by including a library that contains a set of Compaq developed wid- gets and run-time routines not available from The Open Group. The fol- lowing widgets provide a common DECwindows interface for some commonly used DECwindows functions: o A Color Mix widget that enables users to select and mix colors us- ing a variety of color models. o A Compound String Text widget that provides support for interna- tional character sets as well as left-to-right character sets. o A Help widget that allows applications to display appropriate Help text in a consistent manner. This widget is provided for backward compatibility with DECwindows Motif for OpenVMS Version 1.0 and has been superseded by the Compaq DECwindows Motif for OpenVMS help sys- tem (hyperhelp). o A Print widget that allows applications to print files in a con- sistent manner. o A Structured Visual Navigation (SVN) widget used by applications to display hierarchical information. The run-time routines include: o Three Compaq DECwindows Motif for OpenVMS help system calls that enable users to display online help files using Bookreader. o DECimage[TM] run-time support for applications developed using DEC- image Application Services. This support includes the Image Ser- vices Library, Image Display Services, and X Image Extensions. Translated Image Environment for Compaq DECwindows Motif for OpenVMS Alpha 14 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Compaq DECwindows Motif for OpenVMS Alpha provides an array of ser- vices to allow the operation of programs that have undergone binary translation from DECwindows Motif Version 1.1 or XUI VAX images. These programs can perform virtually all user-mode functions on Compaq DECwin- dows Motif for OpenVMS Alpha systems. However, Compaq DECwindows Mo- tif for OpenVMS Alpha shareable images that are used with translated images are different from and incompatible with the shareable images used for native images. Native and translated images that use Compaq DECwindows Motif for OpenVMS Alpha software cannot be used together in a process. Without requiring special source code, the Translated Image Environ- ment (TIE) automatically resolves differences between the VAX and Al- pha architectures, including floating-point registers, condition codes, exception handling, asynchronous system traps, and so on. The Translated Image Environment included with Compaq DECwindows Mo- tif for OpenVMS Alpha is sufficient to run images that have been trans- lated elsewhere. The DECmigrate[TM] layered product can be used to trans- late images linked with the Motif Release 1.1.3 Toolkit (shipped with DECwindows Motif Version 1.1 for OpenVMS VAX) for running on an Open- VMS Alpha system. For additional information about the precise char- acteristics of programs suitable for binary translation, refer to the DECmigrate Software Product Description (SPD 39.44.xx for VAX; SPD 39.45.xx for Alpha). XUI to Motif Porting Tools Digital provides tools to aid programmers in porting applications to Motif. These tools replace occurrences of XUI names in the input source file with the correct Motif names. CDA Programming Support The CDA Toolkit provides access routines that applications can use to create, read, and write files containing compound text, graphics, and imaging data. These files provide a vehicle for recording this infor- mation on disk, a medium for interchange of this data between appli- cations, and an intermediate form from which high-resolution print- able graphics data can be generated. 15 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Enhanced X Windows Display PostScript (XDPS) The Display PostScript system provided with Compaq DECwindows Motif for OpenVMS extends the native X graphical programming environment for DECwindows users displaying text or images on workstations that sup- port the XDPS extension. X Windows Display PostScript adds the following capabilities to the basic X11 environment: o Most DECwindows fonts can be displayed at any size and rotation an- gle. o XDPS graphics are specified in a user-defined coordinate system in- dependent of monitor density. o Color or gray-scale rendition is automatically modified to take ad- vantage of the monitor type through direct display, color dither- ing, or half toning. o DPS Display routines can be downloaded to the server and executed on command. o Sophisticated graphics primitives, such as precisely controlled Bezier curves, can be displayed. o Any display can be scaled and rotated arbitrarily. Programming access to XDPS is through the Adobe Client Library. In ad- dition, a converter called pswrap allows users to convert PostScript code into C programs that can be called from other languages. As of August 1, 1998, Compaq Computer Corporation no longer supports the Adobe Display PostScript software. However, for customer conve- nience, Compaq is continuing to ship Display PostScript software "as is" in the Compaq DECwindows Motif for OpenVMS kit. Compaq disclaims all warranties with regard to this software, including all implied war- ranties of merchantability and fitness. DECwindows X11 Display Server for OpenVMS Extension Support 16 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 The X11 server protocol is implemented on both the OpenVMS VAX and the OpenVMS Alpha operating systems. As of OpenVMS VAX Version 6.0, the DECwindows X11 display server on OpenVMS VAX supports the full X11 pro- tocol and contains significant portions of the Release 4 (R4) and Re- lease 5 (R5) code base, plus some optional extensions. By contrast, the DECwindows X11 display server for OpenVMS Alpha is a direct port of the X Window System Version 11, Release 6 (X11 R6) display server, plus some optional extensions. The DECwindows X11 display server is an optional part of the OpenVMS VAX and OpenVMS Alpha kits. The DECwindows X11 display server, includ- ing device drivers and fonts, can be selected for installation dur- ing the OpenVMS VAX and OpenVMS Alpha installation procedures. The DECwindows X11 display server for OpenVMS supports the following extensions. Client libraries for these extensions are included in the Compaq DECwindows Motif for OpenVMS VAX and Compaq DECwindows Motif for OpenVMS Alpha layered products. o AccessX (Alpha only): "AccessX" as defined by Compaq. Provides key- board enhancements to the X server for people with movement impair- ments. o Display PostScript: "Adobe-DPS-Extension" as defined jointly by Adobe Systems Incorporated and Compaq Computer Corporation and registered with the X Consortium. Allows the display server to execute PostScript commands to support the XDPS programming environment. For details, see the Enhanced X Windows Display PostScript (XDPS) section of this SPD. o MITmisc: "MIT-SUNDRY-NONSTANDARD" as defined by the X Consortium. Allows users to determine and to set the server bug compatibility mode. o MIT-SHM (Alpha only): "MIT-SHM" as defined by the X Consortium. Pro- vides the ability to share memory XImages between the client and server. o Multibuffering: "Multi-Buffering" as defined by the X Consortium. Allows the display server to provide support for multiple-buffered images. 17 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 o Shape (Alpha only): "SHAPE" as defined by the X Consortium. Allows programs to create windows with shapes other than the standard rect- angle. o X Imaging Extension: "XIE" as defined by Compaq and registered with the X Consortium. Allows the display server to provide hardware or software support for imaging operations for ISL, the Image Services Library. o XTRAP: "DEC-XTRAP" as defined by Compaq and registered with the X Consortium. Allows the display server to provide support for hands- off testing programs like DTM, the DEC/Test Manager. HARDWARE REQUIREMENTS DECwindows Motif runs on any of the supported processors but requires either a workstation, an MS-DOS[R] based PC, a Macintosh[R], or an X terminal for display. These display devices must be running an X Win- dow System, Version 11, Release 4 (R4), Release 5 (R5) or Release 6 (R6) compliant display server. Supported VAX and Alpha Processors DECwindows Motif supports all the VAX and Alpha processors listed in the OpenVMS VAX and OpenVMS Alpha operating system Software Product Descriptions (SPD 41.87.xx for Alpha; SPD 25.01.37 for VAX), with the exception of those listed in the Unsupported Processors section. Unsupported Processors For performance reasons, Compaq DECwindows Motif Version 1.2-5 for Open- VMS VAX is not supported on the following processors: MicroVAX II MicroVAX 2000 VAXstation II VAXstation 2000 VAXstation 8000 VAX-11/725 VAX-11/730 18 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 VAX-11/750 VAX-11/780 VAX-11/782 VAX-11/785 Disk Space Requirements (Block Cluster Size = 1) For Alpha Systems Disk space required 179,500 blocks for DECwindows Motif installation Disk space required 177,500 blocks for DECwindows Motif use (permanent) To support full OpenVMS Alpha and full Compaq DECwindows Motif for Open- VMS Alpha, a system disk with at least 480 MB is recommended. However, a subset of the DECwindows Motif environment can be installed. Instal- lation of Compaq DECwindows Motif Version 1.2-5 for OpenVMS Alpha gives the user the option to install any or all of the following components: o Run-time support (base kit) - 50,000 blocks. This section provides support for running DECwindows Motif for OpenVMS Alpha applications on Alpha compute servers and is a required part of the installa- tion. o New Desktop - 42,000 blocks. This is an optional component that al- lows use of the New Desktop environment. It includes applications and application programming interfaces (APIs). o DECwindows desktop - 8,000 blocks. This component is also optional, but either the New Desktop or the DECwindows desktop should be in- stalled to create a usable system. The DECwindows desktop is the user interface that was included in previous versions of DECwin- dows Motif and includes the DECwindows Session Manager, FileView, and the Motif Window Manager. 19 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 o Programming support - 13,000 blocks. This number includes support for the C, Pascal, and Fortran programming languages and for the New Desktop. If only a subset of languages is installed, the amount of disk space required will be less. o Programming examples - 13,000 blocks. This number includes exam- ple audio files, the DECwindows desktop, and the New Desktop. If only a subset of example files is installed, the amount of disk space required will be less. o Translated-image support - 33,500 blocks. For VAX Systems Disk space required 74,500 blocks for DECwindows Motif installation Disk space required 73,500 blocks for DECwindows Motif use (permanent) To support full OpenVMS VAX and full Compaq DECwindows Motif for Open- VMS VAX, a system disk with at least 280 MB is recommended. However, a subset of the DECwindows Motif environment can be installed. Instal- lation of Compaq DECwindows Motif Version 1.2-5 for OpenVMS VAX gives the user the option of installing any or all of the following compo- nents: o DECwindows Motif run-time support files (base kit) - 48,500 blocks. This section provides support for running DECwindows Motif for Open- VMS VAX applications on VAX compute servers, and is a required part of the installation. It includes the DECwindows desktop applica- tions and libraries. o Programming support - 12,000 blocks. This number includes support for the C, Pascal, and Fortran programming languages. If only a sub- set of languages is installed, the amount of disk space required will be less. 20 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 o Programming examples - 11,000 blocks. This number includes exam- ple audio files and the DECwindows desktop. If only a subset of ex- ample files is installed, the amount of disk space required will be less. These block sizes refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on your sys- tem environment, configuration, and software options (for example, DECwin- dows Motif programming examples). Memory Requirements For Alpha Systems The minimum required to install, boot, and log in is 64 MB; 128 MB is highly recommended for more robust performance. Remote execution of applications requires an additional system that runs the application while the application is displayed on the local workstation. The performance and memory usage of OpenVMS Alpha systems running Com- paq DECwindows Motif for OpenVMS Alpha depend on system configuration and window and applications usage. Please note that memory requirements may change in future releases of Compaq DECwindows Motif for OpenVMS Alpha. For VAX Systems The minimum memory required to install, boot, and log in is 16 MB; 32 MB is highly recommended for more robust performance. Remote execu- tion of applications requires an additional system that runs the ap- plication while the application is displayed on the local workstation. The performance and memory usage of OpenVMS VAX systems running Com- paq DECwindows Motif for OpenVMS VAX depend on system configuration and window and applications usage. Please note that memory requirements may change in future releases of Compaq DECwindows Motif for OpenVMS VAX. 21 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Support for Multiple-Screen Configuration On Alpha systems, a multiple-screen configuration consists of a sin- gle workstation that supports multiple graphics options. A graphics option consists of a graphics controller and a monitor. Workstations with multiple-screens are unsupported except as specified in the Sys- tems and Options Catalog. Please note that in a multiple-screen con- figuration, all the graphics cards must be of the same model. For additional information about supported multiple-screen configu- rations, see the Systems and Options Catalog and the Getting Started With the New Desktop manual. Miscellaneous Supported Peripherals VSXXX-AB Tablet (replaces mouse) VSXXX-JA Audio headset VSXXX-AA Mouse VSXXX-FA Mouse CLUSTER ENVIRONMENT This product is fully supported without restrictions when installed on any valid and licensed VAXcluster* configuration. Note: VAXcluster configurations are fully described in the OpenVMS Clus- ter Software Software Product Description (SPD 29.78.xx) and include CI, Ethernet, and mixed-interconnect configurations. SOFTWARE REQUIREMENTS Compaq DECwindows Motif Version 1.2-5 for OpenVMS is supported on the following operating systems: o VMS Version 5.5-2; OpenVMS VAX Version 6.2, Version 7.1, or Ver- sion 7.2 o OpenVMS Alpha Version 6.2, Version 7.1, or Version 7.2 22 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 OPTIONAL SOFTWARE o Compaq PATHWORKS for DOS and Windows o Compaq PATHWORKS for DOS (TCP/IP) o Compaq TCP/IP Services for OpenVMS VAX o Compaq TCP/IP Services for OpenVMS Alpha o Builder eXcessory (BX) for OpenVMS VAX GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. DISTRIBUTION MEDIA The Compaq DECwindows Motif Version 1.2-5 for OpenVMS software is avail- able on the following media: o CD-ROM (VAX and Alpha) o TK50 streaming tape (VAX) o 9-track 1600-bpi magnetic tape (VAX) ORDERING INFORMATION For Alpha Systems The Compaq DECwindows Motif for OpenVMS Alpha product is available as a standalone layered product on CD-ROM. In addition, users of multi- ple OpenVMS Alpha layered products can obtain DECwindows Motif bina- ries and online documentation in Bookreader format as part of the Open- VMS Alpha Software Product Library offering. Software Licenses: 23 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Personal Use: QL-XA1A*-2B Unlimited Use: QL-MV4A*-AA Software Media: Compaq DECwindows Motif for OpenVMS Alpha media and Bookreader (user and programming) documentation: QA-MV4AB-H8 OpenVMS Alpha Software Layered Product Library (binaries and Bookreader documentation): QA-03XAA-H8 Documentation: Hardcopy Motif User Documentation (VAX and Alpha): QA-XA1AA-GZ Hardcopy Motif Programming Documentation (VAX and Alpha): QA-XA1AB- GZ Software Product Services: DECwindows Motif Personal Use (VAX and Alpha): QT-XA1**-** DECwindows Motif Unlimited Use (Alpha only): QT-MV4**-** For VAX Systems The Compaq DECwindows Motif for OpenVMS VAX product is available as a standalone layered product on CD-ROM. In addition, users of multi- ple OpenVMS VAX layered products can obtain DECwindows Motif binaries and online documentation in Bookreader format as part of the OpenVMS VAX Software Product Library (formerly ConDIST) on CD-ROM. The com- panion Online Documentation Library (formerly ConOLD) CD-ROM contains most of the DECwindows Motif documentation, which can be read using Bookreader. Software Licenses: QL-XA1A*-** Software Media: Motif binaries and Bookreader (user and programming) documentation (CD-ROM): QA-XA1AB-H8 24 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Motif binaries and hardcopy user documentation: QA-XA1AA-H* (TK50 or magtape) OpenVMS VAX Software Product Library (Layered Product binaries only): QA-VWJ8A-A8 Documentation: Hardcopy Motif User Documentation (VAX and Alpha): QA-XA1AA-GZ Hardcopy Motif Programming Documentation (VAX and Alpha): QA-XA1AB- GZ OpenVMS VAX ConOLD (Layered Product Bookreader documentation only): QA-VYR8A-G8 Software Product Services: QT-XA1A*-** Documentation for DECwindows Motif for OpenVMS (VAX and Alpha) The DECwindows Motif user and programming documentation sets apply to DECwindows Motif on both the VAX and Alpha operating systems. If you are ordering DECwindows Motif for OpenVMS on a CD, you will receive both the user documentation and most of the programming documentation in Bookreader format. This documentation set includes: o DECwindows Motif Version 1.2-4 for OpenVMS Documentation o DECwindows Motif Version 1.2-5 for OpenVMS Release Notes o DECwindows Motif Version 1.2-5 for OpenVMS Installation Guide o Guide to the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM o Getting Started with the New Desktop o Using DECwindows Motif for OpenVMS o Managing DECwindows for OpenVMS Systems o DECwindows Motif for OpenVMS Applications Guide o Overview of DECwindows Motif for OpenVMS 25 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 o DECwindows Extensions to Motif o DECwindows Motif for OpenVMS Guide to Non-C Bindings o VMS DECwindows Device Driver Manual o VMS DECwindows Transport Manual o DECwindows Companion to the OSF/Motif Style Guide o Porting XUI Applications to Motif o DECwindows Motif Guide to Application Programming o VMS DECwindows Guide to Xlib (Release 4) Programming: MIT C Bind- ing o VMS DECwindows Guide to Xlib (Release 4) Programming: VAX Binding o OSF/Motif Programmer's Guide o OSF/Motif Style Guide CDE Documentation The Common Desktop Environment (CDE) manuals are provided in support of the New Desktop. These manuals are included in the DECwindows Mo- tif H-kit CD-ROM in HTML format and can be read using a browser like Netscape Navigator, whose use is permitted by the DECwindows Motif Ver- sion 1.2-3, Version 1.2-4 and Version 1.2-5 license. For more infor- mation about the location of the manuals on the CD-ROM, see the Guide to the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM. Some of the CDE manuals are also separately orderable from Compaq in hardcopy format. Please note that the order numbers in this list ap- ply to the hardcopy manuals only. o Common Desktop Environment: User's Guide: AA-QTLNA-TE o Common Desktop Environment: Advanced User's and System Administra- tor's Guide: AA-QTLQA-TE 26 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 Please note that not all the information in the CDE documentation and reference pages applies to the New Desktop. For an accurate descrip- tion of the New Desktop, see the Getting Started With the New Desk- top manual This documentation is currently accessible on the World Wide Web at the the following address: http://www.openvms.digital.com/openvms/doc-sets /index.html DECwindows Motif Language Variants Each language variant kit runs on both VAX or Alpha systems. Personal Use Software Licenses: QL-XDD**-2B Unlimited Use Software Licenses (DECwindows Motif OpenVMS Alpha): QL- 08U**-** Unlimited Use Software Licenses (DECwindows Motif OpenVMS VAX): QL- XDD**-** Software Media and Documentation: QA-XDD*A-H8 Software Documentation: QA-XDD*A-GZ SUSL Subscription Service (Alpha): QT-08U**-** SUSL Subscription Service (VAX): QT-XDD**-** Media and Documentation Update Service (MDDS): QT-XDD**-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. 27 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 SOFTWARE LICENSING This software is furnished only under a license. For more information about Compaq's licensing terms and policies, contact your local Com- paq office. Compaq provides a Compaq DECwindows Motif for OpenVMS license Prod- uct Authorization Key (PAK) with the purchase of a VAX or Alpha work- station. Media and online documentation kits are not provided with Factory In- stalled Software (FIS) systems. Licensing of Language Variants The language variants of DECwindows are available as options to the DECwindows Motif product. Language variants are supported only when the version number of the language variant matches the version num- ber of Compaq DECwindows Motif for OpenVMS. Some restrictions apply on language combinations. Refer to the rel- evant language variant SPD for details on supported language combi- nations in each country. Compaq DECwindows Motif for OpenVMS language variants are generally supported only in countries where the language is an official language. However, for some countries this may vary. Consult the relevant lan- guage variant SPD or your local sales office to check for the avail- ability of additional language support in your country or location. License Management Facility Support Compaq DECwindows Motif for OpenVMS supports the OpenVMS License Man- agement Facility. License units for Compaq DECwindows Motif for Open- VMS are allocated on an Unlimited System Use and Personal Use basis. Each Personal Use license allows one identified individual to use the layered product. 28 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 For more information about the License Management Facility, refer to the OpenVMS VAX or OpenVMS Alpha operating system Software Product De- scriptions (SPD 41.87.xx for Alpha; SPD 25.01.37 for VAX) or the OpenVMS VAX and OpenVMS Alpha operating system documentation. YEAR 2000 READINESS This product is capable of accurately processing, providing, and/or receiving date data from, into, and between the twentieth and the twenty- first centuries, and the years 1999 and 2000, including leap year cal- culations, when used in accordance with the associated product doc- umentation and provided that all hardware, firmware, and software used in combination with the product properly exchange accurate date data with the product. SOFTWARE WARRANTY Warranty for this software product is provided by Compaq with the pur- chase of a license for the product. SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more in- formation, contact your local Compaq office. THIRD-PARTY LICENSING The Open Group, Inc., License Terms and Agreement Compaq Computer Corporation certifies that Compaq DECwindows Motif Ver- sion 1.2-5 for OpenVMS VAX and Compaq DECwindows Motif Version 1.2- 5 for OpenVMS Alpha is CDE Motif 1.0 (Motif Release 1.2.5) validated as tested with the Motif Validation Test Suite Release 1.1 with no waivers. 29 Compaq DECwindows Motif[R] Version 1.2-5 for OpenVMS SPD 42.19.06 [R] Compaq, the Compaq logo, DIGITAL, and the DIGITAL logo are registered in the U.S. Patent and Trademark Office. [TM] ALL-IN-1, Alpha, Bookreader, CDA, CI, DEC, DEC Ada, Digi- tal Fortran, DECimage, DECmigrate, DECnet, DECterm, LAT, MicroVAX, MicroVAX II, OpenVMS, PATHWORKS, POLYCENTER, ReGIS, TURBOchannel, VAX, VAX-11/750, VAX-11/780, VAXsta- tion, VMS, VMScluster, VT, VT52, VT100, VT220, VT320, and XUI are trademarks of Compaq Computer Corporation. [R] MS-DOS, Microsoft, Windows, Windows 95, and Windows NT are registered trademarks, and NT is a trademark, of Microsoft Corporation. [R] Adobe, PostScript, and Display PostScript are registered trademarks of Adobe Systems Incorporated. Macintosh is a registered trademark of Apple Computer, Inc. Motif, OSF, and OSF/Motif are registered trademarks of The Open Group, Inc. MultiNet is a registered trademark of TGV, Inc. [TM] X Window System is a trademark of the Massachusetts Insti- tute of Technology. The Open Group is a trademark of The Open Group, Inc. Spyglass and Enhanced Mosaic are trademarks of Spyglass, Inc. ©1999 Digital Equipment Corporation. All Rights Reserved. 30