                     C                      ______________________________________________ =                      Guide to the Compaq DECwindows Motif for #                      OpenVMS CD-ROM   .                      Order Number: AA-Q4BXE-RE                          April 2001   @                      This guide lists the contents of the Compaq9                      DECwindows Motif for OpenVMS CD-ROM.           C                      Revision/Update Information: This is a revised 9                                                   manual.   C                      Software Version:            Compaq DECwindows C                                                   Motif for OpenVMS F                                                   Alpha, Version 1.2-6C                                                   Compaq DECwindows C                                                   Motif for OpenVMS D                                                   VAX, Version 1.2-6  G                      Operating System Version:    OpenVMS Alpha Version =                                                   6.2, 7.1-2, ?                                                   7.2-1, or 7.3 E                                                   OpenVMS VAX Version ;                                                   6.2, 7.1, =                                                   7.2, or 7.3 C                                                   VMS Version 5.5-2         0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________             April 2001   -             2001 Compaq Computer Corporation   B            COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo:            Registered in U.S. Patent and Trademark Office.  B            Motif, OSF/1, and UNIX are registered trademarks of The            Open Group.  >            All other product names mentioned herein may be theB            trademarks or registered trademarks of their respective            companies.   D            Confidential computer software. Valid license from CompaqE            or authorized sublicensor required for possession, use, or E            copying. Consistent with FAR 12.211 and 12.212, Commercial B            Computer Software, Computer Software Documentation, and>            Technical Data for Commercial Items are licensed toA            the U.S. Government under vendor's standard commercial             license.   @            Compaq shall not be liable for technical or editorial0            errors or omissions contained herein.  C            The information in this publication is subject to change B            without notice and is provided "AS IS" WITHOUT WARRANTYA            OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF C            THIS INFORMATION REMAINS WITH THE RECIPIENT. IN NO EVENT @            SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL,E            INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER =            (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF >            BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OFD            BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OFE            THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY @            REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHERC            PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN C            CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL B            LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL)            PURPOSE OF ANY LIMITED REMEDY.   E            The limited warranties for Compaq products are exclusively E            set forth in the documentation accompanying such products. ?            Nothing herein should be construed as constituting a *            further or additional warranty.  E                                                                ZK6474   C            The Compaq OpenVMS documentation set is available on CD-             ROM.                            H         ________________________________________________________________  H                                                                  Preface      G               This guide contains information about the contents of the 9               Compaq DECwindows Motif for OpenVMS CD-ROM.            Related Documents   G               For additional information on the OpenVMS System Software F               Group (OSSG) products and services, access the following-               OpenVMS World Wide Web address:   +               http://www.openvms.compaq.com   G               Refer to the following documents for detailed information C               about installation procedures and further information @               on Compaq DECwindows Motif for OpenVMS changes and               enhancements:   G               o  Compaq DECwindows Motif for OpenVMS Installation Guide   B               o  Compaq DECwindows Motif for OpenVMS Release Notes  A               o  Compaq DECwindows Motif for OpenVMS Cover Letter            Reader's Comments   G               Compaq welcomes your comments on this manual. Please send <               comments to either of the following addresses:  /               Internet    openvmsdoc@compaq.com   5               Mail        Compaq Computer Corporation >                           OSSG Documentation Group, ZKO3-4/U08,                           110 Spit Brook Rd./                           Nashua, NH 03062-2698   H                                                                      iii                 *      How To Order Additional Documentation  <            Use the following World Wide Web address to order$            additional documentation:  .            http://www.openvms.compaq.com:8000/                                                                                    iv                        H                                                                        1H         ________________________________________________________________  H                                              The DECwindows Motif CD-ROM      D               This guide lists the contents of the Compaq DECwindowsF               Motif for OpenVMS CD-ROM and describes how to access theB               documentation and product installation instructions.  #         1.1 Contents of This CD-ROM   E               The Compaq DECwindows Motif for OpenVMS CD-ROM contains                the following:  B               o  Compaq DECwindows Motif for OpenVMS software kits  *               o  New Desktop documentation  B               o  Compaq DECwindows Motif for OpenVMS documentation  E               o  POLYCENTER Software Installation utility (PCSI) ECO, C                  to be used when installing Compaq DECwindows Motif G                  for OpenVMS on OpenVMS Version 6.2xx and Version 7.1xx                   systems.            1.2 Handling the CD-ROM   E               The Compaq DECwindows Motif for OpenVMS CD-ROM accompa- E               nying this guide is enclosed in an antistatic envelope. H               For instructions on how to insert the CD-ROM into the disc7               drive, see the associated owner's manual.   &         1.3 Directories on This CD-ROM  >               The CD-ROM contains binary files for both CompaqF               DECwindows Motif for OpenVMS Alpha and Compaq DECwindowsG               Motif for OpenVMS VAX products. You can install the Alpha C               product by using the POLYCENTER Software Installation D               utility (PCSI). You can install the VAX product eitherG               with PCSI or by using the VMSINSTAL utility, depending on 4               your OpenVMS operating system version.  H                                          The DECwindows Motif CD-ROM 1-1                  The DECwindows Motif CD-ROM#      1.3 Directories on This CD-ROM   :            Table 1-1 lists the kit locations and contents.    A            Table 1-1 Directory Structure on the Compaq DECwindows E            __________Motif_for_OpenVMS_CD-ROM________________________   E            Directory_Name___________Contents_________________________   D            [PCSI_UTILITY_ALPHA]     ECO and README file for the PCSIB                                     utility. If you are installing?                                     Compaq DECwindows Motif for D                                     OpenVMS on OpenVMS Alpha VersionC                                     6.2xx or Version 7.1xx systems, ;                                     install this ECO first.   D            [PCSI_UTILITY_VAX]       ECO and README file for the PCSIB                                     utility. If you are installing?                                     Compaq DECwindows Motif for B                                     OpenVMS on OpenVMS VAX VersionC                                     6.2xx or Version 7.1xx systems, ;                                     install this ECO first.   ?            [PCSI_ALPHA_DWMOTIF126]  Compaq DECwindows Motif for @                                     OpenVMS Alpha. Install usingC                                     PCSI on systems running OpenVMS B                                     Alpha Version 6.2xx or higher.  ?            [PCSI_VAX_DWMOTIF126]    Compaq DECwindows Motif for C                                     OpenVMS VAX. Install using PCSI B                                     on systems running OpenVMS VAX<                                     Version 6.2xx or higher.  ?            [VMSINSTAL_VAX_          Compaq DECwindows Motif for >            DWMOTIF126]              OpenVMS VAX. Install using@                                     VMSINSTAL on systems running6                                     VMS Version 5.5-2.  B            [DOCUMENTATION]          Product documentation in HTML,D                                     Bookreader, PostScript and ASCIIE            _________________________text_formats.____________________   C            See the Compaq DECwindows Motif for OpenVMS Installation 8            Guide for specific installation instructions.    $      1-2 The DECwindows Motif CD-ROM           H                                              The DECwindows Motif CD-ROMH                            1.4 Accessing the Documentation on the CD-ROM  5         1.4 Accessing the Documentation on the CD-ROM   E               The Compaq DECwindows Motif for OpenVMS CD-ROM contains G               DECwindows Motif documentation in PostScript, ASCII text, G               Bookreader, and HTML formats. The documentation files are +               in the following directories:   *               o  [DOCUMENTATION] directory@                  Contains PostScript and ASCII text files of theF                  product's Software Product Description (SPD), releaseG                  notes, documentation overview, installation guide, and                   cover letter.  4               o  [DOCUMENTATION.DECW$BOOK] directoryB                  Contains Bookreader files of the DECwindows Motif1                  Version 1.2-4 documentation set.   /               o  [DOCUMENTATION.HTML] directory H                  Contains HTML files of selected Compaq DECwindows MotifH                  for OpenVMS manuals and the New Desktop (Common Desktop0                  Environment) documentation set.                                                H                                          The DECwindows Motif CD-ROM 1-3                  The DECwindows Motif CD-ROM2      1.4 Accessing the Documentation on the CD-ROM  '      1.4.1 Accessing HTML Documentation   D            The web browser you use to view HTML manuals depends uponD            which version of OpenVMS you have running on your system.C            For example, systems running OpenVMS Alpha Version 7.1-2 B            or later can run either Netscape Navigator Gold VersionB            3.03 or the currently supported version of Mozilla as aC            web browser. See the Compaq DECwindows Motif for OpenVMS A            Release Notes for a complete list of the supported web 1            browsers currently offered on OpenVMS.   E            Once you have chosen a web browser, use the following pro- D            cedure to start the browser and access the documentation:  B            1. Install the web browser software (see Installing the               Web Browser).   %            2. Invoke the web browser.   D            3. From the File menu, choose the Open File or Open Local               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 haveE               placed your Compaq DECwindows Motif for OpenVMS CD-ROM.                  For example:  3               DKB700:[DOCUMENTATION.HTML]INDEX.HTML   C            5. The set of titles is displayed; click on the title of /               the manual that you want to open.   %            Installing the Web Browser   C            If your system is running OpenVMS Version 7.2 or higher, >            you can install the Netscape Navigator as an option?            when installing the OpenVMS software. Otherwise, you A            can download the latest version of either the Netscape C            Navigator or Mozilla for OpenVMS Alpha software from the             following locations:                o  Netscape Navigator  I               http://www.openvms.compaq.com/openvms/internetnetworks.html   $      1-4 The DECwindows Motif CD-ROM           H                                              The DECwindows Motif CD-ROMH                            1.4 Accessing the Documentation on the CD-ROM  *               o  Mozilla for OpenVMS Alpha  Y                  http://www.openvms.compaq.com/openvms/products/ips/register_mozilla.html   D               Refer to the associated readme files and product notesH               for instructions on how to install the browser software onF               VAX and Alpha systems. For more about other Internet and3               E-business offerings on OpenVMS, see:   A               http://www.openvms.compaq.com/e-business/index.html   F                 ________________________Note  ________________________  ?                 The DECwindows Motif HTML documentation is best A                 viewed with the Netscape Navigator or Mozilla web A                 browser. However, neither browser is supported on A                 VMS 5.5-2 systems. On these systems, you must use @                 the NCSA Mosaic browser to view HTML files. Note@                 that with this browser, you might encounter some<                 anomalies when displaying the documentation.  A                 For information on using the NCSA Mosaic browser, C                 see the Compaq DECwindows Motif for OpenVMS Release                  Notes.  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  ?               o  Common Desktop Environment: Programmer's Guide   J               o  Common Desktop Environment: Style Guide and Certification                  Checklist  A               o  Common Desktop Environment: Internationalization #                  Programmer's Guide   H                                          The DECwindows Motif CD-ROM 1-5                  The DECwindows Motif CD-ROM2      1.4 Accessing the Documentation on the CD-ROM  2            o  Common Desktop Environment: Glossary  ?            o  Compaq DECwindows Motif for OpenVMS Release Notes   D            o  Compaq DECwindows Motif for OpenVMS Installation Guide  ?            o  Compaq DECwindows Motif for OpenVMS Documentation                Overview  -      1.4.2 Accessing Bookreader Documentation   B            If you have a workstation and have installed DECwindowsA            Motif software, you can view the manuals in Bookreaderd-            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 Compaq DECwindowsA            Motif for OpenVMS CD-ROM, use the following procedure:   .            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 haveE               placed your Compaq DECwindows Motif for OpenVMS CD-ROM.,                 For example:  A               $ DEFINE DECW$BOOK DKB700:[DOCUMENTATION.DECW$BOOK]   ?            2. Define the DECW$BOOKSHELF logical to point to the C               appropriate LIBRARY.DECW$BOOKSHELF. Use the following /               command to define DECW$BOOKSHELF:   L               $ DEFINE DECW$BOOKSHELF device-name:[DOCUMENTATION.DECW$BOOK]-'               _$ LIBRARY.DECW$BOOKSHELF_                 where:  D               device-name is the name of the drive on which you haveE               placed your Compaq DECwindows Motif for OpenVMS CD-ROM.m  $      1-6 The DECwindows Motif CD-ROM R  s      H                                              The DECwindows Motif CD-ROMH                            1.4 Accessing the Documentation on the CD-ROM                    For example:r  *                  $ 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 logicaluH                  names to point to the location of the files you want to                  read.  A               3. Start Bookreader by choosing Bookreader from theaF                  Session Manager Applications menu. You can also start7                  Bookreader with the following command:i  1                  $ RUN SYS$SYSTEM:DECW$BOOKREADERn  @                  On Alpha systems running the New Desktop, startA                  Bookreader by clicking on the Bookreader icon in =                  Application Manager's DECwindows Apps group.O  ?                  For more information about Bookreader, see theCA                  DECwindows Motif for OpenVMS Applications Guide.A  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                 _____________________________________________________   0               Documentation in Bookreader Format  C               The following documentation is provided in BookreaderH@               format and is located in [DOCUMENTATION.DECW$BOOK]               directory:  H               Table_1-2_Bookreader_Manuals______________________________  H               Title______________________Title__________________________  G               DECwindows Companion to    DECwindows Extensions to Motif '               the OSF/Motif Style Guide   H                                                 (continued on next page)  H                                          The DECwindows Motif CD-ROM 1-7 b  o             The DECwindows Motif CD-ROM2      1.4 Accessing the Documentation on the CD-ROM  E            Table_1-2_(Cont.)_Bookreader_Manuals______________________   E            Title______________________Title__________________________n  B            DECwindows Motif for       DECwindows Motif for OpenVMS=            OpenVMS Applications       Guide to Non-C Bindings             Guide  A            Overview of DECwindows     Porting XUI Applications to +            Motif for OpenVMS          Motifs            Documentation  C            DECwindows Motif Guide to  Managing DECwindows Motif fors5            Application Programming    OpenVMS Systemsc  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-                                       BindingE              VMS DECwindows GuideN            to Xlib (Release 4)E            Programming:_VAX_Binding__________________________________                                         $      1-8 The DECwindows Motif CD-ROM           H                                              The DECwindows Motif CD-ROMH                            1.4 Accessing the Documentation on the CD-ROM  >         1.4.3 Accessing PostScript or ASCII Text Documentation  F               PostScript (.PS) files and ASCII text file are stored inD               the directory [DOCUMENTATION] on the Compaq DECwindows'               Motif for OpenVMS CD-ROM.   H               To print the PostScript or ASCII text documentation, mountF               the Compaq DECwindows Motif for OpenVMS CD-ROM and enter,               the appropriate PRINT command.  4               Use commands similar to the following:  )               $ MOUNT/OVERRIDE=ID DKB500: @               $ PRINT DKB500:[DOCUMENTATION]DW_V126_INSTAL_GD.PS                $ DISMOUNT DKB500:                 where:  G               DKB500: is the device name of the source drive that holds                the CD-ROM@               DW_V126_INSTAL_GD.PS is the name of the file to be               printed.  9               Documentation in Text and PostScript Formatb  G               The following documentation is provided in ASCII text andiF               PostScript formats and is located in the [DOCUMENTATION]               directory:  B               Table 1-3 Documentation in PostScript and ASCII TextH               __________Formats_________________________________________  H               Title______________________File_Name______________________  ?               Compaq DECwindows Motif    DW_V126_COV_LETTER.TXTs>               for OpenVMS Cover Letter   DW_V126_COV_LETTER.PS  A               Compaq DECwindows Motif    DW_V126_DOC_OVERVIEW.TXT @               for OpenVMS Documentation  DW_V126_DOC_OVERVIEW.PS               Overview  8               Compaq DECwindows Motif    DW_V126_SPD.TXT7               for OpenVMS Software       DW_V126_SPD.PSi!               Product Descriptione  H                                                 (continued on next page)  H                                          The DECwindows Motif CD-ROM 1-9 i  t             The DECwindows Motif CD-ROM2      1.4 Accessing the Documentation on the CD-ROM  B            Table 1-3 (Cont.) Documentation in PostScript and ASCIIE            __________________Text_Formats____________________________   E            Title______________________File_Name______________________   ;            Compaq DECwindows Motif    DW_V126_INSTAL_GD.TXTr:            for OpenVMS Installation   DW_V126_INSTAL_GD.PS            Guide  7            Guide to the Compaq        DW_V126_CD_GD.TXT 6            DECwindows Motif for       DW_V126_CD_GD.PS            OpenVMS CD-ROM   ;            Compaq DECwindows Motif    DW_V126_REL_NOTES.TXT-:            for OpenVMS Release Notes  DW_V126_REL_NOTES.PS  @            Getting Started With the   DW_V124_NEW_DESKTOP_GD.TXTE            New_Desktop________________DW_V124_NEW_DESKTOP_GD.PS_______  +      1.5 Locating Installation Instructions_  B            The installation instructions for the Compaq DECwindowsA            Motif for OpenVMS software are available in the Compaq ;            DECwindows Motif for OpenVMS Installation Guide.   B            Compaq strongly suggests that you read the installationA            instructions prior to installing the Compaq DECwindows &            Motif for OpenVMS software.                                  %      1-10 The DECwindows Motif CD-ROM 