                           C                      ______________________________________________ @                      Guide to the DECwindows Motif Version 1.2-5!                      for Open VMS                       CD-ROM   .                      Order Number: AA-Q4BXD-RE    "                      December 1998  D                      This guide lists the contents of the DECwindows<                      Motif Version 1.2-5 for OpenVMS CD-ROM.          C                      Revision/Update Information: This is a revised 9                                                   manual.   B                      Software Version:            DECwindows MotifC                                                   Version 1.2-5 for ?                                                   OpenVMS Alpha B                                                   DECwindows MotifC                                                   Version 1.2-5 for =                                                   OpenVMS VAX   G                      Operating System Version:    OpenVMS Alpha Version 5                                                   6.2 C                                                   VMS Version 5.5-2         0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________             December 1998  ?            Compaq Computer Corporation makes no representations ?            that the use of its products in the manner described ?            in this publication will not infringe on existing or E            future patent rights, nor do the descriptions contained in C            this publication imply the granting of licenses to make, D            use, or sell equipment or software in accordance with the            description.   C            Possession, use, or copying of the software described in B            this publication is authorized only pursuant to a validD            written license from Compaq or an authorized sublicensor.  B            Compaq conducts its business in a manner that conservesD            the environment and protects the safety and health of its3            employees, customers, and the community.   C            Copyright  1998 Compaq Computer Corporation. All rights             reserved.  G            The following are trademarks of Compaq Computer Corporation: F            Alpha, AXP, Bookreader, Compaq, DEC, DECdirect, DECwindows,;            DIGITAL, OpenVMS, POLYCENTER, VAX, VAX DOCUMENT, 0            VAXcluster, VMS, and the Compaq logo.  4            The following are third-party trademarks:  ;            Display POSTSCRIPT and POSTSCRIPT are registered 4            trademarks of Adobe Systems Incorporated.  ?            Mosaic is a trademark of the University of Illinois.   B            Motif and OSF/Motif are trademarks of the Open Software            Foundation, Inc.   D            Netscape Communications, Netscape, and Netscape NavigatorA            are trademarks of Netscape Communications Corporation.   A            All other trademarks and registered trademarks are the 0            property of their respective holders.  E                                                                ZK6474   E            This document was prepared using VAX DOCUMENT Version 2.1.                            H         ________________________________________________________________  H                                                                  Preface               Overview  E               This guide contains information on the DECwindows Motif @               Version 1.2-5 for OpenVMS CD-ROM and how to access;               DECwindows Motif documentation on the CD-ROM.            Related Documents   E               For additional information on the Open Systems Software F               Group (OSSG) products and services, access the following"               World Wide Web site:  ,               http://www.openvms.digital.com  G               Refer to the following documents for detailed information F               about installation procedures and further information onD               DECwindows Motif Version 1.2-5 for OpenVMS changes and               enhancements:   H               o  DECwindows Motif Version 1.2-5 for OpenVMS Installation                  Manual   C               o  DECwindows Motif Version 1.2-5 for OpenVMS Release                   Notes  H               o  DECwindows Motif Version 1.2-5 for OpenVMS Cover Letter           Reader's Comments   ;               Compaq welcomes your comments on this manual.   @               Print or edit the online form SYS$HELP:OPENVMSDOC_8               COMMENTS.TXT and send us your comments by:  4               Internet    openvmsdoc@zko.mts.dec.com  H                                                                      iii                   C            Fax         603 884-0120, Attention: OSSG Documentation, !                        ZK03-4/U08   2            Mail        Compaq Computer Corporation;                        OSSG Documentation Group, ZKO3-4/U08 )                        110 Spit Brook Rd. ,                        Nashua, NH 03062-2698  *      How To Order Additional Documentation  <            Use the following World Wide Web address to order$            additional documentation:  -            http://www.openvms.digital.com:81/   C            If you need help deciding which documentation best meets 7            your needs, call 800-DIGITAL (800-344-4825).                                                             iv                        H                                                                        1H         ________________________________________________________________  H                                              The DECwindows Motif CD-ROM               1.1 Overview  E               This guide provides the following information about the @               DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM:                  o  CD-ROM contents                  o  CD-ROM handling  #               o  CD-ROM directories   ,               o  Accessing the documentation  ?               o  Locating the product installation instructions   F         1.2 DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM Contents  C               The DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM %               contains the following:   7               o  DECwindows Motif for OpenVMS save sets   *               o  New Desktop documentation  /               o  DECwindows Motif documentation   F               o  PCSI ECO, to be used when installing DECwindows MotifG                  Version 1.2-5 for OpenVMS on Version 6.2xx and Version                   7.1 systems.            1.3 Handling the CD-ROM   C               The DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM B               accompanying this guide is enclosed in an antistaticE               envelope. For information about inserting the CD-ROM in G               the disc drive, see the Optical Disc Drive Owner's Manual "               for your disc drive.  H                                          The DECwindows Motif CD-ROM 1-1                  The DECwindows Motif CD-ROMM      1.4 Directories on the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM   >      1.4 Directories on the DECwindows Motif Version 1.2-5 for          OpenVMS CD-ROM   ?            The CD-ROM contains binary files for both DECwindows ?            Motif Version 1.2-5 for OpenVMS Alpha and DECwindows @            Motif Version 1.2-5 for OpenVMS VAX products. You canE            install the Alpha product by using the POLYCENTER Software C            Installation utility. You can install the VAX product by D            using the POLYCENTER Software Installation utility or theA            VMSINSTAL utility, depending on your OpenVMS operating             system version.  :            Table 1-1 lists the kit locations and contents.                                                                $      1-2 The DECwindows Motif CD-ROM           H                                              The DECwindows Motif CD-ROMH  Directories    on the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM  C               Table 1-1 Directory Structure on the DECwindows Motif H               __________Version_1.2-5_for_OpenVMS_CD-ROM________________  H               Directory_Name_____________Contents_______________________  D               [PCSI_UTILITY_ALPHA]       ECO and README file for theA                                          PCSI utility. If you are D                                          installing DECwindows MotifE                                          Version 1.2-5 for OpenVMS on G                                          OpenVMS Alpha Version 6.2xx or E                                          Version 7.1 systems, install 8                                          this ECO first.  D               [PCSI_UTILITY_VAX]         ECO and README file for theA                                          PCSI utility. If you are D                                          installing DECwindows MotifE                                          Version 1.2-5 for OpenVMS on E                                          OpenVMS VAX Version 6.2xx or E                                          Version 7.1 systems, install 8                                          this ECO first.  E               [PCSI_ALPHA_DWMOTIF125]    DECwindows Motif for OpenVMS H                                          Alpha. Install using POLYCENTERC                                          on systems running OpenVMS G                                          Alpha Version 6.2xx or higher.   E               [PCSI_VAX_DWMOTIF125]      DECwindows Motif for OpenVMS F                                          VAX. Install using POLYCENTERG                                          on systems running OpenVMS VAX 7                                          Version 6.2xx.   E               [VMSINSTAL_VAX_            DECwindows Motif for OpenVMS H               DWMOTIF125]                VAX. Install using VMSINSTAL onD                                          systems running VMS VersionB                                          5.5-2 through OpenVMS VAX7                                          Version 6.2xx.   G               [DOCUMENTATION]            Product documentation in HTML, C                                          Bookreader, Postscript and H               ___________________________ASCII_text.____________________  @               See the DECwindows Motif Version 1.2-5 for OpenVMSH               Installation Guide for specific installation instructions.    H                                          The DECwindows Motif CD-ROM 1-3                  The DECwindows Motif CD-ROM2      1.5 Accessing the Documentation on the CD-ROM  2      1.5 Accessing the Documentation on the CD-ROM  @            The DECwindows Motif Version 1.2-5 for OpenVMS CD-ROMC            contains DECwindows Motif documentation in the following E            formats: PostScript, ASCII text, Bookreader, and HTML. The @            documentation files are in the following directories:  '            o  [DOCUMENTATION] directory =               Contains PostScript and ASCII text files of the C               product's Software Product Description (SPD), release :               notes, installation guide, and cover letter.  1            o  [DOCUMENTATION.DECW$BOOK] directory ?               Contains Bookreader files of the DECwindows Motif .               Version 1.2-4 documentation set.  ,            o  [DOCUMENTATION.HTML] directory>               Contains HTML files of selected DECwindows Motif?               Version 1.2-5 manuals and the New Desktop (Common 5               Desktop Environment) documentation set.   '      1.5.1 Accessing HTML Documentation   >            If you are running OpenVMS Version 6.2xx or higher,A            you can view HTML manuals using the Netscape Navigator E            browser. Use the following procedure to start the browser:   D            1. Install the Netscape Navigator browser (see Installing.               the Netscape Navigator Browser).  !            2. Invoke the browser.   ?            3. From the File menu, choose the Open File... item.   >            4. In the Selection field, enter the following file               specification:  8               device-name:[DOCUMENTATION.HTML]INDEX.HTML                 where:  D               device-name is the name of the drive on which you haveD               placed your DECwindows Motif Version 1.2-5 for OpenVMS               CD-ROM.                  For example:  3               DKB700:[DOCUMENTATION.HTML]INDEX.HTML   $      1-4 The DECwindows Motif CD-ROM           H                                              The DECwindows Motif CD-ROMH                            1.5 Accessing the Documentation on the CD-ROM  F               5. The set of titles is displayed; click on the title of2                  the manual that you want to open.  7               Installing the Netscape Navigator Browser   C               If needed, you can install the Netscape Navigator for G               OpenVMS from the OpenVMS Version 7.2 Documentation CD-ROM E               in the OpenVMS operating system documentation. Read the F               NETSCAPE-README.[PS,TXT] file for instructions on how toF               install the Netscape Navigator on VAX and Alpha systems.H               If you have access to the World Wide Web, you can downloadF               the latest version of the Netscape Navigator for OpenVMSE               browser from the DIGITAL OpenVMS Internet Solutions web -               page at the following location:   A               http://www.openvms.digital.com/openvms/products/ips   E               Fill out the customer registration form and then follow <               the instructions for downloading the software.  F                 ________________________Note  ________________________  A                 On OpenVMS 7.2 systems, the Netscape Navigator is ?                 an option when installing the OpenVMS software. C                 The Netscape Navigator is not supported on VMS 5.5- A                 2 systems. On these systems, you can use the NCSA >                 Mosaic Browser though you will experience some?                 difficulties displaying the files with the NCSA D                 Mosaic Browser. HTML manuals must be viewed with theC                 Netscape Navigator browser. Mosaic does not display ,                 these HTML manuals properly.  E                 _____________________________________________________   *               Documentation in HTML Format  H               The following documentation is provided in HTML format and;               is located in [DOCUMENTATION.HTML] directory:   5               o  Getting Started With the New Desktop   9               o  Common Desktop Environment: User's Guide   G               o  Common Desktop Environment: Advanced User's and System &                  Administrator's Guide  E               o  Common Desktop Environment: Help System Author's and #                  Programmer's Guide   B               o  Common Desktop Environment: Programmer's Overview  H                                          The DECwindows Motif CD-ROM 1-5                  The DECwindows Motif CD-ROM2      1.5 Accessing the Documentation on the CD-ROM  <            o  Common Desktop Environment: Programmer's Guide  G            o  Common Desktop Environment: Style Guide and Certification                Checklist   >            o  Common Desktop Environment: Internationalization                Programmer's Guide  2            o  Common Desktop Environment: Glossary  @            o  DECwindows Motif Version 1.2-5 for OpenVMS Release               Notes   E            o  DECwindows Motif Version 1.2-5 for OpenVMS Installation                Guide   -      1.5.2 Accessing Bookreader Documentation   B            If you have a workstation and have installed DECwindowsA            Motif software, you can view the manuals in Bookreader -            format with DECwindows Bookreader.   ?            During installation or upgrade, the DECwindows Motif A            software automatically creates a library directory for A            Bookreader on your system disk and defines the logical D            name DECW$BOOK to refer to this directory. When you startE            Bookreader, it looks for the library file in the directory              defined by DECW$BOOK.  ?            To read the Bookreader files on the DECwindows Motif >            Version 1.2-5 for OpenVMS CD-ROM, use the following            procedure:V  .            1. Enter the following DCL command:  F               $ DEFINE DECW$BOOK device-name:[DOCUMENTATION.DECW$BOOK]                 where:  D               device-name is the name of the drive on which you haveD               placed your DECwindows Motif Version 1.2-5 for OpenVMS               CD-ROM.                  For example:  A               $ DEFINE DECW$BOOK DKB700:[DOCUMENTATION.DECW$BOOK]n  $      1-6 The DECwindows Motif CD-ROM           H                                              The DECwindows Motif CD-ROMH                            1.5 Accessing the Documentation on the CD-ROM  B               2. Define the DECW$BOOKSHELF logical to point to theF                  appropriate LIBRARY.DECW$BOOKSHELF. Use the following2                  command to define DECW$BOOKSHELF:  O                  $ DEFINE DECW$BOOKSHELF device-name:[DOCUMENTATION.DECW$BOOK]-_*                  _$ LIBRARY.DECW$BOOKSHELF                    where:m  G                  device-name is the name of the drive on which you have G                  placed your DECwindows Motif Version 1.2-5 for OpenVMS                   CD-ROM.                    For example:   *                  $ DEFINE DECW$BOOKSHELF -J                  _$ DKB700:[DOCUMENTATION.DECW$BOOK]LIBRARY.DECW$BOOKSHELF  F                  You can also copy the DECW$BOOK files from the CD-ROMD                  to another location on your system. Always rememberG                  to define the DECW$BOOK and the DECW$BOOKSHELF logicalsH                  names to point to the location of the files you want to                  read.  A               3. Start Bookreader by choosing Bookreader from thecF                  Session Manager Applications menu. You can also start7                  Bookreader with the following command:y  1                  $ RUN SYS$SYSTEM:DECW$BOOKREADERp  @                  On Alpha systems running the New Desktop, startA                  Bookreader by clicking on the Bookreader icon ina=                  Application Manager's DECwindows Apps group.   ?                  For more information about Bookreader, see theXA                  DECwindows Motif for OpenVMS Applications Guide.t  F                 ________________________Note  ________________________  A                 If you want to provide systemwide definitions for >                 the DECW$BOOK and DECW$BOOKSHELF logical names@                 (that is, for all users on the system), you need%                 the SYSNAM privilege.   E                 _____________________________________________________   H                                          The DECwindows Motif CD-ROM 1-7 o  r             The DECwindows Motif CD-ROM2      1.5 Accessing the Documentation on the CD-ROM  -            Documentation in Bookreader Format   @            The following documentation is provided in Bookreader=            format and is located in [DOCUMENTATION.DECW$BOOK]             directory:_  E            Table_1-2_Bookreader_Manuals______________________________   E            Title______________________Title__________________________i  D            DECwindows Companion to    DECwindows Extensions to Motif$            the OSF/Motif Style Guide  B            DECwindows Motif for       DECwindows Motif for OpenVMS=            OpenVMS Applications       Guide to Non-C Bindings             Guide  ;            OSF/Motif Programmer's     OSF/Motif Style Guider            Guide  A            Overview of DECwindows     Porting XUI Applications tot+            Motif for OpenVMS          Motifl            Documentation  C            DECwindows Motif Guide to  Managing DECwindows Motif forb5            Application Programming    OpenVMS Systems   B            Using DECwindows Motif     VMS DECwindows Device Driver,            for OpenVMS                Manual  B            VMS DECwindows Transport   VMS DECwindows Guide to XlibD            Manual                     (Release 4) Programming: MIT C-                                       Binding               VMS DECwindows Guideo            to Xlib (Release 4)E            Programming:_VAX_Binding__________________________________m  ;      1.5.3 Accessing PostScript or ASCII Text Documentatione  @            PostScript (.PS) files and ASCII text file are storedC            in the directory [DOCUMENTATION] on the DECwindows Motifc,            Version 1.2-5 for OpenVMS CD-ROM.  E            To print the PostScript or ASCII text documentation, mount D            the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM and/            enter the appropriate PRINT command.   $      1-8 The DECwindows Motif CD-ROM    S      H                                              The DECwindows Motif CD-ROMH                            1.5 Accessing the Documentation on the CD-ROM  4               Use commands similar to the following:  ,                  $ MOUNT/OVERRIDE=ID DKB500:C                  $ PRINT DKB500:[DOCUMENTATION]DW_V125_INSTAL_GD.PS #                  $ DISMOUNT DKB500:i                 where:  G               DKB500: is the device name of the source drive that holds                the CD-ROMH               DW_V125_INSTAL_GD.PS is the name of the file to be printed  9               Documentation in Text and PostScript Format_  G               The following documentation is provided in ASCII text and F               PostScript formats and is located in the [DOCUMENTATION]               directory:  B               Table 1-3 Documentation in PostScript and ASCII TextH               __________Formats_________________________________________  H               Title______________________File_Name______________________  ?               DECwindows Motif Version   DW_V125_COV_LETTER.TXTa>               1.2-5 for OpenVMS Cover    DW_V125_COV_LETTER.PS               Letter  8               DECwindows Motif           DW_V125_SPD.TXT7               Version 1.2-5 for          DW_V125_SPD.PSO&               OpenVMS Software Product               Description   >               DECwindows Motif Version   DW_V125_INSTAL_GD.TXT=               1.2-5 for OpenVMS          DW_V125_INSTAL_GD.PS                 Installation Guide  :               Guide to the DECwindows    DW_V125_CD_GD.TXT9               Motif Version 1.2-5 for    DW_V125_CD_GD.PSe               OpenVMS CD-ROM  >               DECwindows Motif Version   DW_V125_REL_NOTES.TXT=               1.2-5 for OpenVMS Release  DW_V125_REL_NOTES.PS                Notesu  C               Getting Started With the   DW_V124_NEW_DESKTOP_GD.TXToH               New_Desktop________________DW_V124_NEW_DESKTOP_GD.PS______  H                                          The DECwindows Motif CD-ROM 1-9                  The DECwindows Motif CD-ROM+      1.6 Locating Installation InstructionsD  +      1.6 Locating Installation Instructions   A            The installation instructions for the DECwindows MotifrB            Version 1.2-5 for OpenVMS software are available in theB            DECwindows Motif Version 1.2-5 for OpenVMS Installation            Guide.   C               _____________________ Important _____________________f  ;               Read the installation instructions before yous=               attempt to install the DECwindows Motif Version )               1.2-5 for OpenVMS software.t  C               _____________________________________________________o                                                              %      1-10 The DECwindows Motif CD-ROMe e  o