                     C                      ______________________________________________ ?                      DECwindows Motif Version 1.2-5 for OpenVMS '                      Installation Guide   .                      Order Number: AA-Q1EAD-TE    "                      December 1998  C                      This manual provides step-by-step instructions F                      for installing DECwindows Motif Version 1.2-5 for                      OpenVMS.           D                      Revision/Update Information: This manual super-F                                                   sedes the DECwindows?                                                   Motif Version C                                                   1.2-4 for OpenVMS E                                                   Installation Guide.   G                      Operating System:            OpenVMS Alpha Version :                                                   6.2, 7.1C                                                   VMS Version 5.5-2   B                      Software Version:            DECwindows MotifC                                                   Version 1.2-5 for ?                                                   OpenVMS Alpha B                                                   DECwindows MotifC                                                   Version 1.2-5 for =                                                   OpenVMS VAX         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             Compaq Computer Corporation 1998. All rights reserved.   G            The following are trademarks of Compaq Computer Corporation: B            Alpha, Compaq, DECdirect, DECwindows, DIGITAL, OpenVMS,C            VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.   4            The following are third-party trademarks:  =            Ada is a registered trademark of the United States             government.  <            Adobe, Adobe Illustrator, Display POSTSCRIPT, and@            POSTSCRIPT are registered trademarks of Adobe Systems            Incorporated.  >            Compaq is a registered trademark of Compaq Computer            Corporation.   E            Motif, OSF, OSF/1, OSF/Motif, and Open Software Foundation E            are registered trademarks of the Open Software Foundation,             Inc.   E            NCSA Mosaic and Mosaic are trademarks of the University of (            Illinois at Urbana-Champaign.  >            X Window System is a trademark of the Massachusetts#            Institute of Technology.   D            Windows is a trademark, and Windows NT, NT, and Microsoft>            are registered trademarks of Microsoft Corporation.  A            All other trademarks and registered trademarks are the 0            property of their respective holders.  E                                                                ZK6538   @            The DIGITAL OpenVMS documentation set is available on            CD-ROM.                               C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................     ix     '    1  Preparing to Install the Software   C          1.1   License Registration.........................    1-2 C          1.2   Supported Hardware...........................    1-3 1          1.3   Prerequisites for the Installation C                Procedures...................................    1-3 C          1.4   Required Operating System Software...........    1-3 3          1.5   Required ECO for POLYCENTER Software C                Installation Utility.........................    1-5 :          1.6   OSF/Motif Release 1.1.3 and XUI ProgrammingC                Support......................................    1-6 C          1.7   Saving Customized Bookreader Files...........    1-7 C          1.8   Installation Procedure Requirements..........    1-9 C          1.8.1     Process Account Quotas...................    1-9 C          1.8.2     Disk Space...............................   1-10 C          1.8.3     System Parameters........................   1-13 0          1.8.4     Additional System MaintenanceC                    Procedures...............................   1-14 C          1.8.4.1     Checking System Parameter Values.......   1-15 :          1.8.4.2     Calculating the Number of Free GlobalC                      Pages and Global Sections..............   1-15 C          1.8.4.3     Setting the Size of the Page File......   1-17 ;          1.8.4.4     Changing System Parameter Values Using C                      the AUTOGEN Utility....................   1-17 C          1.8.5     Backing Up Your System Disk..............   1-19 C          1.8.6     Notifying Other Users....................   1-19           C                                                                 iii                  :      2  Using the POLYCENTER Software Installation Utility  E            2.1   Accessing Help Information...................    2-2 <            2.2   Extracting and Printing the Product ReleaseE                  Notes........................................    2-3 E            2.3   Installing the Software......................    2-3 E            2.3.1     Starting the Installation................    2-4 E            2.3.2     The Installation Dialog..................    2-5 >            2.3.2.1     Verifying Sufficient Allocation for theE                        GBLPAGES and CLISYMTBL Values..........    2-6 E            2.3.2.2     Running AUTOGEN........................    2-7 E            2.3.2.3     Language Variants Notice...............    2-8 9            2.3.2.4     Verifying DECwindows Motif Support E                        Files..................................    2-9 E            2.3.2.5     Saving the Programming Environment.....   2-11 E            2.3.2.6     Default Installation...................   2-12 >            2.3.2.7     Asking About Selecting a Desktop (AlphaE                        Only)..................................   2-12 E            2.3.2.8     Programming Language Support Options...   2-13 E            2.3.2.9     Reviewing the Installation Options.....   2-16 E            2.3.2.10    Execution Dialog.......................   2-16 E            2.4   Recovering from Errors.......................   2-18 E            2.5   Adjusting Parameters After Installation......   2-18   >      3  Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)  E            3.1   Installation Procedure Requirements..........    3-2 E            3.1.1     Process Privileges.......................    3-3 E            3.1.2     Using an Alternate Working Device........    3-3 E            3.1.3     Using the Distributed File Service.......    3-5 E            3.2   Installation Procedure.......................    3-5 E            3.2.1     Product and Device Names.................    3-5 E            3.2.2     Invoking the VMSINSTAL Procedure.........    3-6 E            3.2.3     Confirming System Backup.................    3-8 E            3.2.4     Mounting Distribution Media..............    3-9 E            3.2.5     Choosing a Release Notes Option..........   3-10 E            3.2.6     Continuing the Installation..............   3-11 ;            3.2.7     Preserving the OSF/Motif Release 1.1.3 E                      Programming Environment..................   3-11 E            3.2.8     Installing the Entire Kit................   3-12 E            3.2.9     Choosing Programming Support Files.......   3-13 E            3.2.10    Verifying Kit Selections.................   3-14 E            3.2.11    Verifying Disk Space.....................   3-15           iv                  H               3.2.12    Verifying License Registration...........   3-17H               3.2.13    Performing a System Reboot...............   3-17H               3.2.14    Reading Informational Messages...........   3-18?               3.2.15    Using the AUTOGEN Utility to Set System H                         Parameters...............................   3-20H               3.2.16    Completing the Installation Procedure....   3-22H               3.3   Recovering from Errors.......................   3-23H               3.4   Accessing the Release Notes..................   3-23    (         4  After Installing the Software  H               4.1   Starting the DECwindows Motif Software.......    4-1H               4.1.1     Standalone Systems.......................    4-3H               4.1.2     VMScluster Systems.......................    4-3H               4.1.2.1     Starting Nonsatellite and Boot Nodes...    4-4H               4.1.2.2     Starting Satellite Nodes...............    4-4H               4.2   Running the IVP..............................    4-5H               4.3   Choosing an Alternative Console..............    4-7H               4.4   Selecting the Desktop (Alpha Only)...........    4-8  -         5  Managing DECwindows Motif Software   A               5.1   Customizing the DECwindows X11 Display Server H                     Startup Procedure............................    5-1<               5.2   Using the DECW$MOTIF_TAILOR Utility (VMSH                     Version 5.5-2 Only)..........................    5-8H               5.3   Adding DECwindows Base-Support Files.........   5-14;               5.3.1     Reconfiguring the OpenVMS Operating H                         System (Alpha Only)......................   5-14<               5.3.2     Using the SYS$UPDATE:DECW$TAILOR.EXEH                         Command (VAX Only).......................   5-15H               5.4   Determining and Reporting Problems...........   5-19  :         A  POLYCENTER Software Installation Utility Sample            Installations  ;               A.1   Sample Installation on an OpenVMS Alpha H                     Version 7.1 System...........................    A-2A               A.2   Sample Installation on an OpenVMS VAX Version H                     7.1 System...................................    A-7;               A.3   Sample Installation on an OpenVMS Alpha H                     Version 6.2 System...........................   A-11    H                                                                        v                 %      B  VMSINSTAL Sample Installation   =            B.1   Sample Installation Using VMSINSTAL on a VMS E                  Version 5.5-2 System.........................    B-1         C  Software Components     
      Index    
      Examples   E            4-1       Sample IVP...............................    4-6   E            5-1       Sample DECW$MOTIF_TAILOR Session.........   5-11   E            5-2       Sample DECW$TAILOR Session...............   5-17   =            A-1       Sample Installation of the Mandatory ECO E                      for PCSI on an OpenVMS Alpha System......    A-2   9            A-2       Sample Installation of an Upgrade of 9                      DECwindows Motif on an OpenVMS Alpha >                      Version 7.1 System With Sufficient SystemE                      Resources................................    A-4   9            A-3       Sample Installation of an Upgrade of 7                      DECwindows Motif Version 1.2-5 for 6                      OpenVMS on an OpenVMS VAX Version8                      7.1 System With Insufficient SystemE                      Resources................................    A-7   =            A-4       Sample Installation of the Mandatory ECO E                      for PCSI on an OpenVMS Alpha System......   A-11   6            A-5       Sample Installation of an Upgrade6                      of DECwindows Motif on an OpenVMS:                      Alpha System With Insufficient SystemE                      Resources................................   A-12   E            B-1       Sample Installation Using VMSINSTAL......    B-1             vi                           Tables  A               1-1       Directories for Previous XUI or OSF/Motif H                         Programming Environments.................    1-7  ;               1-2       Process Quotas for the Installation H                         Account..................................    1-9  :               1-3       Approximate Required Disk Space byH                         Component (in Blocks)....................   1-11  9               1-4       Minimum Required System Parameter H                         Values...................................   1-13  A               1-5       Required Number of Contiguous Free Global H                         Pages and Free Global Sections...........   1-16  >               1-6       Recommended System Parameter Values toH                         Use with the ADD_ Option.................   1-18  H               5-1       DECwindows Keymap........................    5-4  <               5-2       Classes of OpenVMS Files That Can Be:                         Removed with the DECW$MOTIF_TAILORH                         Utility..................................    5-9  =               5-3       Classes of Files That Can Be Added or H                         Removed with the DECW$TAILOR Utility.....   5-16                                  H                                                                      vii                           H         ________________________________________________________________  H                                                                  Preface               Intended Audience   E               This manual is intended for anyone who plans to install B               DECwindows Motif Version 1.2-5 for OpenVMS software.           Document Structure  A               This manual contains the following chapters and ap-                pendixes:   B               o  Chapter 1 discusses how to prepare for installingE                  DECwindows Motif Version 1.2-5 for OpenVMS software.   D               o  Chapter 2 discusses how to install DECwindows MotifH                  Version 1.2-5 for OpenVMS using the POLYCENTER Software&                  Installation utility.  >               o  Chapter 3 discusses how to install DECwindowsD                  Motif Version 1.2-5 for OpenVMS using the VMSINSTAL                  procedure.   D               o  Chapter 4 provides startup procedures. This chapterA                  also includes a sample Installation Verification !                  Procedure (IVP).   E               o  Chapter 5 discusses tuning, customizing the environ- E                  ment, removing unwanted files, and reporting errors.   >               o  Appendix A presents a sample DECwindows MotifH                  installation using the POLYCENTER Software InstallationG                  utility on an OpenVMS Alpha 7.1 system, an OpenVMS VAX E                  7.1 system, and an OpenVMS Alpha 6.2 system. It also @                  presents a sample installation of the PCSI ECO.  E               o  Appendix B shows a sample product installation using G                  the VMSINSTAL procedure on a VMS Version 5.5-2 system.   H                                                                       ix                 C            o  Appendix C shows how to obtain a list of the software ?               components for the DECwindows Motif Version 1.2-5_?               for OpenVMS product using the POLYCENTER Softwaren#               Installation utility.o          Related Documents  B            In addition to this manual, the following documents areD            useful when installing DECwindows Motif Version 1.2-5 for            OpenVMS software:  @            o  DECwindows Motif Version 1.2-5 for OpenVMS Release               Notes   E            o  Guide to the DECwindows Motif Version 1.2-5 for OpenVMS                CD-ROM  2            o  Getting Started With the New Desktop  ;            o  Managing DECwindows Motif for OpenVMS Systems   -            o  OpenVMS System Manager's Manualo  B            o  OpenVMS System Management Utilities Reference Manual  B            o  A Comparison of System Management on OpenVMS AXP and               OpenVMS VAX   B            For additional information on the Open Systems SoftwareC            Group (OSSG) products and services, access the following *            OpenVMS World Wide Web address:  )            http://www.openvms.digital.com         Reader's Comments  8            Compaq welcomes your comments on this manual.  =            Print or edit the online form SYS$HELP:OPENVMSDOC_w5            COMMENTS.TXT and send us your comments by:   1            Internet    openvmsdoc@zko.mts.dec.com   C            Fax         603 884-0120, Attention: OSSG Documentation,a!                        ZKO3-4/U08         x t                 5               Mail        Compaq Computer Corporation_>                           OSSG Documentation Group, ZKO3-4/U08,                           110 Spit Brook Rd./                           Nashua, NH 03062-2698u    -         How To Order Additional Documentationb  ?               Use the following World Wide Web address to ordert'               additional documentation:d  0               http://www.openvms.digital.com:81/  F               If you need help deciding which documentation best meets:               your needs, call 800-DIGITAL (800-344-4825).           Conventionsi  G               DECwindows Motif Version 1.2-5 for OpenVMS Alpha contains H               a graphical user interface that is derived from the CommonF               Desktop Environment (CDE). This interface is referred to:               throughout this document as the New Desktop.  G               VMScluster systems are now referred to as OpenVMS ClusteruH               systems. Unless otherwise specified, references to OpenVMSG               Clusters or clusters in this document are synonymous witha               VMSclusters.  D               In this manual, every use of DECwindows and DECwindowsD               Motif refers to DECwindows Motif for OpenVMS software.  E               The following conventions are also used in this manual:k  G               Ctrl/x           A sequence such as Ctrl/x indicates thatlF                                you must hold down the key labeled CtrlH                                while you press another key or a pointing-                                device button.   D               <Return>         In examples, a key name enclosed in aD                                box indicates that you press a key onH                                the keyboard. (In text, a key name is not2                                enclosed in a box.)  D                                In the HTML version of this document,C                                this convention appears as brackets, 1                                rather than a box.,  H                                                                       xi o                 B             . . .           Horizontal ellipsis points in examplesD                             indicate one of the following possibili-!                             ties:6  A                             o  Additional optional arguments in a ;                                statement have been omitted._  A                             o  The preceding item or items can be :                                repeated one or more times.  @                             o  Additional parameters, values, or@                                other information can be entered.  A            .                Vertical ellipsis points indicate the A            .                omission of items from a code example D            .                or command format; the items are omittedA                             because they are not important to theq2                             topic being discussed.  ;            ( )              In command format descriptions, >                             parentheses indicate that you mustA                             enclose the choices in parentheses if 5                             you choose more than one.   D            [ ]              In command format descriptions, brackets?                             indicate optional elements. You can-D                             choose one, none, or all of the options.@                             (Brackets are not optional, however,@                             in the syntax of a directory name inC                             an OpenVMS file specification or in the E                             syntax of a substring specification in an12                             assignment statement.)  D            |                In command format descriptions, verticalA                             bars separating items inside brackets B                             indicate that you choose one, none, or9                             more than one of the options.   B            { }              In command format descriptions, bracesB                             surround a required choice of options;>                             you must choose one of the options#                             listed.           xii                   D               text style       This text style represents the intro-F                                duction of a new term or the name of anC                                argument, an attribute, or a reason.t  D                                In the HTML version of this document,F                                this convention appears as italic text.  >               italic text      Italic text indicates important>                                information, complete titles ofG                                manuals, or variables. Variables includei@                                information that varies in systemC                                messages (Internal error number), in.E                                command lines (/PRODUCER=name), and insC                                command parameters in text (where ddiE                                represents the predefined code for the.,                                device type).  F               UPPERCASE TEXT   Uppercase text indicates a command, theH                                name of a routine, the name of a file, orG                                the abbreviation for a system privilege..  E               Monospace type   Monospace type indicates code examplesu?                                and interactive screen displays.t  G                                In the C programming language, monospaceoD                                type in text identifies the following?                                elements: keywords, the names ofrH                                independently compiled external functions?                                and files, syntax summaries, and E                                references to variables or identifiersP8                                introduced in an example.  F               -                A hyphen at the end of a command formatF                                description, command line, or code lineF                                indicates that the command or statement?                                continues on the following line.3  A               numbers          All numbers in text are assumed to A                                be decimal unless otherwise noted. C                                Nondecimal radixes-binary, octal, or D                                hexadecimal-are explicitly indicated.      H                                                                     xiii 2                     H                                                                        1H         ________________________________________________________________  H                                        Preparing to Install the Software      E               This chapter describes the preparation and requirements.G               for installing DECwindows Motif Version 1.2-5 for OpenVMS.H               software using either the POLYCENTER Software InstallationH               utility or the VMSINSTAL procedure. Your Bill of MaterialsD               (BOM) specifies the number and contents of your media.G               Verify the contents of your kit with this information. IfsH               your kit is damaged or if you find that parts are missing,1               contact your Compaq representative.   F                 ________________________Note  ________________________  D                 Compaq strongly recommends that you read the releaseB                 notes before proceeding with the installation. TheB                 DECwindows Motif Version 1.2-5 for OpenVMS productD                 provides online release notes. For information about,                 accessing the release notes:  C                 o  If you install the software using the POLYCENTER.B                    Software Installation utility, see Section 2.2.  D                 o  If you use the VMSINSTAL procedure to install the/                    software, see Section 3.2.5.   E                 _____________________________________________________   C               This chapter presents information about the following                topics:)  2               o  Section 1.1, License Registration  0               o  Section 1.2, Supported Hardware  @               o  Section 1.3, Prerequisites for the Installation                  Procedures.  @               o  Section 1.4, Required Operating System Software  H                                                                      1-1           &      Preparing to Install the Software    ?            o  Section 1.5, Required ECO for POLYCENTER SoftwareM"               Installation Utility  F            o  Section 1.6, OSF/Motif Release 1.1.3 and XUI Programming               SupportD  =            o  Section 1.7, Saving Customized Bookreader Files.  >            o  Section 1.8, Installation Procedure Requirements        1.1 License Registration   D            Before you install and run DECwindows Motif Version 1.2-5D            for OpenVMS software on a newly licensed node or cluster,B            you must first register a License Product AuthorizationB            Key (License PAK) using the License Management FacilityC            (LMF). The License PAK is provided along with the kit if.D            you ordered the license and media together; otherwise, itE            is provided separately to a location based on your license.            order.   C            If you are installing DECwindows Motif Version 1.2-5 for E            OpenVMS software as an update on a node or cluster alreadyBE            licensed for this software, you have already completed ther1            License PAK registration requirements.   A            You must register and load your license for DECwindows =            Motif Version 1.2-5 for OpenVMS before you run the @            Installation Verification Procedure (IVP) and use the            software.  >            To register a license, log in to the system managerE            account (SYSTEM). Then choose one of the following options #            to register the license:M  B            o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. WhenE               the procedure prompts you for information, respond withM)               data from your License PAK.S  C            o  At the DCL prompt, enter the LICENSE REGISTER command.@               with the appropriate qualifiers that correspond to&               License PAK information.  @            If you plan to use DECwindows Motif Version 1.2-5 forB            OpenVMS software on more than one node in a VMScluster,A            load the license on the other nodes after you complete.            this installation.         1-2    m      H                                        Preparing to Install the SoftwareH                                                 1.1 License Registration  G               For complete information about using LMF, see the OpenVMS 0               License Management Utility Manual.           1.2 Supported Hardware  E               DECwindows Motif Version 1.2-5 for OpenVMS software can C               be installed on any supported Alpha or VAX processor. @               For a complete list of supported hardware, see theA               DECwindows Motif Version 1.2-5 for OpenVMS Softwaren(               Product Description (SPD).  9         1.3 Prerequisites for the Installation Procedures   C               Before you can install and configure DECwindows Motif ?               Version 1.2-5 for OpenVMS software, you must have C               the required versions of the OpenVMS operating system C               software, sufficient memory, and a license. (Refer to E               Section 1.1 for information about registering a License /               Product Authorization Key [PAK].)r  E               Use the POLYCENTER Software Installation utility or the.B               VMSINSTAL procedure to install your DECwindows MotifD               software according to the operating system information               that follows.   H               __________________________________________________________H               Operating_System___________Installation_Method____________  I               OpenVMS Alpha Version 7.1  POLYCENTER Software Installation.0               (or higher)                utility%               OpenVMS VAX Version 7.1d               (or higher)   I               OpenVMS Alpha Version      POLYCENTER Software Installation 0               6.2xx                      utility'               OpenVMS VAX Version 6.2xx   H               VMS_Version_5.5-2__________VMSINSTAL_procedure____________  .         1.4 Required Operating System Software  E               The DECwindows Motif Version 1.2-5 for OpenVMS softwarec>               requires one of the following operating systems:  6               o  OpenVMS Alpha Version 7.1 (or higher)  4               o  OpenVMS VAX Version 7.1 (or higher)  H                                                                      1-3    e      &      Preparing to Install the Software+      1.4 Required Operating System Software   '            o  OpenVMS Alpha Version 6.2n  %            o  OpenVMS VAX Version 6.2r              o  VMS Version 5.5-2o  E            If your system is not running one of these versions before D            you attempt to install DECwindows Motif Version 1.2-5 for+            OpenVMS, the installation fails.   C            A minimum of 16 MB of memory is required for OpenVMS VAX D            systems; 32 MB of memory is highly recommended. A minimumD            of 64 MB of memory is required for OpenVMS Alpha systems;;            at least 128 MB of memory is highly recommended.   ?            The OpenVMS operating system provides two subsets ofvC            components to support DECwindows Motif Version 1.2-5 for E            OpenVMS. To use DECwindows Motif Version 1.2-5 for OpenVMStC            software, your system should be running a version of thelA            OpenVMS system that includes the following components:   A            o  DECwindows Motif transports and base system supporty  B               This support is required to install DECwindows MotifC               Version 1.2-5 for OpenVMS and to run DECwindows Motifa@               Version 1.2-5 for OpenVMS applications. During theB               installation of OpenVMS, you are prompted to specify6               whether you want to install this option.  C               To determine whether this option was installed during >               the installation of OpenVMS, enter the following               command:  9               $ DIR SYS$LIBRARY:DECW$TRANSPORT_COMMON.EXEi  B               See Section 5.3 for information on adding DECwindowsB               base support files after OpenVMS has been installed.  ?            o  DECwindows X11 display server for OpenVMS, fonts,w@               and device drivers, which are necessary to displayE               DECwindows Motif Version 1.2-5 for OpenVMS applicationso@               or any other X11 applications on your Alpha or VAX               system  E               During the installation of OpenVMS, you are prompted to >               specify whether you want to install this option.        1-4 n         H                                        Preparing to Install the SoftwareH                                   1.4 Required Operating System Software  F                  To determine whether this option was installed duringA                  the installation of OpenVMS, enter the followingO                  command:s  6                  $ DIR SYS$SYSTEM:DECW$SERVER_MAIN.EXE  H                  If the DECW$SERVER_MAIN.EXE file is not on your system,F                  you cannot display DECwindows Motif Version 1.2-5 forB                  OpenVMS applications on your Alpha or VAX system.D                  However, you can run DECwindows Motif Version 1.2-5F                  for OpenVMS applications that display on a DECwindowsD                  X11 display server that runs on another system. TheH                  DECwindows Motif Version 1.2-5 for OpenVMS installation@                  procedure asks whether you want to continue the:                  installation without workstation support.  E                  See Section 5.3 for information on adding DECwindows C                  device support files and 75- or 100-dpi font files 2                  after OpenVMS has been installed.  F                 ________________________Note  ________________________  >                 See the release notes and cover letter for theD                 version of the OpenVMS operating system that you areA                 running for more information about the DECwindowsa#                 X11 display server.   E                 _____________________________________________________   E         1.5 Required ECO for POLYCENTER Software Installation Utilityt  E               If you are installing the DECwindows Motif Version 1.2-.E               5 for OpenVMS software on an OpenVMS Version 6.2 or 7.1eE               system, you must first install an ECO to the POLYCENTERcD               Software Installation (PCSI) utility. See the Guide toG               the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM forfG               details about this ECO. OpenVMS Version 7.2 includes thisaH               functionality in the operating system; therefore, you needH               not apply this ECO if you are running OpenVMS Version 7.2.  G               The following example shows a PCSI ECO installation on annF               OpenVMS Alpha Version 7.1 system (installations on other0               OpenVMS versions differ slightly):    H                                                                      1-5           &      Preparing to Install the SoftwareB      1.5 Required ECO for POLYCENTER Software Installation Utility  '      $ PRODUCT INSTALL VMS62TO71U2_PCSIL  -      The following product has been selected: J          DEC AXPVMS VMS62TO71U2_PCSI V1.0       Patch (maintenance update)  #      Do you want to continue? [YES]   %      Configuration phase starting ...   S      You will be asked to choose options, if any, for each selected product and for T      any products that may be installed to satisfy software dependency requirements.  %      DEC AXPVMS VMS62TO71U2_PCSI V1.0   <      * This product does not have any configuration options.  !      Execution phase starting ...a  <      The following product will be installed to destination:D          DEC AXPVMS VMS62TO71U2_PCSI V1.0       DISK$1:[VMS$COMMON.]        Portion done: 0%       ...10%       ...40%       ...70%       ...80%a      ...90%       ...100%  .      The following product has been installed:J          DEC AXPVMS VMS62TO71U2_PCSI V1.0       Patch (maintenance update)  <      1.6 OSF/Motif Release 1.1.3 and XUI Programming Support  A            The X Window and OSF/Motif libraries that are provided C            with DECwindows Motif Version 1.2-5 for OpenVMS software >            are incompatible with those libraries provided withD            versions of DECwindows Motif for OpenVMS prior to VersionD            1.2. Run-time compatibility is preserved, but the earlierC            OSF/Motif Release 1.1.3 and XUI programming environments B            are not compatible with the later OSF/MOTIF Release 1.2#            programming environment.   =            Programming in the XUI and OSF/Motif Release 1.1.3 A            environments that was provided in previous versions of D            DECwindows Motif is no longer supported in the DECwindows@            Motif Version 1.2-5 for OpenVMS product. However, theD            installation procedure gives you the option of saving the        1-6    t      H                                        Preparing to Install the SoftwareH                  1.6 OSF/Motif Release 1.1.3 and XUI Programming Support  D               XUI and OSF/Motif Release 1.1.3 programming files thatG               already exist on your system. If you choose to save these G               programming files, they are moved to subdirectories where{D               you can access them for programming. Specifically, theG               installation creates a subdirectory called [.DECW$113] in G               each of the directories listed in Table 1-1 and moves theiC               previous files into the new [.DECW$113] subdirectory.     G         Table 1-1 Directories for Previous XUI or OSF/Motif ProgrammingcH         __________Environments__________________________________________  H         Directory_____Contents____New_Location__________________________  E         DECW$INCLUDE  C header    SYS$SYSROOT:[DECW$INCLUDE.DECW$113]i                       files   ?         SYS$SYSTEM    UIL         SYS$SYSROOT:[SYSEXE.DECW$113]                        compiler  ?         SYS$LIBRARY   Non-C       SYS$SYSROOT:[SYSLIB.DECW$113]                        languageH         ______________bindings__________________________________________  E               Refer to Section 3.2.7 for additional information about 7               saving previous programming environments.i  F                 ________________________Note  ________________________  ;                 The process for using the saved programmingoC                 environment is documented in the programmer chapter %                 of the release notes.e  E                 _____________________________________________________a  .         1.7 Saving Customized Bookreader Files  D               The installation procedure replaces the following file!               with a new version:a  ;               SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELFi  G               If you customized this file and want to save it, copy theoG               file to another directory or rename the file prior to theoH               installation of DECwindows Motif Version 1.2-5 for OpenVMS1               software so that it is not deleted.   H                                                                      1-7           &      Preparing to Install the Software+      1.7 Saving Customized Bookreader Files   D            To copy your customized file to another directory, create?            the directory and define a global symbol in the file '            DECW$PRIVATE_APPS_SETUP.COM.   2            To create a Bookreader directory calledE            SYS$COMMON:[DECW$BOOK_LOCAL], perform the following steps:   B            1. Create the directory and assign world read access as               follows:  5               $ CREATE/DIRECTORY/PROTECTION=WORLD:R -d-               _$ SYS$COMMON:[DECW$BOOK_LOCAL]a  =            2. Copy the LIBRARY.DECW$BOOKSHELF file to the newm#               directory as follows:   D               $ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF -2               _$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG  ?            3. If the SYS$MANAGER directory does not contain the_@               DECW$PRIVATE_APPS_SETUP.COM command file, copy the9               template file to a command file as follows:a  C               $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE -i<               _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG  B            4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and defineE               the global symbol DECW$BOOK to point to your BookreaderuA               directory by adding the following line to the file:r  ;               $ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]"   E            5. Restart DECwindows Motif using the following command if C               you performed step 4 after installing the product andmE               after DECwindows had been started (for example, after a_               reboot):  1               $ @SYS$MANAGER:DECW$STARTUP RESTART   A            For more information about customizing your DECwindowss?            Motif environment, see Managing DECwindows Motif forr            OpenVMS Systems.             1-8    e      H                                        Preparing to Install the SoftwareH                                  1.8 Installation Procedure Requirements  /         1.8 Installation Procedure Requirements   D               This section discusses the requirements for installingE               your DECwindows Motif Version 1.2-5 software using PCSI 7               and the VMSINSTAL installation procedure._  >               The installation procedure checks the following:  >               o  Whether you are logged in to an appropriatelyB                  privileged account (VMSINSTAL installations only)  D               o  Whether any other users are logged in to the system  E               o  Whether you have the minimum required system accountr"                  quotas and limits  A               o  Whether you have the minimum required disk space   G               o  Whether you have the minimum required system parametert                  values   F               See Section 3.1 for information on requirements specific)               to VMSINSTAL installations.I  *               1.8.1 Process Account Quotas  G               The installation procedure requires that the installatione@               account has the minimum quotas shown in Table 1-2.  H               Table_1-2_Process_Quotas_for_the_Installation_Account_____  H               Quota_Name__Alpha_Value______VAX_Value____________________  -               ASTLM       250              24e  -               BIOLM       150              18A  1               BYTLM       64,000           32,768(  -               DIOLM       150              18k  -               ENQLM       2,000            30d  H               FILLM_______100______________20___________________________  G               Use the OpenVMS AUTHORIZE utility to verify and to changeiE               process quotas for the installation account in the useraH               authorization file (UAF). (Some sites may restrict the useE               of the AUTHORIZE utility to certain accounts or users.)oE               For example, to change the BYTLM quota for the account-fF               name installation account, enter the following commands:  H                                                                      1-9           &      Preparing to Install the Software,      1.8 Installation Procedure Requirements  #            $ SET DEFAULT SYS$SYSTEMo            $ RUN AUTHORIZE!            UAF> SHOW account-name 2            UAF> MODIFY account-name /BYTLM = 32768!            UAF> SHOW account-namer            UAF> EXIT            $ LOGOUTM  D            After you change the quotas for the installation account,C            log out of the installation account and log in again foraC            the new quotas to take effect. You can then proceed withn            the installation.  5            User account quotas are stored in the file <            SYS$SYSTEM:SYSUAF.DAT. For more information about?            modifying account quotas, see the description of the =            AUTHORIZE utility in the OpenVMS System Management &            Utilities Reference Manual.              1.8.2  Disk Space  C            Use Table 1-3 to determine the amount of free disk space D            that is required on the system disk to install DECwindows@            Motif components. However, because you can choose not@            to install all the components, your actual disk space#            requirement may be less.   E            To determine the number of free blocks on the system disk, 9            enter the following command at the DCL prompt:   &            $ SHOW DEVICE SYS$SYSDEVICE  C            The installation procedure checks for free disk space on E            the system disk. If sufficient space is not available, theoA            installation procedure provides the following options:e  +            o  Install fewer optional files.   C            o  For VMSINSTAL installations, restart the installation E               and specify another disk to use as an alternate working C               device. See Section 3.1.2 for information about using *               an alternate working device.  E            o  Terminate the installation, create more free disk space ?               on the system disk, and restart the installation.s  	      1-10            H                                        Preparing to Install the SoftwareH                                  1.8 Installation Procedure Requirements  G               o  Continue the installation and risk running out of disk_                  space.n  F                 ________________________Note  ________________________  <                 If you run out of free disk space during the?                 installation, the installation procedure fails.h  E                 _____________________________________________________   E               For VMSINSTAL installations, refer to Section 3.1.2 for B               information on using an alternate working device andD               Section 3.1.3 for information on using the Distributed               File Service.2  D               Table 1-3 Approximate Required Disk Space by ComponentH               __________(in_Blocks)_____________________________________  H               Component_____________Alpha_________VAX___________________  8               Base kit[1]           50,000        43,200  7                    Runtime support  Not           273504.                                     applicable  6                    CDA support      Not           3650.                                     applicable  7                    Motif            Not           12200s.                    applications     applicable  @               Desktop support       52,800[2]     Not applicable  @                    New Desktop      42,000        Not applicable  @                    DECwindows       8,000         Not applicable                    desktop  @                    Manual pages     2,800         Not applicable                    for                    New Desktop  H               [1]This_number_includes_all_base_kit_files._For_Alpha_____  F               systems, the indicated subcomponents are always included               in the base kit.E               [2]This number includes all desktop support. The numberlF               of blocks required for the individual desktop options is$               shown in the subtable.  H                                                 (continued on next page)  H                                                                     1-11 -  o      &      Preparing to Install the Software,      1.8 Installation Procedure Requirements  ?            Table 1-3 (Cont.) Approximate Required Disk Space byeE            __________________Component_(in_Blocks)___________________   E            Component_____________Alpha_________VAX___________________   8            Programming           12,750[3]     12,250[2]            environment  4                 C, C++           7,200         6,750  4                 FORTRAN          2,400         2,450  4                 Pascal           3,000         3,050  =                 New Desktop      150           Not applicables  3            Example programs      13,000[4]     9550i  =                 Sound examples   1,600         Not Applicableo  3                 Programming      10,100        9550                  examples  =                 New Desktop      1,300         Not Applicable                  examples  =            Translated image      33,600        Not applicablee            support  6            NCSA Mosaic           Not           1200[5]+                                  applicableh  5            Total disk space      178,000       78,000d            required:E            [2]This_number_includes_all_desktop_support._The_number___   C            of blocks required for the individual desktop options isn!            shown in the subtable. D            [3]This number includes all programming language support.B            The actual number of blocks required for the individual:            programming languages is shown in the subtable.D            [4]This number includes all examples programs. The actual?            number of blocks required for the individual example1-            programs is shown in the subtable. >            [5]NCSA Mosaic available only on VMS 5.5-2 systems.E            __________________________________________________________e  	      1-12o p  M      H                                        Preparing to Install the SoftwareH                                  1.8 Installation Procedure Requirements  %               1.8.3 System Parameters   C               Table 1-4 lists the minimum required system parameter0D               values for the installation. Depending on the kinds ofG               programs and applications running at your site, you might 3               need higher values for some settings.t  H               Table_1-4_Minimum_Required_System_Parameter_Values________                 SystemH               Parameter________Alpha_Value______VAX_Value_______________  6               GBLSECTIONS      600[1]           420[1]  9               GBLPAGES         150,000[1]       62,000[1]P  5               GBLPAGFIL        1,024            6,024   3               SWPOUTPGCNT      512              500.  5               MAXBUF           8,192            2,048i  6               VIRTUALPAGECNT   -                50,000  3               CHANNELCNT       255              255s  2               PROCSECTCNT      64               40  6               PQL_DPGFLQUOTA   -                32,768  1               PQL_MPGFLQUOTA   32,768           -e  3               PQL_MASTLM       100              100n  3               PQL_MBIOLM       100              100   6               PQL_MBYTLM       100,000          48,000  3               PQL_MDIOLM       100              100E  3               PQL_MENQLM       300              200s  3               PQL_MFILLM       100              100p  1               PQL_MPRCLM       10               8   H               [1]If_you_have_installed_other_software_that_uses_global__  G               pages or global sections, you might need a higher minimumfC               value. When you boot your system and DECwindows MotifLE               starts, the values of free GBLPAGES and GBLSECTIONS are D               checked for your system. If you do not have sufficientA               values for GBLPAGES and GBLSECTIONS, the DECwindows C               Motif startup procedure prints a warning and provides 7               a recommended value for these parameters.   H                                                 (continued on next page)  H                                                                     1-13    E      &      Preparing to Install the Software,      1.8 Installation Procedure Requirements  >            Table 1-4 (Cont.) Minimum Required System ParameterE            __________________Values__________________________________               System.E            Parameter________Alpha_Value______VAX_Value_______________   0            PQL_MWSDEFAULT   1,024            512  2            PQL_MWSQUOTA     2,048            1,024  2            PQL_MWSEXTENT    8,192            2,048  0            CLISYMTBL        512              256  .            GH_RES_CODE      1,024[2]         -  .            IMGREG_PAGES     2,000[2]         -  .            WINDOW_SYSTEM    1                1  4            NPAGEDYN         1,998,848        999,936  4            PAGEDYN          600,000          400,000  2            WSMAX            12,000           4,096E            [2]This_system_parameter_is_available_only_on_OpenVMS_____O  1            Alpha Version 6.2 (or higher) systems.eE            __________________________________________________________   C               ______________________ Caution ______________________   ;               If you do not ensure that your system has thesB               necessary number of global pages and global sections=               for the installation, the DCL tables can becomeg               corrupted.  C               _____________________________________________________o  :            1.8.4  Additional System Maintenance Procedures  A            This section explains how to use the System Generationr>            utility (SYSGEN) and the AUTOGEN utility to prepareA            your system for the DECwindows Motif Version 1.2-5 fore@            OpenVMS installation. The AUTOGEN utility uses systemE            configuration data to automatically set system parameters.e  C               ________________________Note ________________________i  ;               The DECwindows Motif installation and startupv@               procedures automatically check for required systemA               parameter values and pass the appropriate values to   	      1-14_ i  m      H                                        Preparing to Install the SoftwareH                                  1.8 Installation Procedure Requirements  D                 AUTOGEN. Therefore, in most cases you do not have to7                 check and modify these values manually..  E                 _____________________________________________________   6               1.8.4.1 Checking System Parameter Values  G               To check the values of your system parameters, invoke the_E               SYSGEN utility by entering the following command at thet               DCL prompt:a  %               $ RUN SYS$SYSTEM:SYSGEN                SYSGEN>_  E               At the SYSGEN prompt, enter the SHOW command to displayrD               the value of a system parameter. The following commandA               displays the value for the MAXBUF system parameter:a  !               SYSGEN> SHOW MAXBUF_  H               After checking the parameters with the SHOW command, enterD               the EXIT command at the SYSGEN prompt to return to DCL               level.  ?               If the current values are less than the values inD@               Table 1-4, increase the system parameter settings.D               Section 1.8.4.4 describes the procedures for using the7               AUTOGEN utility to increase these values.   E               1.8.4.2 Calculating the Number of Free Global Pages and                Global Sectionsd  E               If your system parameter values are equal to or greater A               than the minimum values specified in Table 1-4, you E               can continue with the product installation. However, touH               install and run DECwindows Motif Version 1.2-5 for OpenVMSF               software, you must have sufficient free global pages andG               global sections for the DECwindows Motif software and theS-               file SYS$LIBRARY:DCLTABLES.EXE.g  D               First, determine how many free global pages and globalE               sections exist on your system and how many are requiredEF               to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE.E               Then, if necessary, use the AUTOGEN utility to increase ?               the values of the GBLPAGES and GBLSECTIONS systemW               parameters.F  H                                                                     1-15 S  M      &      Preparing to Install the Software,      1.8 Installation Procedure Requirements  E            Enter the following DCL command to determine the number of ?            global pages required for SYS$LIBRARY:DCLTABLES.EXE:T  /            $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXES  @            This command returns the size (in blocks) of the fileC            SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use thistD            figure as the number of global pages needed for the file.  E            Enter the WRITE command with the F$GETSYI lexical functionOA            to find the number of contiguous free global pages andgD            the number of free global sections. The following exampleA            shows how to obtain this information at your terminal,e/            which is the default for SYS$OUTPUT:   B            $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") <Return>            15848@            $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") <Return>
            24   ;            See Table 1-5 to determine whether the number ofe>            contiguous free global pages and the number of freeA            global sections is sufficient. If these values are not A            sufficient to continue with the installation, then seee>            Section 1.8.4.4, which describes the procedures for=            increasing these values using the AUTOGEN utility.-  D            Table 1-5 Required Number of Contiguous Free Global PagesE            __________and_Free_Global_Sections________________________n  E            ____________Currently_Running_DECwindows_Motif____________   E            System_Resource__Alpha_Value______VAX_Value_______________   2            CONTIG_GBLPAGES  12,000           6,000  /            FREE_GBLSECTS    20               20i  E            __________________________________________________________ E            __________Not_Currently_Running_DECwindows_Motif__________   E            System_Resource__Alpha_Value______VAX_Value_______________   3            CONTIG_GBLPAGES  92,000           47,000n  E            FREE_GBLSECTS____260______________130_____________________o  	      1-16            H                                        Preparing to Install the SoftwareH                                  1.8 Installation Procedure Requirements  7               1.8.4.3 Setting the Size of the Page Filef  B               In order for DECwindows Motif to run with acceptableG               performance, the page file must be large enough to handle A               the virtual memory requirements of your system. The D               optimal size of the page file depends on many factors,E               such as the amount of physical memory on the system and (               the application work load.  F               As a general rule, the page file size should be at leastF               75,000 blocks on OpenVMS Alpha systems and 50,000 blocksE               on OpenVMS VAX systems. However, these sizes may be toooC               small on systems where a large number of applicationsAG               are run. On a heavily loaded system it may be possible tolF               achieve large performance improvements by increasing the?               size of the page file by a factor of two or more.   C               Normally you should run AUTOGEN with feedback and let B               AUTOGEN calculate the size of the page file based onC               the usage pattern on your system. To run AUTOGEN with$8               feedback, enter the following DCL command:  =               $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACKW  H               You can also increase the size of the page file by runningE               the SYSGEN utility or by invoking the command procedureo'               SYS$UPDATE:SWAPFILES.COM.   E               For more information about setting the size of the pagedF               file and running AUTOGEN, see the Guide to Setting Up anD               OpenVMS System. For more information about performanceE               tuning in general, see the Guide to OpenVMS Performancen               Management.I  @               1.8.4.4 Changing System Parameter Values Using the               AUTOGEN Utility1  B               Use the AUTOGEN utility to change system parameters.F               AUTOGEN automatically adjusts values for parameters thatC               are associated with the values you reset manually. ToaB               change system parameters with AUTOGEN, edit the file'               SYS$SYSTEM:MODPARAMS.DAT.   E               To change a parameter value listed in this file, delete H               the current value associated with that parameter and enter               the new value.  H                                                                     1-17           &      Preparing to Install the Software,      1.8 Installation Procedure Requirements  E            To add a new parameter, add a line to the file and includepE            both the name of the parameter and its value. For example:e              MIN_MAXBUF = 8192  A            To make incremental adjustments to parameters, such as D            global pages and global sections, use ADD_. The following>            example increases the global pages value by 30,000:              ADD_GBLPAGES = 30000c  A            Table 1-6 lists the system parameters that you need to              adjust incrementally.  D            Table 1-6 Recommended System Parameter Values to Use withE            __________the_ADD__Option_________________________________               SystemiE            Parameter________Alpha_Increment__VAX_Increment___________a  0            SYSMWCNT         -                235  0            GBLSECTIONS      280              140  3            GBLPAGES         92,000           30,000   2            GBLPAGFIL        768              5,000  4            NPAGEDYN         300,000          500,000  E            PAGEDYN__________180,000__________100,000_________________o  C            After you enter all your changes, exit from the file andeA            execute the AUTOGEN utility to recalculate your systemDA            parameters. Enter the following command to recalculate 8            your system parameters and reboot the system:  /            $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT_  C            When you specify REBOOT, the AUTOGEN utility performs an_E            automatic system shutdown and then reboots the system. Any0E            users logged in to the system are immediately disconnected A            during the shutdown. The automatic reboot puts the newo(            parameter values into effect.  E            For details about using AUTOGEN, see the section about theoE            AUTOGEN utility in the OpenVMS System Manager's Manual and E            the AUTOGEN section in OpenVMS System Management Utilities             Reference Manual.  	      1-18     l      H                                        Preparing to Install the SoftwareH                                  1.8 Installation Procedure Requirements  /               1.8.5 Backing Up Your System Disk   A               Compaq recommends that you back up your system diskeF               before you install any software. At the beginning of theC               installation, the installation procedure asks whether F               your system disk is backed up. Use the backup proceduresB               that are established at your site. For details aboutE               performing a system disk backup, see the section on the G               Backup utility in the OpenVMS System Management Utilities                Reference Manual.   )               1.8.6 Notifying Other Users   C               Inform users on the system that you plan to install a E               product and that they must log out during the installa-_H               tion. To make sure that you are the only user logged in to-               the system, follow these steps:_  E               1. Notify current users to log out. Enter the following +                  command at the DCL prompt:   M                  $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of -0I                  _$ DECwindows Motif Version 1.2-5 for OpenVMS please..."   A               2. Enter the following command at the DCL prompt topC                  prevent nonprivileged users from logging in to the1                  system:  +                  $ SET LOGINS/INTERACTIVE=0   E               If possible, give users an estimated time when they can1)               log in to the system again.                           H                                                                     1-19                       H                                                                        2H         ________________________________________________________________  H                       Using the POLYCENTER Software Installation Utility      A               This chapter describes how to install and configurenG               DECwindows Motif Version 1.2-5 for OpenVMS software usingaC               the POLYCENTER Software Installation utility on AlphacE               and VAX systems. The DECwindows Motif Version 1.2-5 forwH               OpenVMS product supports POLYCENTER Software installationsA               using the Digital Command Language (DCL) interface.d  C               This chapter presents information about the following                topics:l  8               o  Section 2.1, Accessing Help Information  A               o  Section 2.2, Extracting and Printing the Product                   Release Notes  5               o  Section 2.3, Installing the Software   4               o  Section 2.4, Recovering from Errors  G               Refer to the OpenVMS System Manager's Manual for complete H               details about installing and managing software products onF               your system. In addition to getting started information,?               the OpenVMS System Manager's Manual also providesa?               information about several useful topics, such as:r  ,               o  Removing installed products  1               o  Reconfiguring installed productse  7               o  Copying software kits to new locations   /               o  Retrieving product informationG  G               o  Discussing differences between the POLYCENTER Software0A                  Installation utility and the VMSINSTAL procedure   H                                                                      2-1           7      Using the POLYCENTER Software Installation UtilityE    B            Refer to Section 1.4 for information about prerequisite!            software and licenses._  C               ________________________Note ________________________3  >               You must use the VMSINSTAL Software InstallationA               utility to install DECwindows Motif software on VMS $               Version 5.5-2 systems.  C               _____________________________________________________E  C               ______________________ Caution ______________________   ;               If you do not have a satisfactory backup copyP<               of your system disk, do not attempt to installB               DECwindows Motif Version 1.2-5 for OpenVMS software.B               Back up the system disk (as described in the OpenVMS@               upgrade and installation supplement for your Alpha=               or VAX processor) before you install DECwindows 7               Motif Version 1.2-5 for OpenVMS software.u  :               Before beginning the installation procedure,A               review Chapter 1 for information about installationi,               preparations and requirements.  C               _____________________________________________________   #      2.1 Accessing Help Information   A            Online help is available with the installation utility A            for all PRODUCT commands and qualifiers. For help on aaC            specific command, enter the DCL command HELP followed bym(            the command and product name.  A            Refer to the following documents for information about 5            tasks and PRODUCT commands and qualifiers:V  -            o  OpenVMS System Manager's ManualA  B            o  OpenVMS System Management Utilities Reference Manual  $            o  OpenVMS DCL Dictionary            2-2 2  8      H                       Using the POLYCENTER Software Installation UtilityH                    2.2 Extracting and Printing the Product Release Notes  =         2.2 Extracting and Printing the Product Release NotesA  E               Before you begin the installation procedure, you should,H               read the product's release notes. To extract a copy of theG               DECwindows Motif Version 1.2-5 for OpenVMS Release Notes, F               define PCSI$SOURCE to point to the location (device nameD               and directory) of the PCSI kit. Then enter the PRODUCTC               EXTRACT RELEASE_NOTES command followed by the product <               name, DWMOTIF, at the DCL prompt. For example:  A               $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF125] 5               $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF   C               Once you extract the release notes to a file, you can_F               print the file. Note that you do not need to install the;               product before you extract the release notes.y  D               The DECwindows Motif Version 1.2-5 for OpenVMS ReleaseG               Notes are also available in HTML and ASCII (.TXT) formatsoD               in the documentation directory on the DECwindows MotifE               Version 1.2-5 for OpenVMS CD-ROM. Refer to the Guide to G               the DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM for E               information about accessing the release notes and other -               DECwindows Motif documentation.   #         2.3 Installing the Softwarea  E                 _____________________ Important _____________________   C                 If you are installing DECwindows Motif Version 1.2- @                 5 for OpenVMS software on an OpenVMS Version 7.1>                 or Version 6.2 system, you must install an ECO@                 for the POLYCENTER Software Installation utility@                 before installing the DECwindows Motif software.C                 See the Guide to the DECwindows Motif Version 1.2-5 B                 for OpenVMS CD-ROM for details about this ECO. See1                 Section 1.5 for more information.l  E                 _____________________________________________________   E               The sections that follow take you through the stages of H               installing your DECwindows Motif Version 1.2-5 for OpenVMSA               software using the POLYCENTER Software InstallationvH               utility. The installation procedure is nearly identical on$               Alpha and VAX systems.  H                                                                      2-3    G      7      Using the POLYCENTER Software Installation Utility        2.3 Installing the Software  C            Refer to Chapter 1 for information about account quotas,t-            disk space, and system parameters.c  D            Refer to the OpenVMS System Manager's Manual for complete=            information about responding to questions that theu?            POLYCENTER Software Installation utility asks during A            product installation. For example, when you respond toe/            questions, you can do the following:e  >            o  Enter a value and press the Return key to select               options.  <            o  Press the Return key to accept default values.  %            o  Confirm your responses.   A               After you respond to questions by selecting optionsiC               or accepting default values, the installation utilityS1               displays a summary of your answers.t  A               Then a question is displayed asking whether you areeA               satisfied with your answers and whether you want toiE               continue with the installation. If you decide to change C               your responses, type No and press the Return key. You E               can then either reenter your responses or answer No ands1               exit from the installation utility.   7            o  Stop the installation by pressing Ctrl/Y.   7               Note that this option is not recommended.r  +            2.3.1  Starting the Installationm  A            To start the POLYCENTER Software Installation utility,rA            enter one of the following commands at the DCL prompt:C  >            $ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF125]  
            or   <            $ DEFINE PCSI$SOURCE device:[PCSI_VAX_DWMOTIF125]  >            where device is the name of the device on which the*            distribution CD-ROM is mounted.  E            Next, invoke the POLYCENTER Software Installation utility:n  $            $ PRODUCT INSTALL DWMOTIF        2-4 f  e      H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software  +               2.3.2 The Installation Dialog"  C               The installation dialog begins by displaying the nameTC               of the product which PCSI is installing. You are thenS@               asked to verify that you wish to continue with theB               installation. The dialog continues with a display ofD               product name, copyright, and Product Authorization Key                (PAK) information.  0         The following product has been selected:B             DEC AXPVMS DWMOTIF V1.2-5              Layered Product  &         Do you want to continue? [YES]  (         Configuration phase starting ...  V         You will be asked to choose options, if any, for each selected product and forW         any products that may be installed to satisfy software dependency requirements.e  3         DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif   W             DECwindows Motif Version 1.2-5 for OpenVMS Alpha is based on Release 5 (R5)2E             of the MIT X11 Window System and OSF/Motif Version 1.2.3._  Q             DECwindows Motif V1.2-5 provides both runtime support and development O             support for the X Window system. Runtime and development support isNO             provided for MIT X11 Release 5 and OSF/Motif Version 1.2.3. Runtime_A             only support is provided for OSF/Motif Version 1.1.3.   T             Copyright Digital Equipment Corporation 1988, 1998. All rights reserved.  U             Restricted Rights: Use, duplication, or disclosure by the U.S. GovernmentiQ             is subject to restrictions as set forth in subparagraph (c)(1)(ii) ofeS             DFARS  252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III,              as  applicable.r  T             This software is proprietary to and embodies the confidential technologyQ             of Digital Equipment Corporation. Possession, use, or copying of thisnU             software and media is authorized only pursuant to a valid written licenseg6             from Digital or an authorized sublicensor.  )             Digital Equipment Corporations  J             This software product is sold by Digital Equipment Corporation  /             This product uses the PAK: DW-MOTIFa  H                                                                      2-5 b  t      7      Using the POLYCENTER Software Installation Utilityr       2.3 Installing the Software  M          This software is furnished under the licensing provisions of DigitaluL          Equipment Corporation's Standard Terms and Conditions. For more in-M          formation about Digital's licensing terms and policies, contact yourA          local Digital office.  C            2.3.2.1 Verifying Sufficient Allocation for the GBLPAGESU            and CLISYMTBL Values     C               ________________________Note ________________________g  ?               If you are simultaneously installing or upgradingd:               the OpenVMS operating system with DECwindows>               from the CD-ROM, the installation procedure will>               continue without checking your system values. It@               will check after the installation is complete (see               Section 2.5).g  C               _____________________________________________________e  C            The installation command procedure checks to ensure thattE            adequate values are allocated for GBLPAGES, CLISYMTBL, andl&            NPAGEDYN system parameters:  A            o  On OpenVMS Alpha systems, the minimum value for the B               GBLPAGES system parameter is 150,000; on OpenVMS VAX3               systems, the minimum value is 62,000.i  A            o  On OpenVMS Alpha systems, the minimum value for the ?               CLISYMTBL system parameter is 512; on OpenVMS VAX 0               systems, the minimum value is 256.  A            o  On OpenVMS Alpha systems, the minimum value for the D               NPAGEDYN system parameter is 1,998,848; on OpenVMS VAX4               systems, the minimum value is 999,936.  A            If your system values are sufficient, the installationaC            procedure continues. If the values are insufficient, theeC            procedure abandons the installation and instructs you to D            run AUTOGEN and then restart the installation. On OpenVMSE            Alpha systems, the procedure displays a message similar to             the following:g            2-6 y  ,      H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software  /         Checking values of system parameters...t  X         %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000Z         %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1294336, should be at least 1998848S         %DECW-W-BADVALUE, SYSGEN parameter CLISYMTBL is 265, should be at least 512   U           The installation procedure has determined that some system parameter valuesLP           require modification to install the DECwindows Motif Version 1.2-5 for           OpenVMS software._  Q           Please type the following command to run AUTOGEN and reboot your systemuR           before restarting the DECwindows installation.  This will set the systemO           parameters to appropriate values for running DECwindows Motif V1.2-5.l  A                 @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK   8         The DECwindows installation is being terminated.  8         Please run AUTOGEN and restart the installation.  *         %PCSI-E-S_OPFAIL, operation failedU         %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error conditionn  D               A similar message is displayed on OpenVMS VAX systems.  %               2.3.2.2 Running AUTOGENc  C               If the installation procedure has prompted you to run H               AUTOGEN to correct your system values, enter the following               command:  ;         $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACKR  G               The system runs AUTOGEN and produces a log similar to the                 following example:                    H                                                                      2-7    .      7      Using the POLYCENTER Software Installation Utilitye       2.3 Installing the Software  2      %AUTOGEN-I-BEGIN, GETDATA phase is beginning.M      %AUTOGEN-I-NEWFILE,  Previous contents of SYS$SYSTEM:CLU$PARAMS.DAT haveaG        been copied to SYS$SYSTEM:CLU$PARAMS.OLD.  You may wish to purge !        SYS$SYSTEM:CLU$PARAMS.OLD.eQ      %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:PARAMS.DAT has been created.b-              You may wish to purge this file.a>      %AUTOGEN-I-END, GETDATA phase has successfully completed.4      %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning.U      %AUTOGEN-I-NEWFILE, A new version of SYS$MANAGER:VMSIMAGES.DAT has been created. -              You may wish to purge this file.gT      %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:SETPARAMS.DAT has been created.-              You may wish to purge this file.w@      %AUTOGEN-I-END, GENPARAMS phase has successfully completed.3      %AUTOGEN-I-BEGIN, GENFILES phase is beginning.h  N      %AUTOGEN-I-REPORT, AUTOGEN has produced some informational messages whichQ              have been stored in the file SYS$SYSTEM:AGEN$PARAMS.REPORT.  You mays9              wish to review the information in that file.h  ?      %AUTOGEN-I-END, GENFILES phase has successfully completed. 4      %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning.+      %AUTOGEN-I-SYSGEN, parameters modified @      %AUTOGEN-I-END, SETPARAMS phase has successfully completed.1      %AUTOGEN-I-BEGIN, REBOOT phase is beginning.   E      The system is shutting down to allow the system to boot with the =      generated site-specific parameters and installed images.   D      The system will automatically reboot after the shutdown and the      upgrade will be complete.  ;              SHUTDOWN -- Perform an Orderly System ShutdownY'                          on node MYNODE   >            You can now restart the installation procedure (see            Section 2.3.1).  +            2.3.2.3 Language Variants Noticea  >            The dialog now displays a warning about the need to?            update any language variants. You should not install >            DECwindows Motif Version 1.2-5 unless you will alsoC            install DECwindows Motif Version 1.2-5 language variantse6            for all the languages that you wish to use.        2-8 b         H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software  V             Local Language Variants of DECwindows Motif must be upgraded at this time.  Q             If you have a language variant of DECwindows Motif installed then you P             must upgrade to the version for DECwindows Motif Version 1.2-5 afterS             completing this installation and before rebooting the system. A failured<             to do so could prevent DECwindows from starting.  X             If there is no local language variant upgrade available for DECwindows MotifR             Version 1.2-5 then you should remove the local language variant before6             installing DECwindows Motif Version 1.2-5.  *             Do you want to continue? [YES]  >               2.3.2.4 Verifying DECwindows Motif Support Files  G               The installation procedure verifies that DECwindows MotifsC               applications and run-time support files are installed F               on the operating system (for example, transport and fontD               files, which are required for running DECwindows Motif               software).  T           **** DECwindows Motif application and run-time support files DETECTED ****  E               On OpenVMS VAX systems, if the files are not installed,t1               the following message is displayed:   U             The DECwindows Motif application and run-time support files have not beent             installed.  Q             You can use the DECwindows tailoring facility to tailor on the device_N             support files and the 75DPI and/or the 100DPI font files using theS             DECwindows save sets which are shipped with the OpenVMS kit as follows:   +                $ RUN SYS$UPDATE:DECW$TAILORr  A             The installation of DECwindows Motif cannot continue.e  G               On OpenVMS Alpha systems, the files are always installed.r  F               Next, the installation procedure checks for the presenceC               of support files that are needed to use the system as C               a workstation or as a workstation boot server. If theCC               support files are installed, the following message iso               displayed:  <           **** DECwindows device support files DETECTED ****  H                                                                      2-9 l  i      7      Using the POLYCENTER Software Installation Utilityd       2.3 Installing the Software  B            On OpenVMS VAX systems, if the files are not installed,A            users are warned with the following message that their @            systems cannot be a workstation or a workstation boot            server:  T          The DECwindows device support files for using this machine as a workstationD          or as a boot node for workstations have not been installed.  N          You can use the DECwindows tailoring facility to tailor on the deviceK          support files and the 75DPI and/or the 100DPI font files using therR          DECwindows save sets, which are shipped with the OpenVMS kit, as follows:  '            $ RUN SYS$UPDATE:DECW$TAILORb  D            On OpenVMS Alpha systems, if the files are not installed,A            users are warned with the following message that theirn@            systems cannot be a workstation or a workstation boot            server:  T          The DECwindows device support files for using this machine as a workstationD          or as a boot node for workstations have not been installed.  O          You can use the POLYCENTER Software Installation utility to change the H          options selected when the OpenVMS Alpha software was installed.O          See the POLYCENTER Software Installation Utility User's Guide for moreaS          information. To add the support files and the 75DPI and/or the 100DPI font P          files using the DECwindows save sets which are shipped with the OpenVMS=          kit, use the PRODUCT RECONFIGURE command as follows:O  $            $ PRODUCT RECONFIGURE VMS  N          You should add the "Support for DECwindows" subclass in the Utilities          class.h  D            On both systems, the installation procedure then asks the            following question:  T      Do you wish to continue with this installation without the workstation support?  C            If you answer No (default) and press the Return key, theMC            installation is stopped. See Section 5.3 for information B            on adding the necessary support files. Once you install@            the necessary support files, restart the installation            procedure.o  D            If you answer Yes and press the Return key, the installa-            tion continues.  	      2-10            H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software  G               Note that this portion of the installation does not occurdC               if you are simultaneously installing or upgrading ther7               OpenVMS operating system with DECwindows._  8               2.3.2.5 Saving the Programming Environment  E               The installation procedure checks whether the OSF/MotifwB               Release 1.1.3 programming environment exists on yourB               system. If it is present, the installation procedureE               displays the following information and asks whether youAB               want to save the OSF/Motif Release 1.1.3 programming               environment:  M             The DECwindows Motif programming environment was installed with anS             previous version of this kit. This environment is incompatible with thetT             OSF/Motif Release 1.2 environment provided with DECwindows Motif VersionJ             1.2-5. The XUI programming environment is also not included in+             DECwindows Motif Version 1.2-5.   N             If you intend to continue developing programs for XUI or OSF/MotifK             Release 1.1.3, then save this environment.  Please refer to theeR             installation guide for more details and information on accessing these(             files in their new location.  L             If you do not choose to save the XUI and OSF/Motif Release 1.1.3P             programming environment, those files will be removed from the system             disk.e  M             Save the OSF/Motif Release 1.1.3 and XUI programming environment?   D               If you answer Yes and press the Return key to save theF               OSF/Motif Release 1.1.3 and XUI programming environment,E               a subdirectory called [.DECW$113] is created. The files H               that support that programming environment are moved to the'               [.DECW$113] subdirectory.s  F               If you answer No and press the Return key, the files are               deleted.  B               Refer to Section 1.6 for information about accessingF               files related to the OSF/Motif Release 1.1.3 programming               environment.  G               Note that this portion of the installation does not occurwC               if you are simultaneously installing or upgrading thee7               OpenVMS operating system with DECwindows.   H                                                                     2-11    t      7      Using the POLYCENTER Software Installation UtilityR       2.3 Installing the Software  '            2.3.2.6 Default Installationn  @            Next, the dialog asks if you want the default instal-?            lation. On systems with no previous DECwindows Motift@            installation, the installation procedure installs allC            options that apply to your hardware platform. On systemso=            with a previous DECwindows Motif installation, theg?            installation procedure installs all options selected.,            during the previous installation.  4      Do you want the defaults for all options? [YES]  C            The remainder of this chapter assumes that you answer Noa            to this question.  @            2.3.2.7 Asking About Selecting a Desktop (Alpha Only)  ?            On OpenVMS Alpha systems, the installation procedure.B            displays information about the New Desktop and asks youA            whether the New Desktop should be the default desktop.i            Install New Desktop  $          Requires 42000 disk blocks.  O          The New Desktop is a graphical user interface that is derived from themP          Common Desktop Environment (CDE).  It offers the following features not;          available with the traditional DECwindows desktop:a  Q              o Multiple workspaces for greater flexibility in managing windows on                 the screen.  O              o An icon-based File Manager to make it easier to manipulate files 1                from the graphical user interface.N  M              o Enhanced support for the drag-and-drop feature, which is fully_H                supported in the new File Manager and Application Manager                applications.  =              o New Image Viewer and Icon Editor applications.   T          Both the New Desktop and the DECwindows desktop provide the same underlyingS          X and Motif libraries and the same DECterm, Bookreader, Mail, and Calendar           applications.  "          Install New Desktop [YES]  A              Install Manual (reference) pages for the New Desktop   '              Requires 2803 disk blocks.t  	      2-12y           H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software  I                 The manual pages provide online help text for New Desktop H                 functions. If installed they can be viewed using the man9                 page viewer from the Application Manager.p  J                 Install Manual (reference) pages for the New Desktop [YES]  >                 Make the New Desktop the default desktop [YES]  2             Install traditional DECwindows Desktop  &             Requires 7843 disk blocks.  T             The traditional DECwindows Desktop is that provided since Version 1.2 ofS             DECwindows. If both new and traditional desktops are installed the usern4             can select which to run when logging in.  8             Install traditional DECwindows Desktop [YES]  F               See Section 4.4 for instructions about how to change theE               choice of desktop after the installation has completed.   :               2.3.2.8 Programming Language Support Options  C               Next, the dialog asks you which programming languages E               you want to install and whether you want to install thee#               programming examples.   G               On OpenVMS Alpha systems, the installation procedure uses #               the following dialog:   2             Programming Support for the C Language  &             Requires 7321 disk blocks.  P             Headers and related files to support programs in C that will use the!             DECwindows libraries.A  8             Programming Support for the C Language [YES]  7             Programming Support for the Pascal Languages  &             Requires 3010 disk blocks.  I             Include files to support programs in Pascal that will use thee!             DECwindows libraries.u  =             Programming Support for the Pascal Language [YES]p  8             Programming Support for the FORTRAN Language  &             Requires 2429 disk blocks.  H                                                                     2-13 8         7      Using the POLYCENTER Software Installation Utility,       2.3 Installing the Software  G          Include files to support programs in FORTRAN that will use thef          DECwindows libraries.  ;          Programming Support for the FORTRAN Language [YES]s  0          Programming Support for the New Desktop  "          Requires 145 disk blocks.  M          Headers and related files to support programs in C that will use theo          New Desktop widgets.   6          Programming Support for the New Desktop [YES]            Programming examples   K          Requires from 0 to 12964 disk blocks depending upon configuration.g  >          Examples of programming to use the various libraries.  #          Programming examples [YES]   @          Do you want all the defaults for the subitems? [YES] no                 Sound example files  '              Requires 1556 disk blocks.r  ?              Sample sound files that can be used with DECsound.n  &              Sound example files [YES]  0              Programming examples for DECwindows  (              Requires 10140 disk blocks.  T              Examples, in various programming languages, of using the DECwindows and,              standard widgets and libraries.  6              Programming examples for DECwindows [YES]  5              Programming examples for the New Desktopt  '              Requires 1268 disk blocks.5  T              Examples, in C, of using the new widgets provided with the New Desktop.  ;              Programming examples for the New Desktop [YES]r  !          Translated Image Supporto  $          Requires 33562 disk blocks.  	      2-14     S      H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software  N             Translated image support to allow programs translated from the VAXP             to work on the Alpha with the DECwindows libraries. Translated image9             support is not available for the New Desktop.U  *             Translated Image Support [YES]  E               On OpenVMS VAX systems, the installation procedure uses #               the following dialog:   8             DECwindows Motif runtime support files [YES]  2             Programming Support for the C Language  &             Requires 7321 disk blocks.  P             Headers and related files to support programs in C that will use the!             DECwindows libraries.,  8             Programming Support for the C Language [YES]  7             Programming Support for the Pascal Languaget  &             Requires 3010 disk blocks.  I             Include files to support programs in Pascal that will use thec!             DECwindows libraries.   =             Programming Support for the Pascal Language [YES]e  8             Programming Support for the FORTRAN Language  &             Requires 2429 disk blocks.  J             Include files to support programs in FORTRAN that will use the!             DECwindows libraries.%  >             Programming Support for the FORTRAN Language [YES]  &             Programming examples [YES]            H                                                                     2-15    U      7      Using the POLYCENTER Software Installation Utility-       2.3 Installing the Software  5            2.3.2.9 Reviewing the Installation Optionse  B            The dialog gives you a chance to review the options you8            have selected during the installation dialog.  .      Do you want to review the options? [NO] y  0      DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif!          Install New Desktop: YESaD            Install Manual (reference) pages for the New Desktop: YES8            Make the New Desktop the default desktop: YES4          Install traditional DECwindows Desktop: YES4          Programming Support for the C Language: YES9          Programming Support for the Pascal Language: YESl:          Programming Support for the FORTRAN Language: YES5          Programming Support for the New Desktop: YESm"          Programming examples: YES#            Sound example files: YES 3            Programming examples for DECwindows: YESd8            Programming examples for the New Desktop: YES&          Translated Image Support: YES  0      Are you satisfied with these options? [YES]  $            2.3.2.10 Execution Dialog  C            At this point, you have answered all installation dialognB            questions. During the execution phase, the installationD            utility begins by displaying the names of all products itD            will install or remove. This is followed by an indication'            of the procedure's progress.   A            If the installation is successful, the dialog displays A            a list of all products installed and removed. Finally,pB            the procedure displays final installation notes for the$            DECwindows Motif product.  !      Execution phase starting ...s  <      The following product will be installed to destination:D          DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.]<      The following product will be removed from destination:D          DEC AXPVMS DWMOTIF V1.2-4              DISK$2:[VMS$COMMON.]    	      2-16t           H                       Using the POLYCENTER Software Installation UtilityH                                              2.3 Installing the Software           Portion done: 0%         ...10%         ...20%         ...30%         ...40%         ...50%         ...60%         ...70%         ...80%         ...90%         ...100%c  1         The following product has been installed: B             DEC AXPVMS DWMOTIF V1.2-5              Layered Product/         The following product has been removed:nB             DEC AXPVMS DWMOTIF V1.2-4              Layered Product  3         DEC AXPVMS DWMOTIF V1.2-5: DECwindows MotifC  R             System reboot will be required following upgrade of language variants.  O             A system reboot will be required to install the new DECwindow MotiffP             for OpenVMS images. If this is a new installation you should execute0             AUTOGEN using the following command:  G                     $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACKn  O             This command adjusts your system parameters and reboots the system.i  O             If you wish to use DECwindows with any language other than English,OK             install the appropriate DECwindows Motif Version 1.2-5 language I             variant product before using AUTOGEN or rebooting the system.   H             Installation Verification Procedure can be run after reboot.  T             Run the Installation Verification Procedure (IVP) after the installationN             is completed and the system is rebooted. The IVP is located in the7             following directory: SYS$TEST:DECW$IVP.COM.e              H                                                                     2-17           7      Using the POLYCENTER Software Installation Utility       2.4 Recovering from ErrorsI        2.4 Recovering from Errorsa  C            An error during installation can occur if one or more ofr+            the following conditions exists:   8            o  The operating system version is incorrect.  =            o  The prerequisite software version is incorrect.   >            o  Quotas necessary for successful installation are               inadequate.   E            o  Process quotas required by the installation utility are                inadequate.   ;            o  The OpenVMS Help library is currently in use.l  D            For descriptions of the error messages generated by theseA            conditions, see the documents listed in the Associated:E            Documents section in the Preface. These documents may helplD            you diagnose errors and decide what corrective actions to            take.  >            If the installation procedure fails for any reason,@            the POLYCENTER Software Installation utility displays.            a message similar to the following:  L      %PCSIUI-INSFAIL, The installation of DECwindows Motif Version 1.2-5 for      OpenVMS has failed.  E            If the installation fails, fix the problem and restart the "            installation procedure.  0      2.5 Adjusting Parameters After Installation  @            If you are simultaneously installing or upgrading theD            OpenVMS operating system with DECwindows from the CD-ROM,@            the installation procedure will will check the system$            parameters at this point.  C               ________________________Note ________________________U  <               You will not see this message if this is a new)               installation of DECwindows.   C               _____________________________________________________e  	      2-18            H                       Using the POLYCENTER Software Installation UtilityH                              2.5 Adjusting Parameters After Installation  F               When DECwindows Motif Version 1.2-5 for OpenVMS attemptsD               to start after successful installation, you will see a/               message similar to the following:p    X         %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000I         %DECW-W-BADVALUE, Free GBLPAGES is 75040 should be at least 920002S         %DECW-W_BADVALUE, SYSGEN parameter CLISYMTBL is 256, should be at least 512UQ         Some SYSGEN parameters must be reset for DECwindows to start. If you type U         YES, AUTOGEN will change these parameters and reboot your system. If you type T         NO, AUTOGEN will not be run or cause a reboot but DECwindows will not start.;         Do you want the system to run AUTOGEN for you [YES]e  G               At this point, press RETURN. The system will run AUTOGEN, B               adjust your system parameters, reboot the system and+               display the DECwindows login.                                                           H                                                                     2-19 t                     H                                                                        3H         ________________________________________________________________  H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)      C               This chapter explains how to install DECwindows MotiffD               Version 1.2-5 for OpenVMS software using the VMSINSTALC               procedure on VMS Version 5.5-2 systems. Included is a E               step-by-step description of the installation procedure,fD               information about error recovery, and instructions for*               accessing the release notes.  F                 ________________________Note  ________________________  <                 The VMSINSTAL installation procedure is onlyA                 provided for VMS Version 5.5-2 systems and shouldn>                 not be used on OpenVMS Version 6.2 and OpenVMS@                 Version 7.1 systems. Use the POLYCENTER SoftwareC                 Installation utility to install DECwindows Motif one5                 these OpenVMS systems; see Chapter 2..  E                 _____________________________________________________   A               Using the VMSINSTAL procedure, the DECwindows MotifrH               Version 1.2-5 for OpenVMS installation takes approximatelyH               45 minutes, depending on the processor type. The VMSINSTALG               procedure installs the DECwindows Motif Version 1.2-5 fori2               OpenVMS product on your system disk.  F                 ________________________Note  ________________________  @                 A Product Authorization Key (PAK) for DECwindowsB                 Motif Version 1.2-5 for OpenVMS must be registered?                 and loaded before starting the DECwindows Motifs7                 Version 1.2-5 for OpenVMS installation.   E                 _____________________________________________________s      H                                                                      3-1 I  a      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)t    C               ______________________ Caution ______________________t  ;               If you do not have a satisfactory backup copya<               of your system disk, do not attempt to installB               DECwindows Motif Version 1.2-5 for OpenVMS software.B               Back up the system disk (as described in the OpenVMS>               upgrade and installation supplement for your VAX<               processor) before you install DECwindows Motif1               Version 1.2-5 for OpenVMS software.a  :               Before beginning the installation procedure,A               review Chapter 1 for information about installation ,               preparations and requirements.  C               _____________________________________________________w  @            This chapter presents information about the following            topics:  >            o  Section 3.1, Installation Procedure Requirements  1            o  Section 3.2, Installation Procedureh  1            o  Section 3.3, Recovering from Errorsf  6            o  Section 3.4, Accessing the Release Notes  ,      3.1 Installation Procedure Requirements  A            This section discusses the requirements for installingo>            your DECwindows Motif Version 1.2-5 for OpenVMS VAX?            software using the VMSINSTAL installation procedure.   ?            Refer to Section 1.8 for information on requirementsp;            common to both VMSINSTAL and PCSI installations.   <            Prepare to install DECwindows Motif Version 1.2-5=            for OpenVMS software by logging in to a privileged D            account, such as the system manager (SYSTEM) account. SeeB            Section 3.1.1 for the prerequisite privileges. AlthoughA            Compaq prefers that you perform the installation using C            the operator console or other hardcopy terminal, you can :            perform the installation from a DECterm window.          3-2 R  i      H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                  3.1 Installation Procedure Requirements  &               3.1.1 Process Privileges  C               To install DECwindows Motif Version 1.2-5 for OpenVMS H               software, you must be logged in to an account that has the;               SETPRV privilege or the following privileges:n                 o  CMKRNLn                 o  WORLD                 o  SYSPRVE  G               The installation procedures turn off the BYPASS privilege G               at the start of the installation and turn it back on when4,               the installation is completed.  5               3.1.2 Using an Alternate Working Device   C               You can use the alternate working device (AWD) optionlD               to specify another disk to temporarily store the filesE               while they are being unpacked from the save sets on the F               distribution media. Once the save sets are unpacked, theH               installation procedure adds or replaces the files that areH               necessary for the installation of DECwindows Motif VersionC               1.2-5 for OpenVMS software from the AWD to the systemt               disk.   G               If this installation is to upgrade an existing DECwindows B               Motif environment, then the AWD option allows you toC               perform an installation with fewer free blocks on theo6               system disk than are otherwise required.  D               The installation procedure creates a temporary workingE               directory either on the AWD device or by default in thea!               following location:E  +               SYS$SYSROOT:[SYSUPD.facunvvv]a  E               If you use the AWD option, you can specify a directory.nC               Specifying a directory is optional, but the following                guidelines apply:   G               o  If you specify an existing directory, the installationrH                  procedure creates a working directory as a subdirectoryD                  within the directory that you specify (for example,E                  [WORK.facunvvv]). The installation procedure deletesaC                  the working subdirectory after the installation ise                  completed.   H                                                                      3-3 i  S      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)o,      3.1 Installation Procedure Requirements  A            o  If you do not specify a directory, the installationaD               procedure creates a working directory on the specifiedB               device with a directory specification of [000000.fa-E               cunvvv]. The installation procedure deletes the working <               directory after the installation is completed.  A            o  If you specify a nonexistent directory, the instal- C               lation procedure creates both the specified directory B               and a working directory as subdirectories within theD               directory that you specify. The installation procedure<               deletes only the working directory and not theC               originally specified directory after the installationkC               is completed. You must delete the specified directoryo               manually.d  E            Use the following format to invoke the VMSINSTAL procedureg&            and specify the AWD option:  I            $ @SYS$UPDATE:VMSINSTAL facunvvv dkcu OPTIONS N,AWD=ddcu:[dir]8  A            Use the following definitions for the variables in thet            command line:  ?            o  For facunvvv, supply the product name and versionS               number.e  @               For the DECwindows Motif Version 1.2-5 for OpenVMSE               installation, the value of facunvvv is DWMOTIFVAXU5012.n  E            o  For dkcu, give the device name of the source drive thata+               holds the distribution media.i  E            o  For ddcu, give the device name of the alternate workingr               device.   ?            o  For dir, specify the name of the directory on theaE               alternate working device where the product subdirectory[7               will be created. The default is [000000].a  E            For example, to install the DECwindows Motif Version 1.2-5 D            for OpenVMS product from the compact disc onto an OpenVMSA            VAX system using DKA2 as the alternate working device,k'            enter the following command:e  A            $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012 source-drive -l!            _$ OPTIONS N,AWD=DKA2:n        3-4 h         H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                  3.1 Installation Procedure Requirements  6               3.1.3 Using the Distributed File Service  E               You can specify a temporary working directory on a disku;               that uses the Distributed File Service (DFS).   E               If you use a DFS-mounted disk as your alternate working D               device, the installation procedure erroneously reportsD               that there are -1 free blocks on the alternate workingC               device. This error occurs because the DFS client (the H               installation procedure, in this case) cannot determine the@               amount of free disk space on the DFS-mounted disk.  E               Before using a DFS-mounted disk, manually determine itstH               free disk space. Log in to the system on which the disk isD               mounted, and enter the SHOW DEVICE command as follows:                 $ SHOW DEVICE   "         3.2 Installation Procedure  D               The DECwindows Motif Version 1.2-5 for OpenVMS instal-D               lation procedure consists of a series of questions andH               informational messages. Enter a question mark (?) for helpG               at any time during the installation. See Appendix B for afE               sample VMSINSTAL installation of DECwindows Motif on ang!               OpenVMS VAX system.p  D               To stop the installation procedure, press Ctrl/Y. WhenF               you press Ctrl/Y, the installation procedure deletes allD               files created up to that point and then exits. You can,               then restart the installation.  F                 ________________________Note  ________________________  /                 This option is not recommended.3  E                 _____________________________________________________   ,               3.2.1 Product and Device Names  D               During the installation, you must tell the system whatE               product is being installed and which drive contains thevF               distribution media. Refer to a product with its facilityF               name and version; refer to a drive with its device name.B               Use the following format to enter product and device               names:  H                                                                      3-5    d      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)o      3.2 Installation Proceduret              o  facunvvv  D               Represents the facility name and version number of theE               product being installed, also known as the installation2>               name. The following table explains the format of               facunvvv.   E               _______________________________________________________ E               Variable__Definition___________________________________o  ?               fac       Product name code (1 to 36 alphanumeric4#                         characters)   :               u         Update character "u" (1 character)  7               n         Update version number (1 digit)   E               vvv_______Major_version_number_(3_digits)______________h  D               For the DECwindows Motif Version 1.2-5 for OpenVMS in-D               stallation, use the installation name DWMOTIFVAXU5012.              o  ddcu  @               Specifies the device name of the source drive that+               holds the distribution media.o  @            For additional information about device names on yourB            system, see the upgrade and installation supplement for            your VAX processor.  2            3.2.2  Invoking the VMSINSTAL Procedure  B            To start the installation, invoke the VMSINSTAL commandB            procedure from a privileged account, such as the SYSTEM<            account. The VMSINSTAL.COM file is located in the             SYS$UPDATE directory.  A            When the system prompts you with a question during theiE            installation procedure, the default answer is often listed             in brackets ([]).  E            Perform the following steps to run the VMSINSTAL procedurefA            and install DECwindows Motif Version 1.2-5 for OpenVMSl            software:  C            1. Locate the DECwindows Motif Version 1.2-5 for OpenVMSS!               distribution media.         3-6           H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  D               2. If your system is not already running, start up theG                  system and log in to a privileged account, such as thei1                  system manager (SYSTEM) account.m  B               3. Place the distribution media in the source drive.C                  If your DECwindows Motif Version 1.2-5 for OpenVMSnF                  distribution kit contains more than one volume, placeG                  the first volume in the drive. During the installation A                  procedure, you will be prompted to load the next C                  volume. The paper labels on the media indicate the .                  order in which you load them.  D               4. Start the VMSINSTAL procedure. On the command line,G                  specify the product name (that is, the facility name):v9                  DWMOTIFVAXU5012 for OpenVMS VAX systems.a  ?                  Specify OPTIONS N to access the release notes,tE                  which are included in your media kit. The DECwindows E                  Motif Version 1.2-5 for OpenVMS Release Notes can befE                  displayed or printed before the installation begins.l?                  Enter the following command at the DCL prompt:l  H                  $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012 ddcu: OPTIONS N  F                  For ddcu, specify the device name of the source driveE                  that holds the distribution media. See Section 3.2.1eA                  for more information about the format of productmD                  and device names. Also, see the OpenVMS upgrade and@                  installation supplement for your VAX processor.  E                  For example, if you install DECwindows Motif Version D                  1.2-5 for OpenVMS from a magnetic tape cartridge inG                  drive MUA0:, enter the following command to invoke the -                  VMSINSTAL command procedure:   H                  $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012 MUA0: OPTIONS N  B                  If you install DECwindows Motif Version 1.2-5 forA                  OpenVMS using the alternate working device (AWD) H                  option described in Section 3.1.2, invoke the VMSINSTAL.                  command procedure as follows:  V                 $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012 ddcu: OPTIONS N,AWD=ddcu:[dir]    H                                                                      3-7 o  S      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)       3.2 Installation Proceduree  B               The first instance of ddcu is the device name of theA               source drive that holds the distribution media. Ther?               second instance of ddcu is the device name of the B               AWD, which is the target device. The variable dir is@               the name of the directory on the alternate workingB               device in which the product subdirectory is created.0               The default directory is [000000].  A               For example, if you are installing DECwindows Motif <               Version 1.2-5 for OpenVMS from a magnetic tapeE               cartridge in drive MUA0: using alternate working device_@               DUA2: and directory [INSTALL], enter the following               command:  W              $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012 MUA0: OPTIONS N,AWD=DUA2:[INSTALL]w  ?               If the command to execute the VMSINSTAL procedureeD               fails, check to see if any of the following conditions               occurred:   D               o  You entered the product name incorrectly. VMSINSTAL0                  displays the following message:  L              %VMSINSTAL-E-NOPRODS, None of the specified products were found  ?               o  You specified an incorrect name for the sourceMD                  drive. VMSINSTAL displays an "invalid device" errorD                  message and prompts you until you enter the name ofD                  a source device that exists on the system. Remember=                  to enter a colon (:)  after the device name.y  C            The VMSINSTAL procedure displays messages similar to the;            following:   I                    VAX/VMS Software Product Installation Procedure V5.5-2   '              It is 26-MAR-1998 at 08:02C  <              Enter a question mark (?) at any time for help.  *            3.2.3  Confirming System Backup  ?            The VMSINSTAL procedure asks the following question:   I            * Are you satisfied with the backup of your system disk [Yes]?n  C            If you made a backup copy of your system disk, press the_3            Return key and proceed to Section 3.2.4.         3-8 r  t      H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  F               If you did not make a backup copy of the system disk, do               the following:  A               1. Enter No and press the Return key. The VMSINSTAL >                  procedure exits and returns you to DCL level.  D               2. Back up the system disk as described in the OpenVMSA                  upgrade and installation supplement for your VAX                   processor.a  A               3. After you make a backup copy of the system disk, B                  restart the installation procedure from step 4 in                  Section 3.2.2.   /               3.2.4 Mounting Distribution MediaS  G               The VMSINSTAL procedure asks you where you will mount the #               distribution volumes:w  ?               * Where will the distribution volumes be mounted:   H               Enter the directory specification in the following format:  %               device-name:[directory]a  C               Then the procedure tells you to enter the name of the =               product (facility name); enter DWMOTIFVAXU5012.   K               Enter the names of the product to be processed from the first &               distribution volume set.(               * Product: DWMOTIFVAXU5012  C               When the installation begins, the VMSINSTAL procedurevC               displays informational text similar to the following:e  7               The following products will be processed:                    DWMOTIFVAX V1.2-5  K                 Beginning installation of DWMOTIFVAXU5 Version 1.2 at 10:36r  D               %VMSINSTAL-I-RESTORE, Restoring product save set  A...      H                                                                      3-9    c      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)a      3.2 Installation Procedurer  1            3.2.5  Choosing a Release Notes Optiong  C            If you specify OPTIONS N during step 4 in Section 3.2.2,YB            the VMSINSTAL procedure prompts you to select a release            notes option:  N            Release notes included with this kit are always copied to SYS$HELP.  0                Additional Release Notes Options:  (                1.  Display release notes&                2.  Print release notes                3.  Both 1 and 2I$                4.  None of the above              * Select option [2]:   3            Enter the number of the option you want:   B            o  Option 1 displays the release notes on the terminal.  :            o  Option 2 prints the release notes (default).  =            o  Option 3 displays and prints the release notes.i  C            o  Option 4 allows you to continue with the installation @               if you do not want to display or print the release               notes.  C               ________________________Note ________________________n  ?               Compaq recommends that you read the release notesn1               before continuing the installation.r  C               _____________________________________________________   C            If you choose option 1, the release notes display on theiA            terminal. You are prompted to press Return to continuemD            reading the release notes. If you want to end the displayA            and continue the installation, press Ctrl/C. After you C            press Ctrl/C, you are asked whether you want to continuelC            with the installation; you are informed that the releaseo-            notes have been moved to SYS$HELP.   C               ______________________ Caution ______________________g  >               Do not press Ctrl/Y; if you do, the installation               ends.   C               _____________________________________________________   	      3-10d    n      H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  H               If you choose option 2 or 3, you are prompted for the nameF               of the print queue. If you do not specify a print queue,C               the release notes are queued to SYS$PRINT by default.i  /               3.2.6 Continuing the Installationa  H               After the VMSINSTAL procedure processes your release notes9               option, the following message is displayed:o  >               * Do you want to continue the installation [No]?  F               If you want to continue with the installation, enter YesD               and press Return. If you want to end the installation,#               press the Return key.   D               Regardless of the release notes option you select, theA               VMSINSTAL procedure copies the release notes to theeG               SYS$HELP directory. See Section 3.4 for information about E               how to access the release notes once they are copied to %               the SYS$HELP directory.   [                 %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   R                       *** Installing DECwindows Motif for OpenVMS VAX software ***  Z                   Copyright Digital Equipment Corporation 1988, 1998. All rights reserved.  [                   Restricted Rights: Use, duplication, or disclosure by the U.S. Government W                   is subject to restrictions as set forth in subparagraph (c)(1)(ii) of Y                   DFARS  252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III,o!                   as  applicable.n  Z                   This software is proprietary to and embodies the confidential technologyW                   of Digital Equipment Corporation. Possession, use, or copying of this [                   software and media is authorized only pursuant to a valid written licenseY<                   from DIGITAL or an authorized sublicensor.  F               3.2.7 Preserving the OSF/Motif Release 1.1.3 Programming               Environment   F               If DECwindows Motif is already installed on your system,D               the OSF/Motif Release 1.1.3 programming environment isB               incompatible with DECwindows Motif Version 1.2-5 forD               OpenVMS software. (Note that the OSF/Motif Release 1.2G               programming environment is overwritten with the OSF/Motif C               Release 1.2.3 Toolkit when you install the DECwindows 8               Motif Version 1.2-5 for OpenVMS software.)  H                                                                     3-11 u  s      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)]      3.2 Installation Procedurei  >            The installation procedure asks whether you want to;            preserve the OSF/Motif Release 1.1.3 programmingX            environment:   P                The DECwindows Motif programming environment was installed with aW                previous version of this kit.  This environment is incompatible with thenW                OSF/Motif Release 1.2 environment provided with DECwindows Motif Version5M                1.2-5. The XUI programming environment is also not included inm.                DECwindows Motif Version 1.2-5.  Q                If you intend to continue developing programs for XUI or OSF/MotifsS                Release 1.1.3 you should save this environment.  Please refer to theyU                installation guide for more details and information on accessing thesea+                files in their new location.   O                If you do not choose to save the XUI and OSF/Motif Release 1.1.3hS                programming environment, those files will be removed from the systemn                disk.  F              * Do you want to save the OSF/Motif Release 1.1.3 and XUI.              * programming support files [No]?  @            If you want to preserve the XUI and OSF/Motif Release=            1.1.3 programming environment, enter Yes and presse=            the Return key. The installation procedure createsWB            subdirectories that contain the OSF/Motif Release 1.1.3E            programming files so that they can be used for programmingn            at a later time.e  E            See Section 1.6 for information about how to reference then=            previous version of the programming support files.l  +            3.2.8  Installing the Entire Kitp  D            You can install the entire DECwindows Motif Version 1.2-5C            for OpenVMS software kit, or you can install part of the B            kit. The DECwindows Motif base kit is always installed;E            the DECwindows Motif Version 1.2-5 for OpenVMS programmingd#            environment is optional.h  A            The procedure asks you whether you want to install the_            entire kit:      	      3-12            H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  T                   You can install the DECwindows Motif kit completely or in selectedW                   portions.  A complete installation requires as many as 82,500 blocks.dQ                   If you choose to perform a partial installation, you can selectaU                   (tailor) the programming support files that support your DECwindowsn[                   Motif application development.  Whether you perform a complete or partial V                   installation, this kit provides support for running DECwindows Motif:                   applications on OpenVMS compute servers.  >                 * Do you want to install the entire kit [Yes]?  E               If you want to install the entire kit, press the ReturntF               key and verify your kit selections (see Section 3.2.10).C               If you choose not to install the entire kit, enter No_F               and continue with questions about installing programming*               support (see Section 3.2.9).  6               3.2.9 Choosing Programming Support Files  A               The installation procedure asks whether you want toa*               install programming support:  S                   This installation procedure provides support files for developing(X                   DECwindows Motif applications in several programming languages.  These[                   files are needed only to develop applications and are not required to run Z                   DECwindows Motif applications.  The free disk space requirement for eachK                   programming support file ranges from 3000 to 8000 blocks.i  T                 * Do you want to install DECwindows Motif programming support [Yes]?  F               Press the Return key to install programming support. The-               following message is displayed:n  ]                   Support files are supplied for the following OpenVMS programming languages:M  '                         FORTRAN, Pascale  [                   In addition, support files are supplied for programming in the C languagewZ                   using conventions and standards developed at the Massachusetts Institute                    of Technology.  E               If you choose not to install programming support, enterrG               No and proceed to the instructions in Section 3.2.10. The E               installation procedure asks whether you want to install 3               all of the programming support files:   V                 * Do you want to install all programming language support files [Yes]?  H                                                                     3-13 e  e      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)p      3.2 Installation Procedure   >            Press the Return key if you want to install all the;            languages. If you do not want to install all thed=            languages, enter No and press the Return key. EachrB            language is then displayed. Enter Yes for each language$            that you want to install.  >            The installation procedure asks whether you want to>            install DECwindows Motif programming example files:  R              * Do you want to install DECwindows Motif programming examples [Yes]?  C            Press the Return key if you want to install the program- E            ming example files. If you enter No, the example files are             not installed.t  +            3.2.10  Verifying Kit SelectionsD  C            The components of the kit that you selected now display;TC            you can verify that these choices are correct. A messageu1            similar to the following is displayed:   ?            You have selected the following portions of the kit:   J                    o  DECwindows Motif Applications and Run-time Libraries  ;                    o  DECwindows Motif programming examples   :                    o  DECwindows Motif programming support  %                       FORTRAN, Pascale<                       MIT C language programming conventions  G                    o  OSF/Motif Release 1.1.3 and XUI saved programmingm                       supportc  0            * Are these selections correct [Yes]?  B            Press the Return key if the choices are correct. If youA            want to change your selections, enter No and press theCA            Return key. You are prompted by the previous questionsa<            again, beginning with whether you want to install?            the entire kit (see Section 3.2.8). After you repeatc>            the selection procedure and are satisfied with your:            selections, enter Yes and press the Return key.  	      3-14o M  f      H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  )               3.2.11 Verifying Disk Space   H               The installation procedure checks whether your system disk:               contains a sufficient number of free blocks.  H               1. If the blocks are available, the installation continues&                  (see Section 3.2.12).  C               2. If you do not have sufficient system disk space tooA                  install the portions you chose, the installationo=                  displays a message similar to the following:   A                  Your system disk has only 25364 free blocks, andaI                  you have selected to install approximately 76050 blocks.n  >                                            * * * N O T E * * *  V                  The installation procedure has determined that you do not have enoughV                  disk space to complete the installation.  However, it may be possibleU                  to continue successfully if you are installing DECwindows Motif on arD                  system that already has DECwindows Motif installed.  Y                * Do you want to reselect which DECwindows Motif options to install [Yes]?:  B                  If you press the Return key, you can reselect theH                  DECwindows Motif options beginning with those describedF                  in Section 3.2.8. If you enter No, the procedure asks?                  whether you want to continue the installation:   I                  * Do you want to continue the installation anyway [Yes]?   E                 ______________________ Caution ______________________   =                 If you press the Return key, the installation ?                 continues. However, if you exceed the amount ofp=                 available disk space, the installation fails.c  E                 _____________________________________________________   E                  If you enter No, the installation ends. You can thendE                  either free up blocks on the system disk and restart G                  the installation or start the installation again using C                  the AWD option. (See Section 3.1.2 for informationk-                  about using the AWD option.)   E               3. If you specify an alternate working device that doesoG                  not have sufficient disk space to install the portionsoE                  you have chosen, the installation displays a messages*                  similar to the following:  H                                                                     3-15 s         ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)       3.2 Installation Proceduren  M              Your specified alternate working directory device has only 68977sX              free blocks, and this installation will require approximately 76050 blocks.  U              You should either reselect which DECwindows Motif options to install, or W              restart this installation using an alternate working directory device withg              more free blocks.  3                              *  *  *  NOTE  *  *  *   V              Although the installation procedure estimates you do not have enough diskO              space to complete the installation, it may be possible to continue R              successfully if you are installing DECwindows Motif on a system which.              already has DECwindows installed.  U            * Do you want to reselect which DECwindows Motif options to install [Yes]?   ?               If you press the Return key, you can reselect thegE               DECwindows Motif options beginning with those describednC               in Section 3.2.8. If you enter No, the procedure asksd<               whether you want to continue the installation:  F               * Do you want to continue the installation anyway [Yes]?  ;               If you press the Return key, the installationA               continues.  C               ______________________ Caution ______________________p  <               If you lack sufficient free disk space for in-=               stallation on the alternate working device, the *               installation procedure ends.  C               _____________________________________________________   ?               If you enter No, the installation procedure ends. C               Restart the installation once you set up an alternate =               working device with sufficient disk space. (See-@               Section 3.1.2 for more information about using the               AWD option.)            	      3-16  c         H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  3               3.2.12 Verifying License RegistrationS  G               The installation procedure continues and displays license 3               information similar to the following:t  S                   A registered and loaded product authorization key for DW-MOTIF is V                   required to run any DECwindows Motif for OpenVMS application. If youZ                   answer No to the next question, the installation of DECwindows Motif for-                   OpenVMS will be terminated.   .                         Product:      DW-MOTIF)                         Producer:     DEC                           Version:%                         Release Date:t  U                 * Does this product have an authorization key registered and loaded ?_  H               Note that the NET-APP-SUP-250 and NET-APP-SUP-300 PAKs areE               also valid. Enter Yes to continue with the installationaD               if your authorization key is registered and loaded. IfF               you enter No, the following message is displayed and the                installation ends:  M               Installation of DECwindows Motif cannot continue because you do A               not have a registered and loaded authorization key.a  G               See Section 1.1 for more information about license regis-hE               tration. After you register and load your authorizationoA               key, restart the DECwindows Motif Version 1.2-5 forPH               OpenVMS installation beginning at step 4 in Section 3.2.2.  /               3.2.13 Performing a System Rebooth  B               The installation procedure suggests that you performB               a system reboot to ensure successful installation ofB               DECwindows Motif Version 1.2-5 for OpenVMS software:  S                   DECwindows Motif will not start if your system parameters are not                    correct.  S                   o If you allow a system shutdown, the installation procedure will U                     reboot the system at the end of the installation.  If your systemuU                     parameters are incorrect, the installation will run AUTOGEN priorI)                     to the system reboot.s  H                                                                     3-17    y      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)w      3.2 Installation Proceduret  R                o If you do not allow a system shutdown, the installation procedureJ                  will continue, and you will be informed at the end of theR                  installation whether you need to modify your system parameters in1                  order to start DECwindows Motif.   N                To complete the installation of this product, you should rebootP                the system.  If it is not convenient to reboot at this time, then2                enter No to the following question.  I                If you enter No, the installation procedure will continue.d  T              * Will you allow a system reboot after this product is installed [Yes]?  A            If you entered No to the shutdown question, no furthert            questions are asked.o  <            If you answered Yes to the shutdown question, theE            VMSINSTAL procedure displays the following questions about             the shutdown:  6            * How many minutes for system shutdown [0]?@            * Do you want to do an automatic system reboot [Yes]?  0              No further questions will be asked.  C               ______________________ Caution ______________________i  A               To avoid confusion with file versions when activat- @               ing an image or application, perform the necessary@               procedures to restart the DECwindows Motif Version@               1.2-5 for OpenVMS software as indicated during the-               installation in Section 3.2.15.w  C               _____________________________________________________i  1            3.2.14  Reading Informational Messages   A            The VMSINSTAL procedure lists the directories that are E            created and the save sets that are restored. The VMSINSTAL C            procedure prints out a message indicating that the files 5            will be moved to their target directories.w  ?            o  If you perform the installation using media other A               than 9-track magnetic tape, messages similar to the1                following display:  	      3-18u (         H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  O                 %VMSINSTAL-I-SYSDIR, This product creates system disk directoryd1                 VMI$ROOT:[DECW$INCLUDE.DECW$113].hO                 %VMSINSTAL-I-SYSDIR, This product creates system disk directorye+                 VMI$ROOT:[SYSEXE.DECW$113].1O                 %VMSINSTAL-I-SYSDIR, This product creates system disk directory +                 VMI$ROOT:[SYSLIB.DECW$113].dF                 %VMSINSTAL-I_RESTORE, Restoring product save set B ...F                 %VMSINSTAL-I_RESTORE, Restoring product save set C ...F                 %VMSINSTAL-I_RESTORE, Restoring product save set D ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set E ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set F ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set G ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set H ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set I ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set J ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set L ...^                 %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  G               o  If you perform the installation using 9-track magnetictA                  tape, some of the files are compressed into textiG                  libraries. The installation procedure informs you that E                  the data is being decompressed and displays messagese*                  similar to the following:  F                 %VMSINSTAL-I_RESTORE, Restoring product save set B ...F                 %VMSINSTAL-I_RESTORE, Restoring product save set C ...F                 %VMSINSTAL-I_RESTORE, Restoring product save set D ...F                 %VMSINSTAL-I_RESTORE, Restoring product save set E ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set F ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set G ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set H ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set I ....                 Decompressing H_E_DECW$INCLUDE(                 Decompressing H_E_SYSLIBF                 %VMSINSTAL-I_RESTORE, Restoring product save set J ...F                 %VMSINSTAL-I-RESTORE, Restoring product save set L ...^                 %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  @               The installation procedure then informs you that aE               spurious error message will be displayed, which you canp               safely ignore:        H                                                                     3-19 e  u      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)o      3.2 Installation Procedure   =            You can ignore the following NCP error message(s).   #            %NCP-I-SUCCESS,  Successt            Object = X$X02            %NML-I-RECDELET, Database entry deleted  A            The installation procedure then reminds you to installeB            the language variant product after the installation, if            necessary.g  Z                If you wish to use any language other than English, install the appropriateL                DECwindows Motif Version 1.2-5 language variant product after/                this installation has completed.   @            You are notified that you should run the Installation>            Verification Procedure (IVP) after the installation@            is completed and after you start the DECwindows Motif@            software. (See Section 4.2 for more information about            running the IVP.)  T                The Installation Verification Procedure (IVP) should be run after theW                installation has been completed and DECwindows Motif has been restarted.o=                The IVP can be found in SYS$TEST:DECW$IVP.COM.   E            3.2.15  Using the AUTOGEN Utility to Set System Parameters   =            The installation procedure might automatically run D            AUTOGEN, depending on which type of system you are using:  %            o  A nonworkstation systeme  ?               If you install DECwindows Motif Version 1.2-5 forrE               OpenVMS on a nonworkstation system (that is, an OpenVMSt?               host system), the following message is displayed:   /               This system is not a workstation. 6               It will not be necessary to run AUTOGEN.  =            o  A workstation system that runs DECwindows Motif D               Version 1.2-5 for OpenVMS software with correct system               parameters  ?               If you install DECwindows Motif Version 1.2-5 forl=               OpenVMS on a workstation system and your system >               parameters are correct, the following message is               displayed:  	      3-20e M  e      H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  [                   The installation procedure has determined that your system parameters are Z                   set correctly and that it will not be necessary to run AUTOGEN or reboot                   the system.a  X                   If your system is already running DECwindows Motif, restart DECwindows7                   Motif with the following DCL command:E  :                        $ @SYS$MANAGER:DECW$STARTUP RESTART  Z                   If your system is NOT already running DECwindows Motif, start DECwindows7                   Motif with the following DCL command:t  2                        $ @SYS$MANAGER:DECW$STARTUP  ?                                             * * * N O T E * * *   [                   If you are installing DECwindows Motif from your workstation console, log L                   off after you enter the command to start DECwindows Motif.  H               o  A workstation system that runs DECwindows Motif VersionA                  1.2-5 for OpenVMS software with incorrect systemi                  parameters   B                  If you install DECwindows Motif Version 1.2-5 for@                  OpenVMS on a workstation system and your systemC                  parameters need to be reset, the following message                   is displayed:  W                   The installation of DECwindows Motif has determined that some of yourtU                   system parameter values will require modification in order to startiU                   DECwindows Motif Version 1.2-5 for OpenVMS.  To set your parametersuI                   correctly, run AUTOGEN using the following DCL command:   K                         $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACKl  P                   This will adjust your system parameters and reboot the system.  H               o  A workstation system that runs DECwindows Motif VersionH                  1.2-5 for OpenVMS with incorrect system parameters, and6                  you answered Yes to a system shutdown  R                   The OpenVMS AUTOGEN procedure will now be run to set your systemU                   parameters. After that, your system will be automatically rebooted.   T                   After the system has been rebooted, successful installation of theQ                   workstation software will be indicated by the appearance of the '                   Start Session window.t  H                                                                     3-21 i  a      ;      Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)2      3.2 Installation Procedure   :              %AUTOGEN-I-BEGIN, GETDATA phase is beginning.              .              .              .<              %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning.              .              .              .;              %AUTOGEN-I-BEGIN, GENFILES phase is beginning.H              .              .              .<              %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning.              .              .              .  H                     Installation of DWMOTIFVAXU5 V1.2 completed at 10:57  V              %VMSINSTAL-I-SHUTDOWN, This product requires that the system be rebooted.  C                      SHUTDOWN -- Perform an Orderly System Shutdowni/                                  on node NODE01e              .              .              .  8            3.2.16  Completing the Installation Procedure  C            When the installation is completed, a message similar ton&            the following is displayed:  ?            Installation of DWMOTIFVAXU5 V1.2 completed at 10:57f  ,            VMSINSTAL procedure done at 12:45  B            These messages indicate that the installation procedure"            completed successfully.  =            Your system automatically shuts down if AUTOGEN is_A            run; you must then reboot your system. See the upgradehA            and installation supplement for your VAX processor for 5            instructions on how to reboot your system.     	      3-22o r  a      H                   Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)H                                               3.2 Installation Procedure  F                 ________________________Note  ________________________  C                 If you upgrade your system with a higher version of D                 OpenVMS at a later time, you might need to reinstall>                 the DECwindows Motif Version 1.2-5 for OpenVMS                 software.   E                 _____________________________________________________e  "         3.3 Recovering from Errors  D               Errors can occur during the installation if any of the)               following conditions exist:   <               o  Incorrect OpenVMS operating system version.  %               o  Insufficient quotas.o  ;               o  Insufficient values for system parameters.o  :               o  OpenVMS help library is currently in use.  >               o  Product license is not registered and loaded.  G               For descriptions of the error messages generated by thesegD               conditions, see the documents listed in the AssociatedH               Documents section in the Preface. These documents may helpG               you diagnose errors and decide what corrective actions to                take.   '         3.4 Accessing the Release Notes   E               During the installation, the VMSINSTAL procedure copiess               the F               DECwindows Motif Version 1.2-5 for OpenVMS Release NotesA               to the SYS$HELP:DECW$MOTIFU5012.RELEASE_NOTES file. C               Once you return to DCL level, you can print this file E               or display it at a terminal. Refer to Section 3.2.5 for A               more information about accessing the release notes.             H                                                                     3-23                       H                                                                        4H         ________________________________________________________________  H                                            After Installing the Software      G               This chapter discusses the tasks that you need to performyB               after the DECwindows Motif Version 1.2-5 for OpenVMS(               installation is completed:  D               o  Section 4.1, Starting the DECwindows Motif Software  -               o  Section 4.2, Running the IVPa  =               o  Section 4.3, Choosing an Alternative Console   @               o  Section 4.4, Selecting the Desktop (Alpha Only)  F               If the DW-MOTIF license that is installed on your system@               is not valid, appropriate messages display on yourH               console terminal and DECwindows Motif is not automaticallyF               started. If this situation occurs, log in to the system,H               install the valid license, and start your DECwindows MotifG               software. For complete information on installing licensesVC               using LMF, see the OpenVMS License Management Utilityi               Manual.   2         4.1 Starting the DECwindows Motif Software  G               If you perform a system reboot following the installation E               of DECwindows Motif for OpenVMS, the DECwindows startup F               procedure runs automatically when the system reboots. OnH               OpenVMS Alpha systems, either the New Desktop login dialogD               box or the DECwindows desktop Start Session dialog boxE               is displayed, depending on the value of the DECW$START_ B               NEW_DESKTOP global symbol. (See Section 4.4 for moreD               information.) On OpenVMS VAX systems the Start SessionD               dialog box is displayed. Proceed to Section 4.2 if youE               allowed a system reboot and DECwindows has successfully                started.  H                                                                      4-1 s         "      After Installing the Software/      4.1 Starting the DECwindows Motif Softwarer  B            If you chose not to reboot the system after the instal-A            lation, you must start or restart the DECwindows Motif C            software by running the DECwindows startup procedure, aspB            described in the following paragraphs. When the startup?            procedure has successfully completed, either the NewfC            Desktop login dialog box or the DECwindows desktop StartM?            Session dialog box is displayed, as explained in the             previous paragraph.  B            DECwindows Motif Version 1.2-5 for OpenVMS software canA            be started only if your system parameters are correct.aB            Proceed to one of the following sections if your system"            parameters are correct:  /            o  Section 4.1.1, Standalone Systems   /            o  Section 4.1.2, VMScluster Systems   E            If your system parameters are not correct, then use one of(<            the following methods to adjust them accordingly:  )            o  Invoke the AUTOGEN utility:   A               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK   A            o  Attempt to start the DECwindows Motif software. ThetC               DECwindows Motif startup procedure checks your system E               parameters. If they are too low, the procedure displayseA               a series of messages describing the required systeme?               parameters. These same parameters are adjusted in A               the system's MODPARAMS.DAT file. Then the procedureI!               displays following:o  B      Some SYSGEN parameters must be reset for DECwindows to start.R      If you type YES, AUTOGEN will change these parameters and reboot your system.K      If you type NO, AUTOGEN will not run or cause a reboot, but DECwindows       will not start.  A      To run AUTOGEN at a later date, enter the following command: L                          $ @SYS$UPDATE:AUTOGEN getdata reboot check_feedback9      Do you want the system to run AUTOGEN for you [Yes]?t  E            After the system is rebooted and the startup is completed,n1            the Start Session dialog box displays._  E            The DECwindows Motif Version 1.2-5 for OpenVMS software isw4            now installed and running on your system.        4-2 c  o      H                                            After Installing the SoftwareH                               4.1 Starting the DECwindows Motif Software  B               Run the Installation Verification Procedure (IVP) asF               described in Section 4.2 to verify that the installationG               of DECwindows Motif Version 1.2-5 for OpenVMS software isl$               complete and accurate.  &               4.1.1 Standalone Systems  C               Perform one of the following procedures to start youra?               DECwindows Motif software on a standalone system:r  E               o  If your system is not running DECwindows Motif, thentC                  start DECwindows Motif with the following command:h  ,                  $ @SYS$MANAGER:DECW$STARTUP  F               o  If your system is currently running DECwindows Motif,A                  then restart DECwindows Motif with the following                   command:   4                  $ @SYS$MANAGER:DECW$STARTUP RESTART  F                 ________________________Note  ________________________  >                 If your system has a workstation display, then@                 the command to restart DECwindows Motif will endB                 your current session. The Start Session dialog boxC                 displays on your terminal, and you must log back in 3                 to continue using DECwindows Motif.B  E                 _____________________________________________________.  H               The DECwindows Motif Version 1.2-5 for OpenVMS software is7               now installed and running on your system.a  H               Run the IVP as described in Section 4.2 to verify that theH               installation of DECwindows Motif Version 1.2-5 for OpenVMS'               is complete and accurate.O  &               4.1.2 VMScluster Systems  D               Starting DECwindows Motif Version 1.2-5 for OpenVMS onB               nonsatellite and satellite nodes is described in the#               sections that follow.     H                                                                      4-3 i  n      "      After Installing the Software/      4.1 Starting the DECwindows Motif Softwarei  7            4.1.2.1 Starting Nonsatellite and Boot Nodest  >            To start DECwindows Motif Version 1.2-5 for OpenVMSA            software on each of the nonsatellite nodes within yourt?            VMScluster, perform one of the following procedures:s  B            o  If your system is not running DECwindows Motif, then@               start DECwindows Motif with the following command:  )               $ @SYS$MANAGER:DECW$STARTUP   C            o  If your system is currently running DECwindows Motif, >               then restart DECwindows Motif with the following               command:  1               $ @SYS$MANAGER:DECW$STARTUP RESTART   C               ________________________Note ________________________   9               If the nonsatellite node or boot node has a.>               workstation display, then the command to restartA               DECwindows Motif will end your current session. The A               Start Session dialog box displays on your terminal;E>               log in again to continue using DECwindows Motif.  C               _____________________________________________________I  E            The DECwindows Motif Version 1.2-5 for OpenVMS software is 4            now installed and running on your system.  A            Run the IVP as described in Section 4.2 to verify that E            the installation of the DECwindows Motif Version 1.2-5 for 4            OpenVMS product is complete and accurate.  +            4.1.2.2 Starting Satellite NodesM  B            To start the DECwindows Motif Version 1.2-5 for OpenVMSC            software that is installed on the boot node, perform oneCD            of the following procedures on each satellite node in theB            VMScluster that will run DECwindows Motif Version 1.2-5             for OpenVMS software:  E            o  If the node is not running DECwindows Motif, then start :               DECwindows Motif with the following command:  )               $ @SYS$MANAGER:DECW$STARTUPr        4-4           H                                            After Installing the SoftwareH                               4.1 Starting the DECwindows Motif Software  H               o  If the node is currently running DECwindows Motif, thenE                  restart DECwindows Motif with the following command:o  4                  $ @SYS$MANAGER:DECW$STARTUP RESTART  H               Once DECwindows Motif is started or restarted on each nodeD               in the VMScluster, then the installation is consideredD               complete. Now run the IVP as described in Section 4.2.           4.2 Running the IVPI  C               Run the IVP, SYS$TEST:DECW$IVP.COM, after you installtF               and start the DECwindows Motif Version 1.2-5 for OpenVMSG               product. This procedure contains four tests, which verifywF               that the software installation is complete and accurate.  C               First, the IVP procedure attempts to run two display-rD               oriented tests. When you invoke the IVP, it identifies$               your type of hardware.  D               o  If you are using a workstation, you are asked whereH                  the display-oriented tests should display. Your current,                  workstation is the default.  B               o  If you are not using a workstation, the procedure0                  prompts you for a display name.  F               Press Ctrl/Z at the prompt if you do not want to run theF               display-oriented tests. The IVP runs these tests only ifF               the images exist on the system. If the IVP does not findC               the images, a message displays to inform you that the $               tests will not be run.  F                 ________________________Note  ________________________  @                 If you are invoking the IVP from a LAT Xterminal?                 using LAT software, enter the following commandn                 first:  H                 $ SET DISPLAY/CREATE/NODE=LAT_nnnnnnnnnnnn/TRANSPORT=LAT  >                 Substitute your actual LAT terminal number for                 nnnnnnnnnn.t  :                 Enter the default at the _Display: prompt.  E                 _____________________________________________________e  H                                                                      4-5 e  l      "      After Installing the Software      4.2 Running the IVP  <            Next, the IVP runs two nondisplay-oriented tests.  <            o  The first of these tests invokes the Motif UILC               compiler. If you did not install programming support,e@               the IVP informs you that this test will not be runA               because the Motif UIL image does not exist. If this E               test is run, you are notified of its completion status.   C            o  The last test converts a text file to DDIF format andVC               then converts it back to text, comparing the originald@               text file with the result. If the files match, theD               test is successful. You are notified of its completion               status.w  4            Example 4-1 shows you how to run the IVP.          Example 4-1 Sample IVP   !              $ @SYS$TEST:DECW$IVP   Z                  Copyright Digital Equipment Corporation 1988, 1998.  All rights reserved.  Z                     DECwindows Motif for OpenVMS Installation Verification Procedure (IVP)  [                  This IVP is intended to test some of the functionality of DECwindows MotifdY                  for OpenVMS and to provide a quick method of verifying the installation.   U                  This machine is not a workstation.  Please provide the nodename of at[                  workstation on which to display the IVP tests.  You must be sure that this [                  account and node have security access to the display node, or the IVP wille                  fail.  Z                  To skip the display-oriented tests, press Ctrl/Z at the following prompt.  "              _Display: NODE33::0.0  E                                              (continued on next page)h                    4-6    s      H                                            After Installing the SoftwareH                                                      4.2 Running the IVP  &         Example 4-1 (Cont.) Sample IVP  @                 %DECW-I-IVP, The IVP will display on NODE33::0.0N                 %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute.<                 %DECW-I-IVP, Press Ctrl/Y to interrupt test.<                 %DCL-S-SPAWNED, process DECW$IVP_ICO spawnedN                 %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute.<                 %DECW-I-IVP, Press Ctrl/Y to interrupt test.>                 %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned?                 %DECW-I-IVP, Invoking the UIL Motif compiler...AP                 %DECW-S-IVP, The UIL Motif compiler test completed successfully.>                 %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP...9                 %DECW-S-IVP, CONVERT/DOCUMENT IVP passed. 3                 %DECW-S-IVP, The IVP has completed.m                 $a    +         4.3 Choosing an Alternative Consolen  E               The DECwindows Motif Version 1.2-5 for OpenVMS softwareeA               allows you to boot all configurations from the main5E               console. You can then toggle between displaying and notmE               displaying the operator window by pressing Ctrl/F2. Thes:               main console is always a workstation screen.  C               If you are logged in to the main console (workstationeE               screen), you must log out before DECwindows will start.c@               Issue the following command from the main console:  +                $  @SYS$MANAGER:DECW$STARTUP   G               Once the command procedure completes, log out of the main F               console. Otherwise the server will not start and a login"               box will not appear.  @               For an alternative console, you can use a terminalG               connected to the workstation by means of a terminal port.g  H               If you boot from the main console, the alternative consoleG               is connected when you invoke the DECwindows Motif startup_                command procedure.  A               If you boot the system from an alternative console,oC               you cannot start the Console Window application. Thiso<               application is described in the release notes.  H                                                                      4-7    s      "      After Installing the Software+      4.4 Selecting the Desktop (Alpha Only)r  +      4.4 Selecting the Desktop (Alpha Only)n  B            On OpenVMS Alpha systems, DECwindows Motif Version 1.2-?            5 for OpenVMS provides a choice of two desktops: the @            New Desktop, which is derived from the Common DesktopE            Environment (CDE), and the traditional DECwindows desktop.i  A            During the installation, if you choose to install bothaD            the New Desktop and the DECwindows desktop, you are asked<            which desktop you wish to be the default desktop.  >            To select the other desktop as the default desktop,'            perform the following steps.S  A            1. If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COMt=               does not exist, copy it from DECW$PRIVATE_APPS_s@               SETUP.TEMPLATE (or create it if an earlier versionD               of DECwindows Motif for OpenVMS has not been installed+               on your system). For example:   C               $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - ?               _$ SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM_  D            2. Edit SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM and add aB               symbol definition for DECW$START_NEW_DESKTOP. If youE               wish the New Desktop as the default enter the followingr'               global symbol definition:t  0               $ DECW$START_NEW_DESKTOP == "TRUE"  @               If you wish the DECwindows desktop as the default,;               enter the following global symbol definition:n  1               $ DECW$START_NEW_DESKTOP == "FALSE"a  =            3. Restart DECwindows using the following command:   1               $ @SYS$MANAGER:DECW$STARTUP RESTARTO                    4-8 e  n                  H                                                                        5H         ________________________________________________________________  H                                       Managing DECwindows Motif Software      B               This chapter contains information about managing the@               performance of your DECwindows Motif Version 1.2-5D               for OpenVMS software. It also describes how to add andA               remove DECwindows Motif files from your system diskeF               using tailoring utilities. See Managing DECwindows MotifB               for OpenVMS Systems for additional system management               information.  A               The following topics are discussed in this chapter:p  D               o  Section 5.1, Customizing the DECwindows X11 Display)                  Server Startup Procedure   F               o  Section 5.2, Using the DECW$MOTIF_TAILOR Utility (VMS$                  Version 5.5-2 Only)  B               o  Section 5.3, Adding DECwindows Base-Support Files  @               o  Section 5.4, Determining and Reporting Problems  A               After you install the DECwindows Motif Version 1.2-t@               5 for OpenVMS product, you can tune your system toG               enhance performance or to decrease the use of some system4F               resources. For information about tuning your system, see<               Managing DECwindows Motif for OpenVMS Systems.  A         5.1 Customizing the DECwindows X11 Display Server Startupt             Procedurei  D               The DECwindows X11 display server manages the graphics?               devices on your workstation, such as the display,n"               keyboard, and mouse.      H                                                                      5-1 t  D      '      Managing DECwindows Motif SoftwareaH      5.1 Customizing the DECwindows X11 Display Server Startup Procedure  C               ________________________Note ________________________   A               Start the DECwindows X11 display server on worksta-                 tion systems only.  C               _____________________________________________________   A            The startup command procedures automatically determineoB            most of the configuration parameters for the DECwindowsE            X11 display server. However, the command procedures cannot 7            determine some items, such as the following:G  :            o  Whether you have a 75-dpi or 100-dpi monitor  ?            o  Whether you have a North American keyboard layoutwC               (such as for an LK201-AA or -LA or an LK401-AA or -LAu               keyboard)   A            o  Whether the DECwindows X11 display server uses only >               DECnet for OpenVMS software and local transports  A            o  Whether the DECwindows X11 display server logs both @               successful and unsuccessful connect and disconnect:               messages to the DECW$SERVER_n_ERROR.LOG file  E            To ensure that the DECwindows X11 display server is set upO@            correctly, modify the server startup file as follows:  ?            1. Make a copy of the file SYS$MANAGER:DECW$PRIVATE_ N               SERVER_SETUP.TEMPLATE and rename it to SYS$MANAGER:DECW$PRIVATE_E               SERVER_SETUP.COM. This server startup file shows how tobC               customize individual workstations by adding a sectionu3               of DCL commands for each workstation.n  A               You can add setup options in either of two sections @               in the server startup file. Setup options added toB               the "Cluster Common or Standalone Workstation Setup"B               section affect all nodes in a cluster. Setup options?               added to the "Cluster Member Workstation-Specific A               Setup" section affect only individual nodes. If youhE               add a workstation-specific option, you must also update %               the variable node_list.l  @            2. If your screen supports 100 dots-per-inch, add the               following line:p  ,               $ DECW$SERVER_DENSITY == "100"        5-2           H                                       Managing DECwindows Motif SoftwareH      5.1 Customizing the DECwindows X11 Display Server Startup Procedure  B                  Add this line to the section for each workstationC                  that has a 100 dots-per-inch monitor, or add it to D                  the common section for all workstations (if all the5                  workstations have 100-dpi monitors).   E               3. If you want the server to log successful connect and =                  disconnect messages, add the following line:   4                  $ DECW$SERVER_CONNECT_LOG == "TRUE"  E               4. Add the following line to the section for monochromen"                  GPX workstations:  (                  $ DECW$COLOR == "FALSE"  G                  No modification is necessary for grayscale (intensity)p                  screens.y  G               5. Add the following line to the section for workstations A                  with keyboards that are not North American LK201_                  models:  1                  $ DECW$DEFAULT_KEYMAP == "xxxxx"s  E                  In the previous line, replace xxxxx with the correct F                  DECwindows keymap name. You can determine the correctB                  name from the model number of your LK201 or LK401G                  keyboard. Turn the keyboard upside down and look for asH                  label that specifies the model number. The model numberD                  is in a format similar to LK201-xx or LK401-xx. TheF                  model number may also be listed as LK201 or LK401. InF                  this case, the xx that you need is in another part ofH                  the label where there is a number that looks similar to                  the following:s                    nn-nnnnn-xx  G                  Use the xx part of this number to choose a keymap namewD                  from Table 5-1. Choose the keymap ending in _DP forF                  data-processing keyboard layout and the keymap ending.                  in _TW for typewriter layout.  C                  Table 5-1 is arranged according to the dialect for 1                  which each keyboard is designed.o  H                                                                      5-3 s  t      '      Managing DECwindows Motif Software H      5.1 Customizing the DECwindows X11 Display Server Startup Procedure  C               After you choose a keymap name, modify the DECwindows E               X11 display server startup file. For example, to changeoC               the keyboard layout to a Dutch typewriter layout, addoE               the following line to the DECwindows X11 display servero               startup file:   ?               $ DECW$DEFAULT_KEYBOARD_MAP == "DUTCH_LK201LH_TW"   C               Add a similar line for each workstation that does not_C               have a North American keyboard layout or add the lineoD               to the common section for all workstations (if all the9               workstations use the same keyboard layout).t  E            6. Enter the following command to restart DECwindows MotifoE               on the workstations for which you customized the server45               startup by using the following command:   1               $ @SYS$MANAGER:DECW$STARTUP RESTART   E      Table_5-1_DECwindows_Keymap_____________________________________   E      Dialect_________Model_____________DECwindows_Keymap_____________S  A      Austrian/German LK201-            AUSTRIAN_GERMAN_LK201LG_DPO"                      (AG,LG,BG,MG)  A                                        AUSTRIAN_GERMAN_LK201LG_TW   A                      LK201-(NG,PG)     AUSTRIAN_GERMAN_LK201NG_DPM  A                                        AUSTRIAN_GERMAN_LK201NG_TW   A                      LK401-(AG)        AUSTRIAN_GERMAN_LK401AG_TW   @      Belgian/French  LK201-            BELGIAN_FRENCH_LK201LP_DP"                      (AP,LP,BP,MP)  @                                        BELGIAN_FRENCH_LK201LP_TW  @      Belgian/French  LK401-(AP)        BELGIAN_FRENCH_LK401AP_DP  @                                        BELGIAN_FRENCH_LK401AP_TW  9      British         LK201-            BRITISH_LK201LE_DPt"                      (AE,LE,BE,ME)  9                                        BRITISH_LK201LE_TWo  9      British         LK401-(AA,PA)     BRITISH_LK401AA_DPh  9                                        BRITISH_LK401AA_TW   E                                              (continued on next page)         5-4 r  d      H                                       Managing DECwindows Motif SoftwareH      5.1 Customizing the DECwindows X11 Display Server Startup Procedure  H         Table_5-1_(Cont.)_DECwindows_Keymap_____________________________  H         Dialect_________Model_____________DECwindows_Keymap_____________  D         Canadian/French LK201-            CANADIAN_FRENCH_LK201LC_DP%                         (AC,LC,BC,MC)s  D                                           CANADIAN_FRENCH_LK201LC_TW  D         Canadian/French LK401-            CANADIAN_FRENCH_LK401AC_DP%                         (AC,LC,BC,MC).  D                                           CANADIAN_FRENCH_LK401AC_TW  ;         Danish          LK201-            DANISH_LK201LD_DPs%                         (AD,LD,BD,MD)i  ;                                           DANISH_LK201LD_TWm  ;                         LK201-(ED,RD,FD)  DANISH_LK201RD_DP   ;                                           DANISH_LK201RD_TW_  ;         Danish          LK401-            DANISH_LK401AD_DPi%                         (AD,LD,BD,MD)   ;                                           DANISH_LK401AD_TW   :         Dutch           LK201-            DUTCH_LK201LH_DP%                         (AH,LH,BH,MH)   :                                           DUTCH_LK201LH_TW  7                         LK201-(NH,PH)     DUTCH_LK201NH   7                         LK401-(NH,PH)     DUTCH_LK401AH_  <         Finnish         LK201-            FINNISH_LK201LF_DP%                         (AF,LF,BF,MF)   <                                           FINNISH_LK201LF_TW  <                         LK201-(NX,PX)     FINNISH_LK201NX_DP  <                                           FINNISH_LK201NX_TW  <         Finnish         LK401-            FINNISH_LK401AF_DP%                         (AF,LF,BF,MF)   <                                           FINNISH_LK401AF_TW  <         Flemish         LK201-            FLEMISH_LK201LB_DP%                         (AB,LB,BB,MB)n  <                                           FLEMISH_LK201LB_TW  H                                                 (continued on next page)  H                                                                      5-5 I  h      '      Managing DECwindows Motif SoftwaresH      5.1 Customizing the DECwindows X11 Display Server Startup Procedure  E      Table_5-1_(Cont.)_DECwindows_Keymap_____________________________l  E      Dialect_________Model_____________DECwindows_Keymap_____________t  9      Flemish         LK401-            FLEMISH_LK401AB_DPe"                      (AB,LB,BB,MB)  9                                        FLEMISH_LK401AB_TW   ;      Icelandic       LK201-            ICELANDIC_LK201LU_DPc"                      (AU,LU,BU,MU)  ;                                        ICELANDIC_LK201LU_TWy  9      Italian         LK201-            ITALIAN_LK201LI_DPt"                      (AI,LI,BI,MI)  9                                        ITALIAN_LK201LI_TWl  9      Italian         LK401-            ITALIAN_LK401AI_DP "                      (AI,LI,BI,MI)  9                                        ITALIAN_LK401AI_TWf  =      North American  LK201-            NORTH_AMERICAN_LK201LAs"                      (AA,LA,BA,MA)  =      North American  LK401-            NORTH_AMERICAN_LK401AA "                      (AA,LA,BA,MA)  ;      Norwegian       LK201-            NORWEGIAN_LK201LN_DP "                      (AN,LN,BN,MN)  ;                                        NORWEGIAN_LK201LN_TW   ;                      LK201-(EN,RN,FN)  NORWEGIAN_LK201RN_DPp  ;                                        NORWEGIAN_LK201RN_TWN  ;      Norwegian       LK401-            NORWEGIAN_LK401AN_DPI"                      (AN,LN,BN,MN)  ;                                        NORWEGIAN_LK401AN_TW   9      Portuguese      LK201-            PORTUGUESE_LK201LV "                      (AV,LV,BV,MV)  9      Portuguese      LK401-            PORTUGUESE_LK401AV,"                      (AV,LV,BV,MV)  9      Spanish         LK201-            SPANISH_LK201LS_DP "                      (AS,LS,BS,MS)  9                                        SPANISH_LK201LS_TWe  E                                              (continued on next page)-        5-6 C  E      H                                       Managing DECwindows Motif SoftwareH      5.1 Customizing the DECwindows X11 Display Server Startup Procedure  H         Table_5-1_(Cont.)_DECwindows_Keymap_____________________________  H         Dialect_________Model_____________DECwindows_Keymap_____________  <         Spanish         LK401-            SPANISH_LK401AS_DP%                         (AS,LS,BS,MS)n  <                                           SPANISH_LK401AS_TW  <         Swedish         LK201-            SWEDISH_LK201LM_DP%                         (AM,LM,BM,MM)l  <                                           SWEDISH_LK201LM_TW  <                         LK201-(NM,PM)     SWEDISH_LK201NM_DP  <                                           SWEDISH_LK201NM_TW  <         Swedish         LK401-            SWEDISH_LK401AM_DP%                         (AM,LM,BM,MM)t  <                                           SWEDISH_LK401AM_TW  A         Swiss/French    LK201-            SWISS_FRENCH_LK201LK_DP %                         (AK,LK,BK,MK)   A                                           SWISS_FRENCH_LK201LK_TWt  A         Swiss/French    LK401-            SWISS_FRENCH_LK401AK_DPe%                         (AK,LK,BK,MK)c  A                                           SWISS_FRENCH_LK401AK_TW   A         Swiss/German    LK201-            SWISS_GERMAN_LK201LL_DPt%                         (AL,LL,BL,ML)a  A                                           SWISS_GERMAN_LK201LL_TWc  A         Swiss/German    LK401-            SWISS_GERMAN_LK401AL_DP %                         (AL,LL,BL,ML)   A                                           SWISS_GERMAN_LK401AL_TWl  4         Combined US/UK  LK201-(EE,RE,PE)  UK_LK201RE  4                                           US_LK201RE  4         Combined US/UK  LK401-(EE,RE,PE)  UK_LK401AA  H         __________________________________US_LK401AA____________________  H                                                                      5-7 r  t      '      Managing DECwindows Motif Software E      5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)s  ?      5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2s          Only)  A            Use the DECW$MOTIF_TAILOR utility to remove DECwindows A            Motif files from the system disk (for example, support A            files for the Toolkit, applications, and programming). =            If you later decide that you want DECwindows Motif C            programming support, add the files to the system disk by C            reinstalling the system. See Section 5.3 for information             about adding files.  C               ________________________Note ________________________L  ;               Use the DECW$MOTIF_TAILOR utility only if youE<               installed the DECwindows Motif for OpenVMS kit>               using VMSINSTAL. If you installed the DECwindowsA               Motif for OpenVMS kit using the POLYCENTER SoftwareeA               Installation utility (PCSI), remove files using thetB               PCSI commands PRODUCT REMOVE or PRODUCT RECONFIGURE.@               (For more information on PCSI commands, enter HELPB               PRODUCT at the DCL prompt or refer to the POLYCENTER:               Software Installation Utility User's Guide.)  C               _____________________________________________________R  =            The DECW$MOTIF_TAILOR process includes two phases:   B            o  The first phase lists each class of DECwindows MotifA               files and asks whether you want to delete the class_#               from the system disk.   C            o  The second phase deletes the files you indicated from                the system disk.  A            Table 5-2 lists the classes (or groups) and subclassessB            of DECwindows Motif files that you can delete using theD            DECW$MOTIF_TAILOR utility. For a list of DECwindows MotifD            files and their descriptions and classes, see Appendix C.                    5-8           H                                       Managing DECwindows Motif SoftwareH         5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)  D               Table 5-2 Classes of OpenVMS Files That Can Be RemovedH               __________with_the_DECW$MOTIF_TAILOR_Utility______________  H               Class__________Subclass_______Description_________________  E               VMS            No subclasses  DECwindows Motif run-timeF4               DECwindows     in this        support.)               run-time       tailor classo               supports  @               VMS            No subclasses  DECwindows Motif CDA4               DECwindows     in this        support.)               CDA support    tailor class   @               VMS            DECwindows     The DECwindows MotifH               DECwindows     Motif          applications files provide aD               Motif          computer-      variety of applications."               applications   based(               files          instruction"                              (CBI)  >               DECwindows     No subclasses  DECwindows Motif CE               Motif C        in this        programming support files F               programming    tailor class   are needed only to developD               support files                 applications and are notF                                             required to run DECwindowsE                                             Motif applications. These B                                             files are provided for@                                             programming in the CF                                             language using conventionsF                                             and standards developed atG                                             the Massachusetts Institutec@                                             of Technology (MIT).  A               DECwindows     No subclasses  FORTRAN support fileseA               FORTRAN        in this        are provided for this A               programming    tailor class   programming language. E               support files                 The files are needed onlyOC                                             to develop applicationsw@                                             and are not requiredC                                             to run DECwindows MotifE9                                             applications.   H                                                 (continued on next page)  H                                                                      5-9 A  :      '      Managing DECwindows Motif SoftwareLE      5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)T  A            Table 5-2 (Cont.) Classes of OpenVMS Files That Can Bez?                              Removed with the DECW$MOTIF_TAILORDE            __________________Utility_________________________________p  E            Class__________Subclass_______Description_________________e  =            DECwindows     No subclasses  Pascal support filesa>            Pascal         in this        are provided for this>            programming    tailor class   programming language.B            support files                 The files are needed only@                                          to develop applications=                                          and are not requiredb@                                          to run DECwindows Motif6                                          applications.  A            DECwindows     No subclasses  DECwindows Motif example /            Motif example  in this        files.i&            files          tailor class  D            Sound editor   No subclasses  Sound-editor support files.!            support files  in this &                           tailor class  A            NCSA Mosaic    No subclasses  NCSA Mosaic web browser.c!                           in this(E            _______________tailor_class_______________________________   ?            Removing DECwindows Motif Files from the System Disk   D            To remove DECwindows Motif files from the system disk, do            the following:C  +            1. Log in to the SYSTEM account.e  <            2. Enter the following command at the DCL prompt:  0               $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR  C               After a brief overview, the DECW$MOTIF_TAILOR utilitylB               lists each group, or class, of files and its size inD               blocks. Files are grouped according to their function.D               For example, all the files required for DECwindows forC               OpenVMS device support are in one class. A file class D               is made up of many small subclasses. You can eliminateC               an entire class of files, or you can eliminate one or 2               more of its subclasses. For example:  	      5-10            H                                       Managing DECwindows Motif SoftwareH         5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)  ?                 CLASS - VMS DECwindows Motif applications files G                           Size of entire class (with subclasses): 12181 O                           Size of common files required for any subclass: 11160lP                           Do you wish to select the entire class (default = NO)?U                           Do you wish to select any of its subclasses (default = NO)?o                       .                        ..                       .   C               3. Decide which file classes or subclasses you do notyC                  need to support your system. The DECW$MOTIF_TAILOR C                  utility displays step-by-step instructions. Follow F                  these instructions to specify which of the classes or/                  subclasses you want to remove.s  D               4. The DECW$MOTIF_TAILOR utility deletes the files you>                  select and displays the names of those files.  H               You can ignore "file not found" messages in the log files;E               tailoring functions are not affected by these messages. G               The installation procedure deletes files that it does noth               read.h  E                 ______________________ Caution ______________________   <                 To cancel DECW$MOTIF_TAILOR during the first>                 phase, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If youA                 cancel DECW$MOTIF_TAILOR during the second phase,n;                 a partially tailored disk may result. For a(<                 description of both phases, see Section 5.2.  E                 _____________________________________________________w  F               Example 5-1 shows how to use DECW$MOTIF_TAILOR to remove'               files from a system disk.e  4         Example 5-1 Sample DECW$MOTIF_TAILOR Session  H                                                 (continued on next page)            H                                                                     5-11 S         '      Managing DECwindows Motif Software_E      5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)   9      Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session   '      $ RUN SYS$UPDATE:DECW$MOTIF_TAILORE	         .G	         . 	         .         TAILOR-OFF       ----------NK       You will now be prompted with a list of the classes and subclasses ofGP       DECwindows files that are optional. The size of each class and subclass isP       included in the list. This will help you decide whether or not you want to2       remove a class or subclass from your system.  Q       Under some classes there is a set of common files that is required in order_P       for any subclasses to work. These files will only be deleted if you removeP       the ENTIRE class. If you choose to keep any subclass, this set of files is       not deleted.  J       NOTE: The files associated with selected classes and subclasses will(             be removed from your system.  5      Total size of the system disk is 2050860 blocks. :      Total space used on the system disk is 684720 blocks.;      Total space left on the system disk is 1366140 blocks.o  +      CLASS - VMS DECwindows Runtime Supportp<                Size of entire class (with subclasses): 273032                No subclasses in this tailor class.N                Do you wish to select the entire class (default = NO)? <Return>  '      CLASS - VMS DECwindows CDA Support ;                Size of entire class (with subclasses): 3625 2                No subclasses in this tailor class.I                Do you wish to select the entire class (default = NO)? Yes   4      CLASS - VMS DECwindows Motif applications files<                Size of entire class (with subclasses): 12181@            Size of common files required for any subclass: 11160J            Do you wish to select the entire class (default = NO)? <Return>O            Do you wish to select any of its subclasses (default = NO)? <Return>   E                                              (continued on next page)h    	      5-12-           H                                       Managing DECwindows Motif SoftwareH         5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)  <         Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session  6         CLASS - DECwindows C programming support files>                   Size of entire class (with subclasses): 67271               No subclasses in this tailor class. L                   Do you wish to select the entire class (default = NO)? Yes  <         CLASS - DECwindows FORTRAN programming support files>                   Size of entire class (with subclasses): 24041               No subclasses in this tailor class. L                   Do you wish to select the entire class (default = NO)? Yes  ;         CLASS - DECwindows Pascal programming support files >                   Size of entire class (with subclasses): 30091               No subclasses in this tailor class.-Q                   Do you wish to select the entire class (default = NO)? <Return>   .         CLASS - DECwindows Motif example files>                   Size of entire class (with subclasses): 95351               No subclasses in this tailor class. L                   Do you wish to select the entire class (default = NO)? Yes  *         CLASS - Sound editor support files>                   Size of entire class (with subclasses): 17761               No subclasses in this tailor class.lL                   Do you wish to select the entire class (default = NO)? Yes           CLASS - NCSA Mosaic >                   Size of entire class (with subclasses): 11681               No subclasses in this tailor class.4Q                   Do you wish to select the entire class (default = NO)? <Return>   H                                                 (continued on next page)                        H                                                                     5-13 L  I      '      Managing DECwindows Motif SoftwareIE      5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)4  9      Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session         Files have been selectedL@      Do you wish to remove all of the options selected? <Return>;      Do you wish to remove all of the options selected? YesA#      Removing files, please wait...IO      %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[CDA$LIBRARY]DEFSTYLE.DDIF;* W      %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$CSW.UID;* X      %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEW.UID;*[      %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT.UID;*i]      %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT12.UID;* L      %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSEXE]CDA$CONVERT.EXE;*      .      .      .    -      5.3 Adding DECwindows Base-Support Files   C            If you previously chose not to install or if you removed ?            DECwindows base-support software, perform one of theSE            following procedures to add DECwindows base-support files:   A            o  On OpenVMS Alpha systems, reconfigure the operating >               system specifying that you want DECwindows Motif               support.  -            o  On OpenVMS VAX systems, use theiC               SYS$UPDATE:DECW$TAILOR.EXE procedure to add or removea1               support files from the system disk.o  C            5.3.1  Reconfiguring the OpenVMS Operating System (Alpha_            Only)  C            To reconfigure the OpenVMS Alpha operating system to addP@            DECwindows Motif support, use the PRODUCT RECONFIGURE            command.                 	      5-14A W         H                                       Managing DECwindows Motif SoftwareH                                 5.3 Adding DECwindows Base-Support Files  E               5.3.2 Using the SYS$UPDATE:DECW$TAILOR.EXE Command (VAXP               Only)   G               You can use the DECW$TAILOR utility to add or remove some-H               or all DECwindows base-support files from the system disk.  C               DECW$TAILOR is similar to DECW$MOTIF_TAILOR. However, D               the DECW$TAILOR utility is used to add or remove filesF               that support the DECwindows display server (for example:9               base-support, workstation, and font files).-  0               DECW$TAILOR includes three phases:  E               o  The first phase asks whether you want to tailor yourSD                  system by adding files ("tailor on") or by deleting&                  files ("tailor off").  A               o  In the second phase, if you choose the tailor-onSF                  procedure, DECW$TAILOR lists each class of DECwindowsG                  files and asks whether you want to include them on the E                  system disk. If you choose the tailor-off procedure,nE                  DECW$TAILOR lists each class of DECwindows files and E                  asks whether you want to delete them from the systemL                  disk.  A               o  In the third phase, DECW$TAILOR carries out your                   instructions.  F                 ________________________Note  ________________________  A                 To cancel DECW$TAILOR during the first and seconds?                 phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you(<                 cancel DECW$TAILOR during the third phase, a3                 partially tailored disk may result.   E                 _____________________________________________________s  F               Table 5-3 lists the classes and subclasses of DECwindowsE               files that you can add or remove from your system usingt               DECW$TAILOR.  F                 ________________________Note  ________________________  C                 VMS Version 5.5-2 uses different class names. These_?                 are shown in parentheses below the name used inE,                 Version 6.2 and Version 7.1.  E                 _____________________________________________________   H                                                                     5-15    n      '      Managing DECwindows Motif Softwarel-      5.3 Adding DECwindows Base-Support Files   B            Table 5-3 Classes of Files That Can Be Added or RemovedE            __________with_the_DECW$TAILOR_Utility____________________   E            Class__________Subclass_______Description_________________   C            DECwindows     No subclasses  Files necessary to run the_D            base support   in this        DECwindows Motif client andC            files          tailor class   DECwindows display server.h            (DECwindows            applications             files)s  C            DECwindows     PEX for PHIGS  Files necessary to run theiC            workstation    support files  DECwindows display server;dB            support files                 the PEX subclass includesA            (DECwindows                   support files for three-M>            device                        dimensional graphics.            support            files)s  A            75-dpi video   No subclasses  Device support files forn9            font files     in this        75-dpi monitors. &                           tailor class  A            100-dpi video  No subclasses  Device support files forV:            font files     in this        100-dpi monitors.E            _______________tailor_class_______________________________C  5            Adding DECwindows Files to the System Disks  B            To add DECwindows files to the system disk, perform the            following steps:s  +            1. Log in to the SYSTEM account.w  E            2. Enter the following command at the DCL prompt to invokel               the utility:  *               $ RUN SYS$UPDATE:DECW$TAILOR  C               After a brief overview, the DECW$TAILOR program listspD               each group, or class, of files and its size in blocks.@               Files are grouped according to their function. ForC               example, all the files required for DECwindows device B               support are in one class. A file class is made up of@               many small subclasses. You can eliminate an entireE               class of files, or you can eliminate one or more of itsu&               subclasses. For example:  	      5-16            H                                       Managing DECwindows Motif SoftwareH                                 5.3 Adding DECwindows Base-Support Files  /         CLASS - DECwindows device support files ?                   Size of entire class (with subclasses): 14107 G                   Size of common files required for any subclass: 10645 H                   Do you wish to select the entire class (default = NO)?M                   Do you wish to select any of its subclasses (default = NO)?             .            .            .  F               3. Decide which file classes or subclasses are needed toG                  support your system. DECW$TAILOR displays step-by-step C                  instructions. Follow these instructions to specify D                  which of the classes or subclasses you want to add.  E                 ______________________ Caution ______________________m  >                 To cancel DECW$TAILOR during this phase, pressD                 Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel DECW$TAILORA                 following this class selection phase, a partially )                 tailored disk may result.u  E                 _____________________________________________________E  A               4. DECW$TAILOR creates a temporary command file and B                  asks for the name of the device that contains the$                  distribution media.  F                 ________________________Note  ________________________  B                 The distribution media is the OpenVMS distribution=                 media that contains the DECwindows save sets.   E                 _____________________________________________________   E               5. DECW$TAILOR adds the files you selected and displays_*                  the names of those files.  H               Example 5-2 shows how to use DECW$TAILOR to add files to aE               system disk. The example was run on a VMS 5.5-2 system.   .         Example 5-2 Sample DECW$TAILOR Session  H                                                 (continued on next page)    H                                                                     5-17 e  o      '      Managing DECwindows Motif Software -      5.3 Adding DECwindows Base-Support Files   3      Example 5-2 (Cont.) Sample DECW$TAILOR Session   !      $ RUN SYS$UPDATE:DECW$TAILORp	         . 	         . 	         .   3       Do you want to tailor files "ON" or "OFF"? ON         TAILOR-ON      ---------H       You will now be prompted with a list of the classes and subclassesS       of DECwindows files that are optional. The size of each class and subclass is T       included in the list. This will help you decide whether or not you want to add)       a class or subclass to your system.   R       Under some classes, there is a set of common files that is required in orderD       for any subclasses to work. These files are added when you ask;       for either the entire class or any of its subclasses.   5      Total size of the system disk is 1216665 blocks. ;      Total space used on the system disk is 1121958 blocks.m9      Total space left on the system disk is 94707 blocks.C  *      CLASS - DECwindows applications files<                Size of entire class (with subclasses): 115442                No subclasses in this tailor class.I                Do you wish to select the entire class (default = NO)? YES   ,      CLASS - DECwindows device support files<                Size of entire class (with subclasses): 14107D                Size of common files required for any subclass: 10645N                Do you wish to select the entire class (default = NO)? <Return>S                Do you wish to select any of its subclasses (default = NO)? <Return>   .      CLASS - 75 dots per inch video font files;                Size of entire class (with subclasses): 2539T2                No subclasses in this tailor class.N                Do you wish to select the entire class (default = NO)? <Return>  /      CLASS - 100 dots per inch video font files ;                Size of entire class (with subclasses): 3829 2                No subclasses in this tailor class.N                Do you wish to select the entire class (default = NO)? <Return>  E                                              (continued on next page)   	      5-18            H                                       Managing DECwindows Motif SoftwareH                                 5.3 Adding DECwindows Base-Support Files  6         Example 5-2 (Cont.) Sample DECW$TAILOR Session  4         CLASS - DECwindows programming support files?                   Size of entire class (with subclasses): 26208 E                   Size of common files required for any subclass: 924_Q                   Do you wish to select the entire class (default = NO)? <Return>sV                   Do you wish to select any of its subclasses (default = NO)? <Return>           CLASS - Example filesc>                   Size of entire class (with subclasses): 31605                   No subclasses in this tailor class. Q                   Do you wish to select the entire class (default = NO)? <Return>_          Files have been selected;         Do you wish to add all of the options selected? YES,7         Creating temporary command file, please wait... @         * Enter device containing DECwindows distribution media:            .            .            .  .         5.4 Determining and Reporting Problems  ?               If you encounter a problem while using DECwindows_E               Motif, report it to Compaq. Review the Software ProductCH               Description (SPD) and Warranty Addendum for an explanation@               of warranty. If you encounter a problem during the@               warranty period, you can take one of the following               actions:  @               o  Call your Compaq support representative if yourH                  software contract or warranty agreement entitles you to#                  telephone support.y  F               o  If you discover a problem with or have comments aboutA                  the documentation, print or edit the online form B                  SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us yourF                  comments by Internet, fax, or mail. (See the Reader's@                  Comments section in the Preface for addresses.)              H                                                                     5-19 a  a                  H                                                                        AH         ________________________________________________________________  H            POLYCENTER Software Installation Utility Sample Installations      @               This appendix contains sample installations of theD               DECwindows Motif Version 1.2-5 for OpenVMS software onE               OpenVMS Alpha Version 7.1, OpenVMS VAX Version 7.1, and G               OpenVMS Alpha Version 6.2 systems. Section A.1 presents a7F               sample DECwindows Motif installation on an OpenVMS AlphaB               Version 7.1 operating system. Section A.2 presents aD               sample DECwindows Motif installation on an OpenVMS VAXB               Version 7.1 operating system. Section A.3 presents aF               sample DECwindows Motif installation on an OpenVMS AlphaB               Version 6.2 operating system. Refer to Chapter 2 forF               details about using the POLYCENTER Software InstallationC               utility to install DECwindows Motif Version 1.2-5 forA               OpenVMS software.t  C               The sample installations assume that you have set the1@               default directory to the device name and directoryD               containing the PCSI ECO and DECwindows Motif savesets.G               (The PCSI ECO is only required for the supported versions C               of OpenVMS prior to Version 7.2. See the Guide to thenC               DECwindows Motif Version 1.2-5 for OpenVMS CD-ROM for &               details about this ECO.)                            H                                                                      A-1           B      POLYCENTER Software Installation Utility Sample InstallationsC      A.1 Sample Installation on an OpenVMS Alpha Version 7.1 Systemh  C      A.1 Sample Installation on an OpenVMS Alpha Version 7.1 System   <            Example A-1 contains a sample installation of theA            mandatory ECO for the POLYCENTER Software InstallationoE            utility (PCSI). Example A-2 contains a sample installation4E            of the DECwindows Motif Version 1.2-5 for OpenVMS software @            on an OpenVMS Alpha Version 7.1 operating system with'            sufficient system resources.   B      Example A-1 Sample Installation of the Mandatory ECO for PCSI+                  on an OpenVMS Alpha System   I                Welcome to the OpenVMS Alpha Operating System, Version 7.1a  0      $ PRODUCT INSTALL VMS62TO71U2_PCSI <Return>  -      The following product has been selected:iK          DEC AXPVMS VMS62TO71U2_PCSI V1.0        Patch (maintenance update)c  ,      Do you want to continue? [YES] <Return>  %      Configuration phase starting ...   S      You will be asked to choose options, if any, for each selected product and forsT      any products that may be installed to satisfy software dependency requirements.  %      DEC AXPVMS VMS62TO71U2_PCSI V1.0(  <      * This product does not have any configuration options.  !      Execution phase starting ...l  <      The following product will be installed to destination:E          DEC AXPVMS VMS62TO71U2_PCSI V1.0        DISK$2:[VMS$COMMON.]O        Portion done: 0%       ...10%       ...20%       ...40%n      ...50%t    E                                              (continued on next page)           A-2           H            POLYCENTER Software Installation Utility Sample InstallationsH           A.1 Sample Installation on an OpenVMS Alpha Version 7.1 System  D         Example A-1 (Cont.) Sample Installation of the Mandatory ECO?                             for PCSI on an OpenVMS Alpha Systemt           ...80%         ...90%         ...100%   1         The following product has been installed: N             DEC AXPVMS VMS62TO71U2_PCSI V1.0        Patch (maintenance update)                                                                        H                                                                      A-3 D  U      B      POLYCENTER Software Installation Utility Sample InstallationsC      A.1 Sample Installation on an OpenVMS Alpha Version 7.1 SystemE  @      Example A-2 Sample Installation of an Upgrade of DECwindowsB                  Motif on an OpenVMS Alpha Version 7.1 System With,                  Sufficient System Resources  '      $ PRODUCT INSTALL DWMOTIF <Return>   -      The following product has been selected:t?          DEC AXPVMS DWMOTIF V1.2-5              Layered Productr  ,      Do you want to continue? [YES] <Return>  %      Configuration phase starting ...l  S      You will be asked to choose options, if any, for each selected product and for T      any products that may be installed to satisfy software dependency requirements.  0      DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif  Q          Copyright Digital Equipment Corporation 1988, 1998. All rights reserved.   &          Digital Equipment Corporation  ,          This product uses the PAK: DW-MOTIF  ,      Checking values of system parameters...-                                            OK   =      Do you want the defaults for all options? [YES] <Return>   S          Local Language Variants of DECwindows Motif must be upgraded at this time.   0          Do you want to continue? [YES] <Return>  7      Do you want to review the options? [NO] Y <Return>p  0      DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif(          DEC AXPVMS VMS V7.1 [Installed]!          Install New Desktop: YESaD            Install Manual (reference) pages for the New Desktop: YES8            Make the New Desktop the default desktop: YES4          Install traditional DECwindows Desktop: YES  E                                              (continued on next page)           A-4           H            POLYCENTER Software Installation Utility Sample InstallationsH           A.1 Sample Installation on an OpenVMS Alpha Version 7.1 System  @         Example A-2 (Cont.) Sample Installation of an Upgrade of@                             DECwindows Motif on an OpenVMS AlphaE                             Version 7.1 System With Sufficient System %                             Resources   7             Programming Support for the C Language: YESE<             Programming Support for the Pascal Language: YES=             Programming Support for the FORTRAN Language: YES 8             Programming Support for the New Desktop: YES%             Programming examples: YESe&               Sound example files: YES<                     Programming examples for DECwindows: YES;               Programming examples for the New Desktop: YES )             Translated Image Support: YES   =         Are you satisfied with these options? [YES]  <Return>_  $         Execution phase starting ...  ?         The following product will be installed to destination: G             DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.] ?         The following product will be removed from destination: G             DEC AXPVMS DWMOTIF V1.2-4              DISK$2:[VMS$COMMON.]_           Portion done: 0%         ...10%         ...20%         ...30%         ...40%         ...50%         ...60%         ...70%         ...80%         ...90%  T           **** DECwindows Motif application and run-time support files DETECTED ****  <           **** DECwindows device support files DETECTED ****           ...100%n    H                                                 (continued on next page)    H                                                                      A-5 _  _      B      POLYCENTER Software Installation Utility Sample InstallationsC      A.1 Sample Installation on an OpenVMS Alpha Version 7.1 Systemw  =      Example A-2 (Cont.) Sample Installation of an Upgrade ofi=                          DECwindows Motif on an OpenVMS Alpha B                          Version 7.1 System With Sufficient System"                          Resources  .      The following product has been installed:?          DEC AXPVMS DWMOTIF V1.2-5              Layered Product ,      The following product has been removed:?          DEC AXPVMS DWMOTIF V1.2-4              Layered Productr  0      DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif  O          System reboot will be required following upgrade of language variants.   E          Installation Verification Procedure can be run after reboot.p      $ Logout <Return>                                                                A-6 s  n      H            POLYCENTER Software Installation Utility Sample InstallationsH             A.2 Sample Installation on an OpenVMS VAX Version 7.1 System  D         A.2 Sample Installation on an OpenVMS VAX Version 7.1 System  ?               Example A-3 contains a sample installation of the-G               DECwindows Motif Version 1.2-5 for OpenVMS software on andH               OpenVMS VAX Version 7.1 operating system with insufficient               system resources.r  C         Example A-3 Sample Installation of an Upgrade of DECwindows_A                     Motif Version 1.2-5 for OpenVMS on an OpenVMS C                     VAX Version 7.1 System With Insufficient System                      Resources   0         The following product has been selected:B             DEC VAXVMS DWMOTIF V1.2-5              Layered Product  &         Do you want to continue? [YES]  (         Configuration phase starting ...  V         You will be asked to choose options, if any, for each selected product and forW         any products that may be installed to satisfy software dependency requirements.t  3         DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif   G          Digital Equipment Corporation 1988, 1998. All rights reserved.s  )             Digital Equipment Corporationl  /             This product uses the PAK: DW-MOTIFl  /         Checking values of system parameters...tZ           %DECW-W-BADVALUE, SYSGEN parameter PQL_MBYTLM is 40000, should be at least 48000  U           The installation procedure has determined that some system parameter values P           require modification to install the DECwindows Motif Version 1.2-5 for           OpenVMS software.e  Q           Please type the following command to run AUTOGEN and reboot your systemqR           before restarting the DECwindows installation.  This will set the systemO           parameters to appropriate values for running DECwindows Motif V1.2-5.e    H                                                 (continued on next page)    H                                                                      A-7 t  u      B      POLYCENTER Software Installation Utility Sample InstallationsA      A.2 Sample Installation on an OpenVMS VAX Version 7.1 System   =      Example A-3 (Cont.) Sample Installation of an Upgrade of_C                          DECwindows Motif Version 1.2-5 for OpenVMS B                          on an OpenVMS VAX Version 7.1 System With6                          Insufficient System Resources  >              @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK  5      The DECwindows installation is being terminated.   5      Please run AUTOGEN and restart the installation.   '      %PCSI-E-S_OPFAIL, operation failedoR      %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error condition  9        SYSTEM       logged out at 20-NOV-1998 17:03:49.25   D            At this point, run AUTOGEN and then restart the installa-            tion.  -      The following product has been selected: ?          DEC VAXVMS DWMOTIF V1.2-5              Layered Product   #      Do you want to continue? [YES]_  %      Configuration phase starting ...C  S      You will be asked to choose options, if any, for each selected product and for F      any products that may be installed to satisfy software dependency      requirements.  0      DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif  C      Digital Equipment Corporation 1988, 1998. All rights reserved.   &          Digital Equipment Corporation  ,          This product uses the PAK: DW-MOTIF  ,      Checking values of system parameters...  .                                             OK  E                                              (continued on next page)e          A-8 l  E      H            POLYCENTER Software Installation Utility Sample InstallationsH             A.2 Sample Installation on an OpenVMS VAX Version 7.1 System  @         Example A-3 (Cont.) Sample Installation of an Upgrade ofF                             DECwindows Motif Version 1.2-5 for OpenVMSE                             on an OpenVMS VAX Version 7.1 System With 9                             Insufficient System Resourcesa  7         Do you want the defaults for all options? [YES]e  V             Local Language Variants of DECwindows Motif must be upgraded at this time.  )            Do you want to continue? [YES]y  9         Do you want to review the options? [NO]Y <Return>a  3         DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif +             DEC VAXVMS VMS V7.1 [Installed] 7             DECwindows Motif runtime support files: YESs=                   Programming Support for the C Language: YESo=             Programming Support for the FORTRAN Language: YES:<             Programming Support for the Pascal Language: YES%             Programming examples: YESe  ;         Are you satisfied with these options? [YES]<Return>i$         Execution phase starting ...  ?         The following product will be installed to destination:mR             DEC VAXVMS DWMOTIF V1.2-5              DISK$VAX71_124_P2:[VMS$COMMON.]?         The following product will be removed from destination:hR             DEC VAXVMS DWMOTIF V1.2-4              DISK$VAX71_124_P2:[VMS$COMMON.]           Portion done: 0%         ...10%         ...20%         ...30%         ...40%         ...50%         ...60%         ...70%         ...80%         ...90%  T           **** DECwindows Motif application and run-time support files DETECTED ****  H                                                 (continued on next page)    H                                                                      A-9 e  t      B      POLYCENTER Software Installation Utility Sample InstallationsA      A.2 Sample Installation on an OpenVMS VAX Version 7.1 System   =      Example A-3 (Cont.) Sample Installation of an Upgrade ofiC                          DECwindows Motif Version 1.2-5 for OpenVMSeB                          on an OpenVMS VAX Version 7.1 System With6                          Insufficient System Resources  9        **** DECwindows device support files DETECTED ****)        ...100%  .      The following product has been installed:?          DEC VAXVMS DWMOTIF V1.2-5              Layered Producte,      The following product has been removed:?          DEC VAXVMS DWMOTIF V1.2-4              Layered Product   0      DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif  O          System reboot will be required following upgrade of language variants.s  E          Installation Verification Procedure can be run after reboot.n7             DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motifb  O          System reboot will be required following upgrade of language variants. E          Installation Verification Procedure can be run after reboot.e                                            	      A-10.           H            POLYCENTER Software Installation Utility Sample InstallationsH           A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System  F         A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System  ?               Example A-4 contains a sample installation of the E               mandatory ECO for the PCSI software on an OpenVMS AlphaaB               Version 6.2 operating system. Example A-5 contains aF               sample installation of the DECwindows Motif Version 1.2-D               5 for OpenVMS software on an OpenVMS Alpha Version 6.2B               operating system with insufficient system resources.  E         Example A-4 Sample Installation of the Mandatory ECO for PCSIc.                     on an OpenVMS Alpha System  0         The following product has been selected:(         DEC AXPVMS VMS62TO71U2_PCSI V1.0  0         Do you want to continue? [YES]  <Return>  ,         *** DEC AXPVMS VMS62TO71U2_PCSI V1.0  3         %PCSIUI-I-DONEASK, execution phase starting 0         The following product will be installed:(         DEC AXPVMS VMS62TO71U2_PCSI V1.0F         %PCSI-I-VOLINFO, estimated space information for volume DISK$2E         -PCSI-I-VOLSPC, -331 required; 2851892 available; 2852223 netE           Portion Done: 0%         ...10%         ...40%         ...80%         ...90%         ...100%l1         The following product has been installed:i(         DEC AXPVMS VMS62TO71U2_PCSI V1.0                        H                                                                     A-11 .  y      B      POLYCENTER Software Installation Utility Sample InstallationsC      A.3 Sample Installation on an OpenVMS Alpha Version 6.2 Systemt  @      Example A-5 Sample Installation of an Upgrade of DECwindowsC                  Motif on an OpenVMS Alpha System With Insufficientt!                  System Resources   '      $ PRODUCT INSTALL DWMOTIF <Return>o    -      The following product has been selected:t?          DEC AXPVMS DWMOTIF V1.2-5              Layered Products  ,      Do you want to continue? [YES] <Return>  %      Configuration phase starting ...i  O      You will be asked to choose options, if any, for each selected product andiJ      for any products that may be installed to satisfy software dependency      requirements.  0      DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif  Q          Copyright Digital Equipment Corporation 1988, 1998. All rights reserved.s  &          Digital Equipment Corporation  ,          This product uses the PAK: DW-MOTIF  ,      Checking values of system parameters...U      %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 110000, should be at least 150000 W      %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1867776, should be at least 1998848   R        The installation procedure has determined that some system parameter valuesM        require modification to install the DECwindows Motif Version 1.2-5 fori        OpenVMS software.  N        Please type the following command to run AUTOGEN and reboot your systemO        before restarting the DECwindows installation.  This will set the systemiL        parameters to appropriate values for running DECwindows Motif V1.2-5.  >              @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK      E                                              (continued on next page)t    	      A-12     E      H            POLYCENTER Software Installation Utility Sample InstallationsH           A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System  @         Example A-5 (Cont.) Sample Installation of an Upgrade ofG                             DECwindows Motif on an OpenVMS Alpha System >                             With Insufficient System Resources  8         The DECwindows installation is being terminated.  8         Please run AUTOGEN and restart the installation.  *         %PCSI-E-S_OPFAIL, operation failedU         %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error conditiony  G               At this point, run AUTOGEN and then restart the installa-d               tion.     0         The following product has been selected:B             DEC AXPVMS DWMOTIF V1.2-5              Layered Product  /         Do you want to continue? [YES] <Return>   (         Configuration phase starting ...  V         You will be asked to choose options, if any, for each selected product and forI         any products that may be installed to satisfy software dependency          requirements.o4          DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif  T             Copyright Digital Equipment Corporation 1988, 1998. All rights reserved.  )             Digital Equipment Corporationo  /             This product uses the PAK: DW-MOTIFO  /         Checking values of system parameters...9  1                                                OK   @         Do you want the defaults for all options? [YES] <Return>  V             Local Language Variants of DECwindows Motif must be upgraded at this time.    H                                                 (continued on next page)    H                                                                     A-13 s  l      B      POLYCENTER Software Installation Utility Sample InstallationsC      A.3 Sample Installation on an OpenVMS Alpha Version 6.2 Systems  =      Example A-5 (Cont.) Sample Installation of an Upgrade ofiD                          DECwindows Motif on an OpenVMS Alpha System;                          With Insufficient System Resources   0          Do you want to continue? [YES] <Return>  7      Do you want to review the options? [NO] Y <Return>Y  0      DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif,          DEC AXPVMS VMS V6.2-1H3 [Installed]$             Install New Desktop: YESD            Install Manual (reference) pages for the New Desktop: YES8            Make the New Desktop the default desktop: YES4          Install traditional DECwindows Desktop: YES4          Programming Support for the C Language: YES9          Programming Support for the Pascal Language: YESc:          Programming Support for the FORTRAN Language: YES5          Programming Support for the New Desktop: YES "          Programming examples: YES#            Sound example files: YES 3            Programming examples for DECwindows: YESm8            Programming examples for the New Desktop: YES&          Translated Image Support: YES  9      Are you satisfied with these options? [YES] <Return>M  !      Execution phase starting ...   <      The following product will be installed to destination:D          DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.]<      The following product will be removed from destination:D          DEC AXPVMS DWMOTIF V1.2-4              DISK$2:[VMS$COMMON.]          Portion done: 0%       ...10%o      ...20%x      ...30%       ...40%       ...50%       ...60%N      ...70%I    E                                              (continued on next page)     	      A-14l    s      H            POLYCENTER Software Installation Utility Sample InstallationsH           A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System  @         Example A-5 (Cont.) Sample Installation of an Upgrade ofG                             DECwindows Motif on an OpenVMS Alpha System >                             With Insufficient System Resources           ...80%         ...90%  T           **** DECwindows Motif application and run-time support files DETECTED ****  <           **** DECwindows device support files DETECTED ****           ...100%   1         The following product has been installed:xB             DEC AXPVMS DWMOTIF V1.2-5              Layered Product/         The following product has been removed:eB             DEC AXPVMS DWMOTIF V1.2-4              Layered Product5           DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif   R             System reboot will be required following upgrade of language variants.  H             Installation Verification Procedure can be run after reboot.                                              H                                                                     A-15                       H                                                                        BH         ________________________________________________________________  H                                            VMSINSTAL Sample Installation      ?               This appendix contains a sample VMSINSTAL product                installation.   F         B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2             System  ?               Example B-1 contains a sample installation of the D               DECwindows Motif Version 1.2-5 for OpenVMS software onF               a VMS Version 5.5-2 operating system using the VMSINSTALF               procedure. The sample installation assumes that no usersH               are logged in to the system and that you specified OPTIONS-               N to display the release notes.   7         Example B-1 Sample Installation Using VMSINSTALu  /         $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU5012   F                 VAX/VMS Software Product Installation Procedure V5.5-2  #         It is 26-MAR-1998 at 10:36.1  7         Enter a question mark (?) at any time for help.I  O         * Are you satisfied with the backup of your system disk [YES]? <Return>r  O         * Where will the distribution volumes be mounted: DAD2:[000000]<Return>u  R         Enter the products to be processed from the first distribution volume set.,         * Products: dwmotifvaxu5012 <Return>  E         * Enter installation options you wish to use (none): <Return>   1         The following products will be processed:              DWMOTIFVAXU5 V1.2e  H                                                 (continued on next page)  H                                                                      B-1 i  1      "      VMSINSTAL Sample InstallationJ      B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System  <      Example B-1 (Cont.) Sample Installation Using VMSINSTAL  A              Beginning installation of DWMOTIFVAXU5 V1.2 at 10:36-  ;      %VMSINSTAL-I-RESTORE, Restoring product save set A ....P      %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.  I              *** Installing DECwindows Motif for OpenVMS VAX software ***   O        Copyright Digital Equipment Corporation 1988, 1998. All rights reserved.f  P        Restricted Rights: Use, duplication, or disclosure by the U.S. GovernmentL        is subject to restrictions as set forth in subparagraph (c)(1)(ii) ofN        DFARS  252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III,        as  applicable.  O        This software is proprietary to and embodies the confidential technology L        of Digital Equipment Corporation. Possession, use, or copying of thisP        software and media is authorized only pursuant to a valid written license1        from DIGITAL or an authorized sublicensor.u  I        You can install the DECwindows Motif kit completely or in selectedhL        portions.  A complete installation requires as many as 68,400 blocks.F        If you choose to perform a partial installation, you can selectJ        (tailor) the programming support files that support your DECwindowsP        Motif application development.  Whether you perform a complete or partialK        installation, this kit provides support for running DECwindows Motifi/        applications on OpenVMS compute servers.   =      * Do you want to install the entire kit [Y]? No <Return>   H        This installation procedure provides support files for developingM        DECwindows Motif applications in several programming languages.  TheselP        files are needed only to develop applications and are not required to runO        DECwindows Motif applications.  The free disk space requirement for each.@        programming support file ranges from 3000 to 8000 blocks.  P      * Do you want to install DECwindows Motif programming support [Y]? <Return>  R        Support files are supplied for the following OpenVMS programming languages:          FORTRAN, Pascal  P        In addition, support files are supplied for programming in the C languageO        using conventions and standards developed at the Massachusetts Institutev        of Technology.   E                                              (continued on next page)         B-2           H                                            VMSINSTAL Sample InstallationH    B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System  ?         Example B-1 (Cont.) Sample Installation Using VMSINSTALC  U         * Do you want to install all programming language support files [Y]? <Return>   T         * Do you want to install DECwindows Motif programming examples [Y]? <Return>  >           You have selected the following portions of the kit:  G                 o  DECwindows Motif Applications and Run-time Librariesr  8                 o  DECwindows Motif programming examples  7                 o  DECwindows Motif programming supportk'                         FORTRAN, Pascal >                         MIT C language programming conventions  4         * Are these selections correct [Y]? <Return>  K           A registered and loaded product authorization key for DW-MOTIF isaN           required to run any DECwindows Motif for OpenVMS application. If youR           answer NO to the next question, the installation of DECwindows Motif for%           OpenVMS will be terminated.t  &                 Product:      DW-MOTIF!                 Producer:     DECe                 Version:                 Release Date:f  Y         * Does this product have an authorization key registered and loaded? Yes <Return>   K           DECwindows Motif will not start if your system parameters are not.           correct.  K           o If you allow a system shutdown, the installation procedure will<M             reboot the system at the end of the installation.  If your systemEM             parameters are incorrect, the installation will run AUTOGEN priorl!             to the system reboot.m  M           o If you do not allow a system shutdown, the installation procedureTE             will continue, and you will be informed at the end of theuM             installation whether you need to modify your system parameters ini,             order to start DECwindows Motif.  K             To complete the installation of this product, you should rebootdM             the system.  If it is not convenient to reboot at this time, then_/             enter NO to the following question.i  H                                                 (continued on next page)  H                                                                      B-3 .  %      "      VMSINSTAL Sample InstallationJ      B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System  <      Example B-1 (Cont.) Sample Installation Using VMSINSTAL  C          If you enter NO, the installation procedure will continue.   Z      * Will you allow a system shutdown after this product is installed [YES]? No <Return>  *        No further questions will be asked.  ;      %VMSINSTAL-I-RESTORE, Restoring product save set B ... ;      %VMSINSTAL-I-RESTORE, Restoring product save set C ... ;      %VMSINSTAL-I-RESTORE, Restoring product save set D ...e;      %VMSINSTAL-I-RESTORE, Restoring product save set E ... ;      %VMSINSTAL-I-RESTORE, Restoring product save set F ...i;      %VMSINSTAL-I-RESTORE, Restoring product save set G ...t;      %VMSINSTAL-I-RESTORE, Restoring product save set H ...E;      %VMSINSTAL-I-RESTORE, Restoring product save set I ...s;      %VMSINSTAL-I-RESTORE, Restoring product save set J ... ;      %VMSINSTAL-I-RESTORE, Restoring product save set L ...oS      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...X  @        You may safely ignore the following NCP error message(s):        %NCP-I-SUCCESS,  Successl      Object = X$X0,      %NML-I-RECDELET, Database entry deleted  L        The Installation Verification Procedure (IVP) should be run after theO        installation has been completed and DECwindows Motif has been restarted.i5        The IVP can be found in SYS$TEST:DECW$IVP.COM.n  P        The installation procedure has determined that your system parameters areO        set correctly and that it will not be necessary to run AUTOGEN or reboots        the system.  M        If your system is already running DECwindows Motif, restart DECwindowsa,        Motif with the following DCL command:  /             $ @SYS$MANAGER:DECW$STARTUP RESTARTt  O        If your system is NOT already running DECwindows Motif, start DECwindowsl,        Motif with the following DCL command:  '             $ @SYS$MANAGER:DECW$STARTUPa  4                                  * * * N O T E * * *  E                                              (continued on next page)         B-4 t         H                                            VMSINSTAL Sample InstallationH    B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System  ?         Example B-1 (Cont.) Sample Installation Using VMSINSTAL   S           If you are installing DECwindows Motif from your workstation console, log>D           off after you enter the command to start DECwindows Motif.  U           The installation procedure has determined that your system parameter values B           are acceptable.  A reboot of the system is not required.  D                 Installation of DWMOTIFVAXU5 V1.2 completed at 10:57  Q         Enter the products to be processed from the next distribution volume set.          * Products: <Return>-             VMSINSTAL procedure done at 12:45                                                                 H                                                                      B-5                       H                                                                        CH         ________________________________________________________________  H                                                      Software Components      A               If you installed DECwindows Motif Version 1.2-5 fori@               OpenVMS using the POLYCENTER Software InstallationG               utility, you can obtain a list of all installed files and E               the directories and subdirectories into which the files F               were installed. To obtain this list, enter the following?               POLYCENTER Software Installation utility command:o  3               $ PRODUCT SHOW OBJECT/product=dwmotift  =               Following is a sample output from this command.t  B               OBJECT                                   OBJECT TYPEB               ------                                   -----------@               [000000]                                 directoryH               [000000]DEC-AXPVMS-DWMOTIF-V0102-5-1.PCSI$DESCRIPTION file@               [000000]DEC-AXPVMS-DWMOTIF-V0102-5-1.PCSI$TLB file@               [CDA$LIBRARY]                            directory;               [CDA$LIBRARY]CL_DAY.DOC_STYLE            filei;               [CDA$LIBRARY]DEFSTYLE.DDIF               filee@               [CDE$DEFAULTS]                           directory@               [CDE$DEFAULTS]                           directory@               [CDE$DEFAULTS.SYSTEM]                    directory@               [CDE$DEFAULTS.SYSTEM]                    directory@               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS]       directory@               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]     directory=               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DT.DAT file A               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCALC.DAT file C               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCREATE.DAT filelA               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTFILE.DAT fileoB               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTHELLO.DAT file               .                .                .M    H                                                                      C-1 y  m                          E      ________________________________________________________________G  E                                                                 Indexa    4      A                                    AWD option>      ___________________________           specifying (cont'd)C      Account quotas                           another storage disk,   4        See also Quotas                           3-3@        required for installation              command line,  3-4=          ,  1-9                               directory,  3-3o  =      Alternate working device                 variables,  3-4o0        See AWD option                      using=      Alternative console                      with fewer thantE        See Console                               required free blocks17      ASTLM parameter                             ,  3-3q  +        required quota for                 BrE          installation,  1-9               ___________________________p0      AUTHORIZE utility                    BackupD        using to change Quotas,             backing up a system disk,2          1-9                                  1-19D      AUTOGEN utility                       confirming system backup,1        invoking during                        3-8.2          installation,  3-20              Base kitE        preparing for                       required disk space,  1-10 9          installation,  1-14              BIOLM parameterN=        rebooting the system,               required quota for3@          1-18                                 installation,  1-9  0        using to change system             Blocks:          parameters,  1-17                 See Free blocks4      AWD option                           BookreaderC        installing, 3-7                     copying customized files C        lacking sufficient disk                to another directory, 1          space,  3-16                         1-8 C        restarting the                      saving customized files, 1          installation,  3-15                  1-7         specifyinge  E                                                               Index-1     s            1      Booting                              DesktopS@        DECwindows Motif for                selecting,  2-12, 4-85          OpenVMS,  4-1                    Device namef.        standalone systems, 4-3             AWD8      BYTLM parameter                          ddcu,  3-77        required quota for                  source drive 8          installation,  1-9                   ddcu,  3-79                                            specifying forT@      C__________________________              installation,  3-5:      CDE,  4-8                            DFS-mounted disk@      Components                            determining free disk9        DECwindows X11 display                 space,  3-5M8          server, fonts, device             for AWD,  3-5C          drivers,  1-4                     on the system disk,  3-529        operating system                   DIOLM parameter =           DECwindows transports            required quota for0@             and base-system                   installation,  1-94                                           Disk space6             support,  1-4                  determining;      Console                                  amount,  1-10 D        alternative, 4-7                       number of free blocks,5        main, 4-7                                 1-10 B      Customize                             on the DFS-mounted AWD,1        system after installation              3-5 3          ,  5-1                            requiredwA      Customizing                              by component,  1-10 ;        Bookreader files                    verifying,  3-15 B           saving, 1-7                     Distributed File Service  1      D                                      (DFS)L?      ___________________________           See DFS-mounted disk <      DECW$MOTIF_TAILOR utility            Distribution media9        overview, 5-8                       mounting,  3-9         removing files from aE          system disk,  5-10               E__________________________ 9      DECW$TAILOR utility                  ENQLM parameter.=        adding base support files           required quota for @          to a system disk,  5-16              installation,  1-9>        overview, 5-15                     Error recovery, 3-23:        using, 5-15                        Example programsE      DECwindows X11 Display                required disk space,  1-10          server        customizing startup, 5-1           Index-2 a  n            /                                             IVPlA         F__________________________           notification duringS  F         Facility name, 3-5                       product installation,5         Files                                    3-20M5          adding DECwindows files,             running C             5-14                                 after starting the @         FILLM parameter                             product, 4-5A          required quota for                      procedure,  3-20S               installation,  1-9G         Free blocks                         K__________________________u4          determining amount,  1-10          KeyboardF         Free global pages                     customizing layout,  5-3@          calculating,  1-15                   model number,  5-38          required,  1-16                    Keymap names?         Free global sections                  determining,  5-4 8          calculating,  1-15                   list,  5-4/          required,  1-16                    Kits  ?                                               installing,  3-12 B         G__________________________           loading distribution  ;         Global pages                             media, 3-6nB          See Free global pages                preserving OSF/MotifD         Global sections                          Release 1.1.3, 3-11  -          See Free global sections           L G                                             ___________________________i5         H__________________________         LanguagesM?         Hardware                              installing,  3-13a=          supported by DECwindows            Language variantsD>             Motif,  1-3                       installing,  2-8F                                             License registration,  1-2F                                               sample PAK registration,4         I__________________________              B-1  >         Installation name                     verifying,  3-177          See Facility name                  Logging outdD         Installation procedure                notifying users,  1-19            completing,  3-22G         Installation requirements,          M__________________________.  9           1-9, 3-2                          Magnetic tapea  E         Installation Verification             installation procedure, 4           Procedure                              3-7>          See IVP                            Main console,  4-7E         Insufficient quotas                 Memory requirements,  1-4b            See Error recoverys  H                                                                  Index-3 o  e            ;      Monitor                              PCSI installationt=        100 dpi, 5-2                        verifying (cont'd)rC      Monochrome workstations,                 device support files,M5         5-3                                      2-10m  E                                               system parameters,  2-6i=      N__________________________          POLYCENTER Softwarer  @      NET-APP-SUP-250 license,               Installation utilityC         3-17                               accessing DCL help,  2-2 @      NET-APP-SUP-300 license,              backing up the system8         3-17                                  disk,  2-2D      New Desktop                           confirming your responses@        selecting, 2-12, 4-8                   to questions,  2-45      North American keyboard               displayingo?         layout, 5-2                           messages when thegD                                                  installation fails,5      O__________________________                 2-18NA      Operating system                      extracting the releaser9         prerequisites                         notes,  2-3d<        using the POLYCENTER                prerequisites for@          Software Installation                installation,  1-3B          utility,  1-3                     responding to questionsB      Operator window,  4-7                    during installation,1                                               2-4tC      P                                     running the installationCE      ___________________________              command procedure,  2-4iA      Page file size                        selecting the desktop,o2        setting, 1-17                          2-12:      PAK registration,  B-1               Postinstallation  D        See also License                    determining and reporting=          registration                         problems,  5-19 0      Parameters                            tasksD        See System parameters                  customizing DECwindows<      PCSI installation                           Motif,  5-1A        checking                           Postinstallation tasks,e/           programming                       4-1 C             environment,  2-11             choosing and alternativef;        displaying                             console,  4-7i@           language variants, 2-8           running the IVP,  4-5>        verifying                           starting DECwindows<           applications and run-               software,  4-1?             time support files,           Prerequisite softwaree               2-9a        Index-4                          Prerequisite softwareyG           (cont'd)                          R__________________________a  G          using the POLYCENTER               Rebooting the system,  3-17t9             Software Installation           Release notesED             utility,  1-3                     accessing,  3-10, 3-23D         Privileges                               POLYCENTER SoftwareH          required for installation                  Installation utility9             ,  3-3                                  , 2-3 E         Product Authorization Key                VMSINSTAL procedure,s7          See PAK registration                       3-7 F         Product name                          displaying,  3-10, 3-11,5          specifying for                          3-23eB             installation,  3-5                extracting to a fileD         Programming                              POLYCENTER SoftwareH          environment                                Installation utility9             disk space                              , 2-3a<                requirements,  1-10            options,  3-10D             installing,  3-12, 3-13           printing,  3-10, 3-11,5             installing support                   3-23iH                files,  3-13                   specifying OPTIONS N,  3-7               preserving,  3-12SG             saving,  2-11                   S__________________________IE          examples                           Selecting a desktop,  4-8E:             installing,  3-14               Server startup?          support                              customizing,  5-1TD             compatibility in the            Shutting down the systemD                XUI and OSF/Motif              notifying users,  1-194                environments,  1-6           SoftwareG             OSF/Motif Release                 required operating systemu=                1.1.3,  1-6                       version, 1-3t  F                                             Starting DECwindows Motif,2         Q__________________________            4-1A         Quotas, 3-5                           on boot nodes,  4-4oD          minimum required for                 on nonsatellites,  4-4A             installation,  1-9                on satellites,  4-4dD          verifying and changing,              on standalone systems,4             1-9                                  4-3D                                               on VMScluster systems,4                                                  4-3:                                             SYSGEN utilityG                                               checking system parametero=                                                  values, 1-15i  H                                                                  Index-5 o  n                  SYSGEN utility (cont'd)E        preparing for                      T__________________________   B          installation,  1-14              Translated-image supportE      System                                required disk space,  1-10 @        shutdown                           Tuning the system, 5-1           notifying users, 1-19eE        tuning, 5-1                        V__________________________ =      SYSTEM account,  3-7                 VMSINSTAL procedureg@      System disk                           backing up the system8        adding DECwindows base                 disk,  3-1E          support files,  5-14              changing selections,  3-14>D        backing up, 2-2, 3-8                copying the release notes@        customizing                            to SYS$HELP,  3-11D           DECW$MOTIF_TAILOR                displaying release notes,2             utility,  5-10                    3-10=           DECW$TAILOR utility,             entering directory B             5-16                              specifications,  3-9A        determining                         entering product name, 1           number of free blocks,              3-9 5             1-10                           installing ?        free space required for                entire kit,  3-13 C          installation,  1-10,                 programming examples,C5          3-15                                    3-14_  B      System Generation utility             listing directories and  >        See SYSGEN utility                     save sets,  3-187      System parameters                     locating thesA        adding                                 VMSINSTAL.COM file,u1           new parameters, 1-17                3-6 @        changing                            mounting distribution;           by using the AUTOGEN                volumes,  3-9e9             utility,  1-17                 preserving theuE           values, 1-17                        programming environmentt5        checking                               ,  3-12s@           values, 1-15                     rebooting the system,2        minimum required, 1-13                 3-17:        modifying                           registering and           incremental D             adjustments,  1-18                installing the ProductE        recalculating, 1-18                    Authorization Key (PAK)S4        reset by AUTOGEN, 3-21                 ,  3-1E        setting WINDOW_SYSTEM,              reselecting options,  3-16 C          4-1                               running the InstallationfD                                               Verification Procedure:                                               (IVP),  3-20        Index-6    C            G         VMSINSTAL procedure                   stopping the installation 6           (cont'd)                               , 3-5H          specifying incorrect name            using the AWD option,  3-7  !             for the source drive, G             3-8                             W__________________________C  @          specifying product name,           WINDOW_SYSTEM system8             3-7                                parameter;          starting the installation            setting,  4-1o>             ,  3-6, 3-7                     Workstations,  5-3                                                                    H                                                                  Index-7