Compaq Software Product Description ___________________________________________________________________ PRODUCT NAME: DECwindows Motif[R]/German Version 1.2-5 for OpenVMS SPD 27.F5.05 This Software Product Description describes the following two prod- ucts: o DECwindows Motif[R]/German Version 1.2-5 for OpenVMS VAX o DECwindows Motif[R]/German Version 1.2-5 for OpenVMS Alpha 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 OpenVMS VAX and OpenVMS Alpha operating systems. This in- terface allows users to interact with OpenVMS VAX and OpenVMS Alpha using a point-and-click technique. DECwindows includes a set of in- tegrated desktop applications that demonstrate the ease of use of this user interface and provides OpenVMS users with a base set of desktop tools. DECwindows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX pro- vides some new features, including Year 2000 enhancements and the abil- ity to coexist in the same environment with Extended File Specifica- tions (EFS). In addition, DECwindows Motif Version 1.2-5 for OpenVMS Alpha deliv- ers the New Desktop environment for OpenVMS Alpha systems, which is derived from the CDE (Common Desktop Environment) technology. CDE pro- vides and defines a consistent user interface for end users and a con- sistent development environment for application developers across mul- tiple platforms. October 1999 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 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 DECwindows Motif Version 1.2-5 for OpenVMS product provides four transport interfaces: local shared memory, DECnet, TCP/IP (using DIGITAL TCP/IP Services for Open- VMS product or third-party products such as MultiNet[R] and Wollon- gong), and LAT. Users can also provide their own transport subsystems and transport interfaces. To determine whether a separately orderable DECwindows Motif based lay- ered product or X application runs on or can communicate with DECwin- dows Motif for OpenVMS VAX or OpenVMS Alpha systems, consult the ap- plication's Software Product Description. Basic Components The DECwindows Motif for OpenVMS user environment consists of four ba- sic 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 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 DECwindows Motif for OpenVMS Alpha and VAX Version 1.2-5 contains the Year 2000 enhancements that originally shipped in ALPMOTF03_U4012 and VAXMOTF02_U4012 kits. These enhancements are the result of a rigor- ous and comprehensive analysis and testing of the entire OpenVMS op- erating system. For a full description of Year 2000 enhancements, see the DECwindows Motif for OpenVMS Alpha and VAX Version 1.2-5 Release Notes, avail- able in online format on the product media. 4 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 DIGITAL[TM] Advanced Server, EFS allows OpenVMS sys- tems to act as fully functional file servers to Windows 95 and Win- dows NT clients. In addition, EFS allows OpenVMS system managers to perform OpenVMS system management functions on Windows NT and Windows 95 files from an OpenVMS account. This functionality is intended for use primarily with DIGITAL Advanced Server, but it is possible to cre- ate and manipulate EFS extended file names using a subset of DCL com- mands. 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 DECwindows Motif Version 1.2-5 for OpenVMS Alpha is the New Desktop environment, which is derived from CDE (Common Desktop En- vironment) 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 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 - 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 DECwindows Motif for OpenVMS provides a set of integrated desktop ap- plications that employ a common look and feel to help users easily mas- ter their computing environment. 7 The following desktop applications are available with DECwindows Mo- tif 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 OpenVMS and 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 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 DECwindows Motif for OpenVMS prod- uct supplies several audio images (such as animal sounds, laughter, and various alarm tones) that can be played back using DECsound on VAXs- tation 4000 series and DEC 3000 series workstations. The CDA Viewer can be used to view documents that contain audio images. In addition, DECwindows Mail can be configured to include the audio editor for send- ing and receiving voice mail messages. On OpenVMS VAX systems, ALL-IN-1[TM] MAIL can be configured to include the audio editor for sending and re- ceiving 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 URL listed above. Please note that, starting with DECwindows Motif Version 1.2-5 for Open- VMS, Compaq Computer Corporation will no longer distribute or support the Spyglass[TM] Enhanced Mosaic[TM] web browser, which was provided in previous versions of the DECwindows Motif for OpenVMS product. Com- paq recommends that DECwindows Motif customers who use Spyglass En- hanced Mosaic replace it with Netscape Navigator. 9 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 DECwindows Motif for OpenVMS lay- ered product. The sources and images for a subset of these MIT util- ities are included. The XPR (X Print) utility, which allows users to capture and print the contents of windows, is provided with DECwin- dows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX. A complete list of available MIT programs is included in the DECwindows Motif Ver- sion 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. Please note that until language variants for DECwin- dows Motif Version 1.2-5 become available, you should continue to use DECwindows Motif Version 1.2-3 and Version 1.2-4 if you require lo- cal language support. Programming Support 10 The DECwindows Motif for OpenVMS environment includes an extensive set of programming libraries and tools for use by application developers. The libraries are provided in the form of shareable images. While CDE Motif 1.0 (Motif Release 1.2.5) programming support is provided, Mo- tif 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 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 DECwindows Motif for OpenVMS supplies basic resource management (win- dows, color maps, input devices) and bitmap graphics services. It de- fines 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 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. 12 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 Digital provides in the DECwindows Motif for OpenVMS offering, and includes a Compaq preferred terminology list for a number of supported languages for developers producing Motif appli- cations 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 to support translatable products that do not require recompilation of source files. DIGITAL Extensions to Motif 13 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 DECwindows Motif for OpenVMS help system (hy- perhelp). 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 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 DECwindows Motif for OpenVMS Alpha DECwindows Motif for OpenVMS Alpha provides an array of services to allow the operation of programs that have undergone binary transla- tion from DECwindows Motif Version 1.1 or XUI VAX images. These pro- grams can perform virtually all user-mode functions on DECwindows Mo- tif for OpenVMS Alpha systems. However, DECwindows Motif for OpenVMS 14 Alpha shareable images that are used with translated images are dif- ferent from and incompatible with the shareable images used for na- tive images. Native and translated images that use 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 DECwindows Motif for OpenVMS Alpha is sufficient to run images that have been translated 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. Enhanced X Windows Display PostScript (XDPS) 15 The Display PostScript system provided with DECwindows Motif for Open- VMS extends the native X graphical programming environment for DECwin- dows users displaying text or images on workstations that support 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 DECwindows Motif for OpenVMS kit. Compaq disclaims all war- ranties with regard to this software, including all implied warranties of merchantability and fitness. DECwindows X11 Display Server for OpenVMS Extension Support 16 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 DECwindows Motif for OpenVMS VAX and DECwindows Motif for OpenVMS Al- pha 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 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, DECwindows Motif Version 1.2-5 for OpenVMS 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 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 for base kit installation 179,500 blocks Disk space required for German kit installation 37,000 blocks Disk space required for base kit permanent use 179,500 blocks Disk space required for German kit permanent use 37,000 blocks To support full OpenVMS Alpha and full DECwindows Motif for OpenVMS 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 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 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 for base kit installation 74,500 blocks Disk space required for German kit installation 18,000 blocks Disk space required for base kit permanent use 73,500 blocks Disk space required for German kit permanent use 16,000 blocks To support full OpenVMS VAX and full DECwindows Motif for OpenVMS VAX, a system disk with at least 280 MB is recommended. However, a subset of the DECwindows Motif environment can be installed. Installation of DECwindows Motif Version 1.2-5 for OpenVMS VAX gives the user the op- tion of installing any or all of the following components: 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 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 DECwin- dows Motif for OpenVMS Alpha depend on system configuration and Win- dow and applications usage. Please note that memory requirements may change in future releases of 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 DECwin- dows Motif for OpenVMS VAX depend on system configuration and window and applications usage. Please note that memory requirements may change in future releases of DECwindows Motif for OpenVMS VAX. 21 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 DECwindows Motif Version 1.2-5 for OpenVMS is supported on the fol- lowing 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 OPTIONAL SOFTWARE o PATHWORKS for DOS and Windows o PATHWORKS for DOS (TCP/IP) o DIGITAL TCP/IP Services for OpenVMS VAX o DIGITAL 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 DECwindows Motif Version 1.2-5 for OpenVMS software is available 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 DECwindows Motif for OpenVMS Alpha product is available as a stan- dalone layered product on CD-ROM. In addition, users of multiple Open- VMS Alpha layered products can obtain DECwindows Motif binaries and online documentation in Bookreader format as part of the OpenVMS Al- pha Software Product Library offering. Software Licenses: 23 Personal Use: QL-XA1A*-2B Unlimited Use: QL-MV4A*-AA Software Media: DECwindows Motif for OpenVMS Alpha media and Bookreader (user and pro- gramming) 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 DECwindows Motif for OpenVMS VAX product is available as a stan- dalone layered product on CD-ROM. In addition, users of multiple Open- VMS VAX layered products can obtain DECwindows Motif binaries and on- line documentation in Bookreader format as part of the OpenVMS VAX Soft- ware Product Library (formerly ConDIST) on CD-ROM. The companion On- line 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 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) - in English Language 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 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 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, including German runs on both VAX or Alpha systems. Personal Use Software Licenses: QL-XDDPA-2B Unlimited Use Software Licenses (DECwindows Motif OpenVMS Alpha): QL- 08UP*-** Unlimited Use Software Licenses (DECwindows Motif OpenVMS VAX): QL- XDDPA-AA Software Media and Documentation: QA-XDDGA-W8 Software Documentation: QA-XDDGA-GZ SUSL Subscription Service (Alpha): QT-08U**-** SUSL Subscription Service (VAX): QT-XDD**-** Media and Documentation Update Service (MDDS): QT-XDDGA-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. 27 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 DECwindows Motif for OpenVMS license Product Autho- rization Key (PAK) with the purchase of a VAX or Alpha workstation. 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 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. 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 language vari- ant SPD or your local sales office to check for the availability of additional language support in your country or location. License Management Facility Support DECwindows Motif for OpenVMS supports the OpenVMS License Management Facility. License units for DECwindows Motif for OpenVMS are allocated on an Unlimited System Use and Personal Use basis. Each Personal Use license allows one identified individual to use the layered product. 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 Open- VMS VAX and OpenVMS Alpha operating system documentation. 28 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 DECwindows Motif Version 1.2-5 for OpenVMS VAX and 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. [TM] ALL-IN-1, Alpha, Bookreader, CDA, CI, Compaq, DEC, DEC Ada, Digital Fortran, DECimage, DECmigrate, DECnet, DECterm, DECwindows, LAT, MicroVAX, MicroVAX II, OpenVMS, PATHWORKS, POLYCENTER, ReGIS, TURBOchannel, VAX, VAX-11/750, VAX-11 /780, VAXstation, VMS, VMScluster, VT, VT52, VT100, VT220, VT320, XUI, and the Compaq logo are trademarks of Compaq Computer Corporation. 29 [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. MS-DOS, Microsoft, Windows, Windows 95, and Windows NT are registered trademarks of Microsoft Corporation. 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. NT is a trademark of Microsoft Corporation. Spyglass and Enhanced Mosaic are trademarks of Spyglass, Inc. ©1999 Compaq Computer Corporation. All Rights Reserved. 30