             7                     Compaq DECwindows Motif for OpenVMS ?                     ___________________________________________   &                     Installation Guide    -                     Order Number: AA-Q1EAE-TE                          April 2001  F                     This manual provides step-by-step instructions forC                     installing Compaq DECwindows Motif for OpenVMS.               H                     Revision/Update Information:  This manual supersedesF                                                   the DECwindows MotifC                                                   Version 1.2-5 for F                                                   OpenVMS Installation8                                                   Guide.  G                     Operating System:             OpenVMS Alpha Version =                                                   6.2, 7.1-2, ?                                                   7.2-1, or 7.3 E                                                   OpenVMS VAX Version ;                                                   6.2, 7.1, =                                                   7.2, or 7.3 C                                                   VMS Version 5.5-2   I                     Software Version:             Compaq DECwindows Motif D                                                   for OpenVMS Alpha,?                                                   Version 1.2-6 C                                                   Compaq DECwindows H                                                   Motif for OpenVMS VAX,?                                                   Version 1.2-6         /                     Compaq Computer Corporation "                     Houston, Texas                 J           ________________________________________________________________           April 2001  ,            2001 Compaq Computer Corporation  E           COMPAQ, OpenVMS, VAX, VMS, the Compaq logo, and the DIGITAL >           logo Registered in U.S. Patent and Trademark Office.  A           Motif, OSF/1, and UNIX are registered trademarks of The            Open Group.   =           All other product names mentioned herein may be the A           trademarks or registered trademarks of their respective            companies.  C           Confidential computer software. Valid license from Compaq D           or authorized sublicensor required for possession, use, orD           copying. Consistent with FAR 12.211 and 12.212, CommercialA           Computer Software, Computer Software Documentation, and A           Technical Data for Commercial Items are licensed to the E           U.S. Government under vendor's standard commercial license.   ?           Compaq shall not be liable for technical or editorial /           errors or omissions contained herein.   B           The information in this publication is subject to changeA           without notice and is provided "AS IS" WITHOUT WARRANTY @           OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OFB           THIS INFORMATION REMAINS WITH THE RECIPIENT. IN NO EVENT?           SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, D           INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVERE           (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS =           PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS >           INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE@           POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY?           REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER B           PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS INB           CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGALA           LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL (           PURPOSE OF ANY LIMITED REMEDY.  D           The limited warranties for Compaq products are exclusivelyD           set forth in the documentation accompanying such products.>           Nothing herein should be construed as constituting a)           further or additional warranty.   E                                                                ZK6434   B           The Compaq 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 0         1.3   Prerequisites for the InstallationC               Procedures....................................    1-3 C         1.4   Required Operating System Software............    1-3 2         1.5   Required ECO for POLYCENTER SoftwareC               Installation Utility..........................    1-6 ;         1.5.1     Upgrade Problem After Installing Required C                   PCSI ECO..................................    1-7 9         1.6   OSF/Motif Release 1.1.3 and XUI Programming C               Support.......................................    1-8 C         1.7   Saving Customized Bookreader Files............    1-9 C         1.8   Installation Procedure Requirements...........   1-10 C         1.8.1     Process Account Quotas....................   1-11 C         1.8.2     Disk Space................................   1-12 C         1.8.3     System Parameters.........................   1-14 /         1.8.4     Additional System Maintenance C                   Procedures................................   1-16 C         1.8.4.1     Checking System Parameter Values........   1-17 9         1.8.4.2     Calculating the Number of Free Global C                     Pages and Global Sections...............   1-17 C         1.8.4.3     Setting the Size of the Page File.......   1-18 :         1.8.4.4     Changing System Parameter Values UsingC                     the AUTOGEN Utility.....................   1-19 C         1.8.5     Backing Up Your System Disk...............   1-20 C         1.8.6     Notifying Other Users.....................   1-21         C                                                                 iii                    9     2  Using the POLYCENTER Software Installation Utility   E           2.1   Accessing Help Information....................    2-2 ;           2.2   Extracting and Printing the Product Release E                 Notes.........................................    2-3 E           2.3   Installing the Software.......................    2-4 E           2.3.1     Starting the Installation.................    2-5 E           2.3.2     The Installation Dialog...................    2-5 =           2.3.2.1     Verifying Sufficient Allocation for the E                       GBLPAGES and CLISYMTBL Values...........    2-6 E           2.3.2.2     Running AUTOGEN.........................    2-8 E           2.3.2.3     Saving the Programming Environment......    2-9 E           2.3.2.4     Default Installation....................   2-10 =           2.3.2.5     Asking About Selecting a Desktop (Alpha E                       Only)...................................   2-10 E           2.3.2.6     Programming Language Support Options....   2-11 E           2.3.2.7     Translated Image Support................   2-13 E           2.3.2.8     Language Variants Notice................   2-13 E           2.3.2.9     Reviewing the Installation Options......   2-13 E           2.3.2.10    Execution Dialog........................   2-14 8           2.3.2.11    Verifying DECwindows Motif SupportE                       Files...................................   2-15 E           2.3.2.12    Reviewing Final Installation Notes......   2-17 E           2.4   Recovering from Errors........................   2-17 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-9 E           3.2.6     Continuing the Installation...............   3-10 :           3.2.7     Preserving the OSF/Motif Release 1.1.3E                     Programming Environment...................   3-11 E           3.2.8     Installing the Entire Kit.................   3-12 E           3.2.9     Choosing Programming Support Files........   3-12 E           3.2.10    Verifying Kit Selections..................   3-13        iv                   I               3.2.11    Verifying Disk Space......................   3-14 I               3.2.12    Verifying License Registration............   3-16 I               3.2.13    Performing a System Reboot................   3-16 I               3.2.14    Reading Informational Messages............   3-17 ?               3.2.15    Using the AUTOGEN Utility to Set System I                         Parameters................................   3-19 I               3.2.16    Completing the Installation Procedure.....   3-21 I               3.3   Recovering from Errors........................   3-22 I               3.4   Accessing the Release Notes...................   3-22   (         4  After Installing the Software  I               4.1   Starting the DECwindows Motif Software........    4-1 I               4.1.1     Standalone Systems........................    4-3 I               4.1.2     OpenVMS Cluster Systems...................    4-3 I               4.1.2.1     Starting Nonsatellite and Boot Nodes....    4-3 I               4.1.2.2     Starting Satellite Nodes................    4-4 I               4.2   Running the IVP...............................    4-5 I               4.3   Choosing an Alternate Console.................    4-7 I               4.4   Selecting the Desktop (Alpha Only)............    4-7   -         5  Managing DECwindows Motif Software   A               5.1   Customizing the DECwindows X11 Display Server I                     Startup Procedure.............................    5-1 <               5.2   Using the DECW$MOTIF_TAILOR Utility (VMSI                     Version 5.5-2 Only)...........................    5-8 I               5.3   Adding DECwindows Base-Support Files..........   5-14 B               5.3.1     Reconfiguring the OpenVMS Operating SystemI                         (Alpha Only)..............................   5-15 <               5.3.2     Using the SYS$UPDATE:DECW$TAILOR.EXEI                         Command (VAX Only)........................   5-15 I               5.4   Determining and Reporting Problems............   5-20   :         A  POLYCENTER Software Installation Utility Sample            Installations  ;               A.1   Sample Installation on an OpenVMS Alpha I                     Version 7.1-2 System..........................    A-2 A               A.2   Sample Installation on an OpenVMS VAX Version I                     7.1 System....................................    A-7 ;               A.3   Sample Installation on an OpenVMS Alpha I                     Version 6.2 System............................   A-11     I                                                                         v                    $     B  VMSINSTAL Sample Installation  <           B.1   Sample Installation Using VMSINSTAL on a VMSE                 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-12   E           5-2       Sample DECW$TAILOR Session................   5-18   <           A-1       Sample Installation of the Mandatory ECOE                     for PCSI on an OpenVMS Alpha System.......    A-2   8           A-2       Sample Installation of an Upgrade of8                     DECwindows Motif on an OpenVMS Alpha8                     Version 7.1-2 System With SufficientE                     System Resources..........................    A-4   8           A-3       Sample Installation of an Upgrade of:                     Compaq DECwindows Motif for OpenVMS on:                     an OpenVMS VAX Version 7.1 System WithE                     Insufficient System Resources.............    A-7   <           A-4       Sample Installation of the Mandatory ECOE                     for PCSI on an OpenVMS Alpha System.......   A-11   5           A-5       Sample Installation of an Upgrade 5                     of DECwindows Motif on an OpenVMS 9                     Alpha System With Insufficient System E                     Resources.................................   A-12   E           B-1       Sample Installation Using VMSINSTAL.......    B-1   
     Tables  =           1-1       Directories for Previous XUI or OSF/Motif E                     Programming Environments..................    1-8   7           1-2       Process Quotas for the Installation E                     Account...................................   1-11   6           1-3       Approximate Required Disk Space byE                     Component (in Blocks).....................   1-13        vi                   9               1-4       Minimum Required System Parameter I                         Values....................................   1-15   A               1-5       Required Number of Contiguous Free Global I                         Pages and Free Global Sections............   1-18   B               1-6       Recommended System Parameter Values to UseI                         with the ADD_ Option......................   1-20   I               5-1       DECwindows Keymap.........................    5-5   <               5-2       Classes of OpenVMS Files That Can Be:                         Removed with the DECW$MOTIF_TAILORI                         Utility...................................    5-9   =               5-3       Classes of Files That Can Be Added or I                         Removed with the DECW$TAILOR Utility......   5-16                                                         I                                                                       vii                              I         _________________________________________________________________   I                                                                   Preface                Intended Audience   E               This manual is intended for anyone who plans to install ;               Compaq DECwindows Motif for OpenVMS software.            Document Structure  I               This manual contains the following chapters and appendixes:   I               o  Chapter 1 discusses how to prepare for installing Compaq 7                  DECwindows Motif for OpenVMS software.   E               o  Chapter 2 discusses how to install Compaq DECwindows @                  Motif for OpenVMS using the POLYCENTER Software&                  Installation utility.  E               o  Chapter 3 discusses how to install Compaq DECwindows A                  Motif for OpenVMS using the VMSINSTAL procedure.   I               o  Chapter 4 provides startup procedures. This chapter also F                  includes a sample Installation Verification Procedure                  (IVP).   I               o  Chapter 5 discusses tuning, customizing the environment, ?                  removing unwanted files, and reporting errors.   >               o  Appendix A presents a sample DECwindows Motif;                  installation using the POLYCENTER Software G                  Installation utility on an OpenVMS Alpha Version 7.1-2 B                  system, an OpenVMS VAX Version 7.1 system, and anE                  OpenVMS Alpha Version 6.2 system. It also presents aG5                  sample installation of the PCSI ECO.   I               o  Appendix B shows a sample product installation using thedC                  VMSINSTAL procedure on a VMS Version 5.5-2 system.a  I                                                                        ixU t  n              B           o  Appendix C shows how to obtain a list of the softwareC              components for the Compaq DECwindows Motif for OpenVMS ?              product using the POLYCENTER Software Installation               utility.l       Related Documents   A           In addition to this manual, the following documents arenD           useful when installing Compaq DECwindows Motif for OpenVMS           software:   >           o  Compaq DECwindows Motif for OpenVMS Release Notes  D           o  Guide to the Compaq DECwindows Motif for OpenVMS CD-ROM  1           o  Getting Started With the New Desktop   :           o  Managing DECwindows Motif for OpenVMS Systems  ,           o  OpenVMS System Manager's Manual  A           o  OpenVMS System Management Utilities Reference Manual   A           o  A Comparison of System Management on OpenVMS AXP and               OpenVMS VAX  C           For additional information on the OpenVMS System Software B           Group (OSSG) products and services, access the following)           OpenVMS World Wide Web address:   '           http://www.openvms.compaq.com        Reader's Comments   7           Compaq welcomes your comments on this manual.   C           Please send comments to either of the follwing addresses:   +           Internet    openvmsdoc@compaq.com_  1           Mail        Compaq Computer Corporation_:                       OSSG Documentation Group, ZKO3-4/U08(                       110 Spit Brook Rd.+                       Nashua, NH 03062-2698I       x     o              -         How To Order Additional Documentation   ?               Use the following World Wide Web address to order '               additional documentation:d  1               http://www.openvms.compaq.com:8000/d           Conventionsa  B               Compaq DECwindows Motif for OpenVMS Alpha contains aF               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 ClusteraH               systems. Unless otherwise specified, references to OpenVMSG               Clusters or clusters in this document are synonymous withn               VMSclusters.  D               In this manual, every use of DECwindows and DECwindowsA               Motif refers to Compaq 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 thatIF                                you must hold down the key labeled CtrlH                                while you press another key or a pointing-                                device button.O  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.)  I                                In the HTML version of this document, thisIE                                convention appears as brackets, ratherR*                                than a box.              I                                                                        xi     i                8            . . .           Horizontal ellipsis points inA                            examples indicate one of the followinge)                            possibilities:   @                            o  Additional optional arguments in a:                               statement have been omitted.  @                            o  The preceding item or items can be9                               repeated one or more times._  E                            o  Additional parameters, values, or other 9                               information can be entered.   @           .                Vertical ellipsis points indicate the@           .                omission of items from a code exampleC           .                or command format; the items are omittede@                            because they are not important to the1                            topic being discussed.d  :           ( )              In command format descriptions,E                            parentheses indicate that you must enclose C                            the choices in parentheses if you choosei)                            more than one.   C           [ ]              In command format descriptions, brackets >                            indicate optional elements. You canC                            choose one, none, or all of the options.rB                            (Brackets are not optional, however, in?                            the syntax of a directory name in an ?                            OpenVMS file specification or in the.A                            syntax of a substring specification in 4                            an assignment statement.)  C           |                In command format descriptions, vertical1@                            bars separating items inside bracketsA                            indicate that you choose one, none, or 8                            more than one of the options.  A           { }              In command format descriptions, braces E                            surround a required choice of options; you A                            must choose one of the options listed.            xiih i  S                =               text style       This text style represents the.E                                introduction of a new term or the name.I                                of an argument, an attribute, or a reason..  I                                In the HTML version of this document, this A                                convention appears as italic text.a  >               italic text      Italic text indicates important>                                information, complete titles ofG                                manuals, or variables. Variables include.I                                information that varies in system messages.B                                (Internal error number), in commandE                                lines (/PRODUCER=name), and in commandoF                                parameters in text (where dd representsH                                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..  I               Monospace type   Monospace type indicates code examples and ;                                interactive screen displays..  G                                In the C programming language, monospace2D                                type in text identifies the following?                                elements: keywords, the names of.H                                independently compiled external functions?                                and files, syntax summaries, and.E                                references to variables or identifierso8                                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.o  D               numbers          All numbers in text are assumed to beI                                decimal unless otherwise noted. Nondecimal.H                                radixes-binary, octal, or hexadecimal-are4                                explicitly indicated.        I                                                                      xiii. .  .                    I                                                                         1.I         _________________________________________________________________   I                                         Preparing to Install the Softwaren    E               This chapter describes the preparation and requirementsgI               for installing Compaq DECwindows Motif for OpenVMS softwaretG               using either the POLYCENTER Software Installation utilityeF               or the VMSINSTAL procedure. Your Bill of Materials (BOM)I               specifies the number and contents of your media. Verify the.H               contents of your kit with this information. If your kit isI               damaged or if you find that parts are missing, contact your.$               Compaq representative.  F                 ________________________ Note ________________________  D                 Compaq strongly recommends that you read the releaseB                 notes before proceeding with the installation. TheD                 Compaq DECwindows Motif for OpenVMS product providesE                 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  F                 ______________________________________________________  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  B               o  Section 1.5, Required ECO for POLYCENTER Software%                  Installation Utility   I                                                                       1-1e t         %     Preparing to Install the Software       E           o  Section 1.6, OSF/Motif Release 1.1.3 and XUI Programmingm              Support  <           o  Section 1.7, Saving Customized Bookreader Files  =           o  Section 1.8, Installation Procedure RequirementsW       1.1 License Registration  @           Before you install and run Compaq DECwindows Motif for?           OpenVMS software on a newly licensed node or cluster,.A           you must first register a License Product AuthorizationrA           Key (License PAK) using the License Management Facility.B           (LMF). The License PAK is provided along with the kit ifC           you ordered the license and media together; otherwise, it.D           is provided separately to a location based on your license           order.  C           If you are installing Compaq DECwindows Motif for OpenVMS E           software as an update on a node or cluster already licensedaC           for this software, you have already completed the License.(           PAK registration requirements.  <           You must register and load your license for Compaq9           DECwindows Motif for OpenVMS before you run the ?           Installation Verification Procedure (IVP) and use the            software.s  E           To register a license, log in to the system manager account ?           (SYSTEM). Then choose one of the following options to            register the license:m  E           o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When thenE              procedure prompts you for information, respond with data #              from your License PAK.   B           o  At the DCL prompt, enter the LICENSE REGISTER command?              with the appropriate qualifiers that correspond toD%              License PAK information.1  @           If you plan to use Compaq DECwindows Motif for OpenVMS>           software on more than one node in a VMScluster, load@           the license on the other nodes after you complete this           installation.   C           For complete information about using LMF, see the OpenVMSE,           License Management Utility Manual.       1-2e o  .      I                                         Preparing to Install the Software.I                                                    1.2 Supported Hardwaref             1.2 Supported Hardware  A               Compaq DECwindows Motif for OpenVMS software can be7D               installed on any supported Alpha or VAX processor. ForC               a complete list of supported hardware, see the CompaqnG               DECwindows Motif for OpenVMS Software Product Description.               (SPD).  9         1.3 Prerequisites for the Installation Procedures   D               Before you can install and configure Compaq DECwindowsD               Motif for OpenVMS software, you must have the required@               versions of the OpenVMS operating system software,E               sufficient memory, and a license. (Refer to Section 1.1 A               for information about registering a License Productr'               Authorization Key [PAK].)   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..  I               ___________________________________________________________ I               Operating_System___________Installation_Method_____________.  I               OpenVMS Alpha Version 6.2  POLYCENTER Software InstallationN0               (or higher)                utility%               OpenVMS VAX Version 6.2.               (or higher)   I               VMS_Version_5.5-2__________VMSINSTAL_procedure_____________   .         1.4 Required Operating System Software  G               The Compaq DECwindows Motif for OpenVMS software requires.5               one of the following operating systems:S  @               o  OpenVMS Alpha Version 6.2, 7.1-2, 7.2-1, or 7.3  :               o  OpenVMS VAX Version 6.2, 7.1, 7.2, or 7.3  "               o  VMS Version 5.5-2  H               If your system is not running one of these versions beforeI               you attempt to install Compaq DECwindows Motif for OpenVMS, %               the installation fails.   I                                                                       1-3            %     Preparing to Install the Software_*     1.4 Required Operating System Software    B           A minimum of 16 MB of memory is required for OpenVMS VAXC           systems; 32 MB of memory is highly recommended. A minimum C           of 64 MB of memory is required for OpenVMS Alpha systems;C:           at least 128 MB of memory is highly recommended.  >           The OpenVMS operating system provides two subsets ofD           components to support Compaq DECwindows Motif for OpenVMS.C           To use Compaq DECwindows Motif for OpenVMS software, yournB           system should be running a version of the OpenVMS system1           that includes the following components:e  @           o  DECwindows Motif transports and base system support  B              This support is required to install Compaq DECwindowsA              Motif for OpenVMS and to run Compaq DECwindows MotifpA              for OpenVMS applications. During the installation ofsE              OpenVMS, you are prompted to specify whether you want toe!              install this option.   B              To determine whether this option was installed during=              the installation of OpenVMS, enter the followingn              command:   8              $ DIR SYS$LIBRARY:DECW$TRANSPORT_COMMON.EXE  A              See Section 5.3 for information on adding DECwindows A              base support files after OpenVMS has been installed.   B           o  DECwindows X11 display server for OpenVMS, fonts, andB              device drivers, which are necessary to display CompaqC              DECwindows Motif for OpenVMS applications or any other 9              X11 applications on your Alpha or VAX systemn  D              During the installation of OpenVMS, you are prompted to=              specify whether you want to install this option.   B              To determine whether this option was installed during=              the installation of OpenVMS, enter the following               command:w  2              $ DIR SYS$SYSTEM:DECW$SERVER_MAIN.EXE  D              If the DECW$SERVER_MAIN.EXE file is not on your system,C              you cannot display Compaq DECwindows Motif for OpenVMSuC              applications on your Alpha or VAX system. However, youfE              can run Compaq DECwindows Motif for OpenVMS applicationsfA              that display on a DECwindows X11 display server thatiD              runs on another system. The Compaq DECwindows Motif for       1-4o           I                                         Preparing to Install the SoftwareSI                                    1.4 Required Operating System SoftwareR    H                  OpenVMS installation procedure asks whether you want toG                  continue the installation without workstation support.n  E                  See Section 5.3 for information on adding DECwindowsvI                  device support files and 75- or 100-dpi font files after ,                  OpenVMS has been installed.  F                 ________________________ Note ________________________  F                 See the release notes and cover letter for the versionD                 of the OpenVMS operating system that you are runningE                 for more information about the DECwindows X11 displaya                 server.   F                 ______________________________________________________                                                            I                                                                       1-5e b  d      %     Preparing to Install the SoftwaremA     1.5 Required ECO for POLYCENTER Software Installation Utility     A     1.5 Required ECO for POLYCENTER Software Installation UtilityM  ?           If you are installing the Compaq DECwindows Motif fordC           OpenVMS software on an OpenVMS Version 6.2 or 7.1 system, B           you must first install an ECO to the POLYCENTER SoftwareB           Installation (PCSI) utility. See the Guide to the Compaq?           DECwindows Motif for OpenVMS CD-ROM for details about @           this ECO. OpenVMS Versions 7.2 and higher include thisD           functionality in the operating system; therefore, you needC           not apply this ECO if you are running OpenVMS Version 7.2s           or higher.  C           The following example shows a PCSI ECO installation on an B           OpenVMS Alpha Version 7.1 system (installations on other,           OpenVMS versions differ slightly):  &     $ PRODUCT INSTALL VMS62TO71U2_PCSI  ,     The following product has been selected:I         DEC AXPVMS VMS62TO71U2_PCSI V1.0       Patch (maintenance update)k  "     Do you want to continue? [YES]  $     Configuration phase starting ...  R     You will be asked to choose options, if any, for each selected product and forS     any products that may be installed to satisfy software dependency requirements.r  $     DEC AXPVMS VMS62TO71U2_PCSI V1.0  ;     * This product does not have any configuration options.         Execution phase starting ...  ;     The following product will be installed to destination: C         DEC AXPVMS VMS62TO71U2_PCSI V1.0       DISK$1:[VMS$COMMON.]o       Portion done: 0%
     ...10%
     ...40%
     ...70%
     ...80%
     ...90%     ...100%   -     The following product has been installed:rI         DEC AXPVMS VMS62TO71U2_PCSI V1.0       Patch (maintenance update)e       1-6l n         I                                         Preparing to Install the SoftwareiI             1.5 Required ECO for POLYCENTER Software Installation Utilityb    @         1.5.1 Upgrade Problem After Installing Required PCSI ECO  ?               After installing the required POLYCENTER SoftwaresD               Installation utility ECO, your system will use the newD               features provided by this version of the PCSI utility.F               If a layered product is installed that makes use of thisF               new functionality, then it may not be possible to revertF               back to an older version of the utility. The restrictionI               occurs because there may be records in the software product H               database that the older version of the utility will not be                able to interpret.  D               This scenario occurs if you install the PCSI ECO, thenA               install DECwindows Motif, and later install certain G               upgrades to the OpenVMS operating system. The steps belowt;               describe the situations when this will occur:   H               1. Install the PCSI ECO kit onto OpenVMS Version 6.2, 6.2-A                  1H1, 6.2-1H2, 6.2-1H3, 7.1, 7.1-1H1, or 7.1-1H2.o  8               2. Install DECwindows Motif Version 1.2-6.  H               3. Upgrade to (or reinstall) OpenVMS Version 6.2, 6.2-1H1,<                  6.2-1H2, 6.2-1H3, 7.1, 7.1-1H1, or 7.1-1H2.  E               Upgrading to any of the OpenVMS versions listed in itemtD               3 may fail (or other PRODUCT command operations on theB               product database may fail) with one of the following               errors:   5               %SYSTEM-F-ACCVIO, access violation, ... N               %PCSI-E-UNSDOCENC, unsupported product document encoding version  I               To prevent these failures after installing the PCSI ECO ande<               DECwindows Motif, perform the following steps:  E               1. Remove DECwindows Motif using the following command:   )                  $ PRODUCT REMOVE DWMOTIFs  H               2. Upgrade to (or reinstall) OpenVMS Version 6.2, 6.2-1H1,<                  6.2-1H2, 6.2-1H3, 7.1, 7.1-1H1, or 7.1-1H2.  (               3. Reinstall the PCSI ECO.  ,               4. Reinstall DECwindows Motif.  I                                                                       1-7  t         %     Preparing to Install the SoftwareiA     1.5 Required ECO for POLYCENTER Software Installation Utilityp    C           This workaround is not needed if you upgrading to OpenVMSiC           Alpha Version 7.2-1 or higher, or if you are upgrading tosD           OpenVMS VAX Version 7.2 or higher. These versions (and allE           later versions) already include the new functionality addede           by the PCSI ECO.  ;     1.6 OSF/Motif Release 1.1.3 and XUI Programming Support   @           The X Window and OSF/Motif libraries that are provided?           with Compaq DECwindows Motif for OpenVMS software are B           incompatible with those libraries provided with versionsD           of DECwindows Motif for OpenVMS prior to Version 1.2. Run-D           time compatibility is preserved, but the earlier OSF/Motif@           Release 1.1.3 and XUI programming environments are notE           compatible with the later OSF/MOTIF Release 1.2 programmingr           environment.  <           Programming in the XUI and OSF/Motif Release 1.1.3@           environments that was provided in previous versions of?           DECwindows Motif is no longer supported in the Compaqe<           DECwindows Motif for OpenVMS product. However, theC           installation procedure gives you the option of saving theo@           XUI and OSF/Motif Release 1.1.3 programming files thatC           already exist on your system. If you choose to save theseeC           programming files, they are moved to subdirectories whereo@           you can access them for programming. Specifically, theC           installation creates a subdirectory called [.DECW$113] inuC           each of the directories listed in Table 1-1 and moves thee?           previous files into the new [.DECW$113] subdirectory.m  C     Table 1-1 Directories for Previous XUI or OSF/Motif ProgrammingrE     __________Environments___________________________________________   E     Directory_____Contents____New_Location___________________________   A     DECW$INCLUDE  C header    SYS$SYSROOT:[DECW$INCLUDE.DECW$113]                    files   ;     SYS$SYSTEM    UIL         SYS$SYSROOT:[SYSEXE.DECW$113]_                   compiler  E                                              (continued on next page)r           1-8t S  w      I                                         Preparing to Install the Software I                   1.6 OSF/Motif Release 1.1.3 and XUI Programming Support     C         Table 1-1 (Cont.) Directories for Previous XUI or OSF/Motif I         __________________Programming_Environments_______________________   I         Directory_____Contents____New_Location___________________________   ?         SYS$LIBRARY   Non-C       SYS$SYSROOT:[SYSLIB.DECW$113]                        languageI         ______________bindings___________________________________________t  E               Refer to Section 3.2.7 for additional information about_7               saving previous programming environments.o  F                 ________________________ Note ________________________  ;                 The process for using the saved programmingMF                 environment is documented in the programmer chapter of"                 the release notes.  F                 ______________________________________________________  .         1.7 Saving Customized Bookreader Files  I               The installation procedure replaces the following file withS               a new version:  ;               SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF   G               If you customized this file and want to save it, copy the C               file to another directory or rename the file prior to E               the installation of Compaq DECwindows Motif for OpenVMS 1               software so that it is not deleted.   G               To copy your customized file to another directory, create B               the directory and define a global symbol in the file*               DECW$PRIVATE_APPS_SETUP.COM.  5               To create a Bookreader directory calledIH               SYS$COMMON:[DECW$BOOK_LOCAL], perform the following steps:  E               1. Create the directory and assign world read access asw                  follows:c  8                  $ CREATE/DIRECTORY/PROTECTION=WORLD:R -0                  _$ SYS$COMMON:[DECW$BOOK_LOCAL]  I                                                                       1-9e e  q      %     Preparing to Install the Software *     1.7 Saving Customized Bookreader Files    <           2. Copy the LIBRARY.DECW$BOOKSHELF file to the new"              directory as follows:  C              $ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF -c1              _$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG   >           3. If the SYS$MANAGER directory does not contain the?              DECW$PRIVATE_APPS_SETUP.COM command file, copy thei8              template file to a command file as follows:  B              $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE -;              _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOGu  A           4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and definewD              the global symbol DECW$BOOK to point to your Bookreader@              directory by adding the following line to the file:  :              $ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]"  D           5. Restart DECwindows Motif using the following command ifB              you performed step 4 after installing the product andD              after DECwindows had been started (for example, after a              reboot):o  0              $ @SYS$MANAGER:DECW$STARTUP RESTART  @           For more information about customizing your DECwindows>           Motif environment, see Managing DECwindows Motif for           OpenVMS Systems.  +     1.8 Installation Procedure Requirements   D           This section discusses the requirements for installing theE           Compaq DECwindows Motif for OpenVMS software using PCSI and /           the VMSINSTAL installation procedure.t  :           The installation procedure checks the following:  E           o  Whether you are logged in to an appropriately privilegedl3              account (VMSINSTAL installations only)o  @           o  Whether any other users are logged in to the system  A           o  Whether you have the minimum required system account               quotas and limits  =           o  Whether you have the minimum required disk space   C           o  Whether you have the minimum required system parameterd              values        1-10 w  o      I                                         Preparing to Install the SoftwareoI                                   1.8 Installation Procedure Requirementss    I               See Section 3.1 for information on requirements specific toc&               VMSINSTAL installations.  $         1.8.1 Process Account Quotas  G               The installation procedure requires that the installationE@               account has the minimum quotas shown in Table 1-2.  I               Table_1-2_Process_Quotas_for_the_Installation_Account______,  I               Quota_Name__Alpha_Value___VAX_Value________________________   .               ASTLM          250            24  .               BIOLM          150            18  /               BYTLM        64,000        32,768n  .               DIOLM          150            18  .               ENQLM         2,000           30  I               FILLM__________100____________20___________________________   G               Use the OpenVMS AUTHORIZE utility to verify and to change_E               process quotas for the installation account in the useroH               authorization file (UAF). (Some sites may restrict the useE               of the AUTHORIZE utility to certain accounts or users.)iI               For example, to change the BYTLM quota for the account-name A               installation account, enter the following commands:_  &               $ SET DEFAULT SYS$SYSTEM               $ RUN AUTHORIZE $               UAF> SHOW account-name5               UAF> MODIFY account-name /BYTLM = 32768g$               UAF> SHOW account-name               UAF> EXIT6               $ LOGOUT  G               After you change the quotas for the installation account, F               log out of the installation account and log in again forF               the new quotas to take effect. You can then proceed with               the installation.   8               User account quotas are stored in the fileI               SYS$SYSTEM:SYSUAF.DAT. For more information about modifying B               account quotas, see the description of the AUTHORIZE@               utility in the OpenVMS System Management Utilities               Reference Manual.m  I                                                                      1-11e y         %     Preparing to Install the Software +     1.8 Installation Procedure Requirementsn         1.8.2 Disk Space  B           Use Table 1-3 to determine the amount of free disk spaceC           that is required on the system disk to install DECwindows ?           Motif components. However, because you can choose noto?           to install all the components, your actual disk spacec"           requirement may be less.  D           To determine the number of free blocks on the system disk,8           enter the following command at the DCL prompt:  %           $ SHOW DEVICE SYS$SYSDEVICEt  B           The installation procedure checks for free disk space onD           the system disk. If sufficient space is not available, the@           installation procedure provides the following options:  *           o  Install fewer optional files.  B           o  For VMSINSTAL installations, restart the installationD              and specify another disk to use as an alternate workingE              device. See Section 3.1.2 for information about using anf&              alternate working device.  D           o  Terminate the installation, create more free disk space>              on the system disk, and restart the installation.  C           o  Continue the installation and risk running out of disk               space.o  C              ________________________ Note ________________________y  9              If you run out of free disk space during thei<              installation, the installation procedure fails.  C              ______________________________________________________e                       1-12 i         I                                         Preparing to Install the SoftwareaI                                   1.8 Installation Procedure RequirementsI    H               Table 1-3 Approximate Required Disk Space by Component (inI               __________Blocks)__________________________________________n  I               Component_____________Alpha_________VAX____________________o  9               Base kit[1]            65,818        81,891   9                    Runtime support  Not            66,021n.                                     applicable  9                    CDA support      Not             3,650 .                                     applicable  9                    Motif            Not            12,220f.                    applications     applicable  @               Desktop support        71,066[2]    Not applicable  @                    New Desktop       47,314       Not applicable  @                    DECwindows        20,952       Not applicable                    desktop  @                    Manual pages       2,800       Not applicable                    for                    New Desktop  <               Programming            63,192[3]     13,500[2]               environmentv  9                    C, C++            19,916         8,190y  9                    FORTRAN           14,792         2,187e  9                    Pascal            15,656         3,123   @                    New Desktop       12,828       Not applicable  9               Example programs       51,652[4]     12,672   @                    Sound examples    14,220       Not Applicable  I               [1]This_number_includes_all_base_kit_files._For_Alpha______f  F               systems, the indicated subcomponents are always included               in the base kit.H               [2]This number includes all desktop support. The number ofI               blocks required for the individual desktop options is shown                in the subtable.G               [3]This number includes all programming language support..E               The actual number of blocks required for the individual-=               programming languages is shown in the subtable.2G               [4]This number includes all examples programs. The actual;B               number of blocks required for the individual example0               programs is shown in the subtable.  I                                                  (continued on next page)   I                                                                      1-13e o  d      %     Preparing to Install the Software6+     1.8 Installation Procedure Requirements     >           Table 1-3 (Cont.) Approximate Required Disk Space byE           __________________Component_(in_Blocks)____________________f  E           Component_____________Alpha_________VAX____________________i  5                Programming       23,440        12,672s                examples   <                New Desktop       13,992       Not Applicable                examples   <           Translated image       39,632       Not applicable           supportr  8           NCSA Mosaic           Not             1,200[5]*                                 applicable  5           Total disk space      291,360       109,263e           required: E           [5]NCSA_Mosaic_available_only_on_VMS_5.5-2_systems.________l  E           ___________________________________________________________1  A           For VMSINSTAL installations, refer to Section 3.1.2 for >           information on using an alternate working device and@           Section 3.1.3 for information on using the Distributed           File Service.        1.8.3 System Parametersn  ?           Table 1-4 lists the minimum required system parameterq@           values for the installation. Depending on the kinds ofC           programs and applications running at your site, you mighti/           need higher values for some settings.a                           1-14 m  s      I                                         Preparing to Install the SoftwareeI                                   1.8 Installation Procedure Requirements     I               Table_1-4_Minimum_Required_System_Parameter_Values_________                  SystemI               Parameter________Alpha_Value___VAX_Value___________________e  8               GBLSECTIONS           600[1]        420[1]  9               GBLPAGES           150,000[1]     62,000[1]a  6               GBLPAGFIL            1,024         6,024  5               SWPOUTPGCNT           512           500i  6               MAXBUF               8,192         2,048  6               VIRTUALPAGECNT        -           50,000  5               CHANNELCNT            255           255r  5               PROCSECTCNT            64            40e  6               PQL_DPGFLQUOTA        -           32,768  3               PQL_MPGFLQUOTA      32,768          -2  5               PQL_MASTLM            100           100r  5               PQL_MBIOLM            100           100   6               PQL_MBYTLM         100,000        48,000  5               PQL_MDIOLM            100           100   5               PQL_MENQLM            300           200   5               PQL_MFILLM            100           100P  5               PQL_MPRCLM             10             8r  5               PQL_MWSDEFAULT       1,024          512t  6               PQL_MWSQUOTA         2,048         1,024  6               PQL_MWSEXTENT        8,192         2,048  5               CLISYMTBL             512           256   I               [1]If_you_have_installed_other_software_that_uses_global___)  G               pages or global sections, you might need a higher minimum-C               value. When you boot your system and DECwindows Motif E               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 DECwindowsoE               Motif startup procedure prints a warning and provides ae5               recommended value for these parameters.   I                                                  (continued on next page).  I                                                                      1-15d h  e      %     Preparing to Install the Software +     1.8 Installation Procedure RequirementsU    E           Table_1-4_(Cont.)_Minimum_Required_System_Parameter_Values_a             SystemE           Parameter________Alpha_Value___VAX_Value___________________   /           GH_RES_CODE          1,024[2]       -s  /           IMGREG_PAGES         2,000[2]       -o  1           WINDOW_SYSTEM           1             1i  2           NPAGEDYN          1,998,848      999,936  2           PAGEDYN            600,000       400,000  2           WSMAX               12,000         4,096E           [2]This_system_parameter_is_available_only_on_OpenVMS_AlphaX  *           Version 6.2 (or higher) systems.E           ___________________________________________________________s  D              _______________________ Caution _______________________  :              If you do not ensure that your system has theA              necessary number of global pages and global sectionso<              for the installation, the DCL tables can become              corrupted.u  C              ______________________________________________________s  2     1.8.4 Additional System Maintenance Procedures  @           This section explains how to use the System Generation=           utility (SYSGEN) and the AUTOGEN utility to preparetA           your system for the Compaq DECwindows Motif for OpenVMSiE           installation. The AUTOGEN utility uses system configuration 6           data to automatically set system parameters.  C              ________________________ Note _________________________  :              The DECwindows Motif installation and startup?              procedures automatically check for required system @              parameter values and pass the appropriate values toA              AUTOGEN. Therefore, in most cases you do not have to 4              check and modify these values manually.  C              ______________________________________________________        1-16 I  a      I                                         Preparing to Install the SoftwarenI                                   1.8 Installation Procedure RequirementsS    0         1.8.4.1 Checking System Parameter Values  G               To check the values of your system parameters, invoke theaI               SYSGEN utility by entering the following command at the DCLY               prompt:   %               $ RUN SYS$SYSTEM:SYSGEN                SYSGEN>_  I               At the SYSGEN prompt, enter the SHOW command to display the3I               value of a system parameter. The following command displaysa8               the value for the MAXBUF system parameter:  !               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 in_@               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.O  F         1.8.4.2 Calculating the Number of Free Global Pages and Global                 Sections  E               If your system parameter values are equal to or greaterpE               than the minimum values specified in Table 1-4, you can I               continue with the product installation. However, to install C               and run Compaq DECwindows Motif for OpenVMS software, C               you must have sufficient free global pages and global E               sections for the DECwindows Motif software and the filer(               SYS$LIBRARY:DCLTABLES.EXE.  D               First, determine how many free global pages and globalE               sections exist on your system and how many are requiredfF               to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE.I               Then, if necessary, use the AUTOGEN utility to increase the G               values of the GBLPAGES and GBLSECTIONS system parameters.r  H               Enter the following DCL command to determine the number ofB               global pages required for SYS$LIBRARY:DCLTABLES.EXE:  2               $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE  C               This command returns the size (in blocks) of the fileOF               SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use thisG               figure as the number of global pages needed for the file.f  I                                                                      1-17            %     Preparing to Install the Software.+     1.8 Installation Procedure RequirementsP    D           Enter the WRITE command with the F$GETSYI lexical functionD           to find the number of contiguous free global pages and theE           number of free global sections. The following example showslC           how to obtain this information at your terminal, which isK%           the default for SYS$OUTPUT:d  A           $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") <Return>s           15848l?           $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") <Return>t           24  E           See Table 1-5 to determine whether the number of contiguousAE           free global pages and the number of free global sections isED           sufficient. If these values are not sufficient to continue@           with the installation, then see Section 1.8.4.4, whichD           describes the procedures for increasing these values using           the AUTOGEN utility.  C           Table 1-5 Required Number of Contiguous Free Global PagesME           __________and_Free_Global_Sections_________________________e  E           _____________Currently_Running_DECwindows_Motif____________p  E           System_Resource__Alpha_Value___VAX_Value___________________y  /           CONTIG_GBLPAGES  12,000         6,000e  .           FREE_GBLSECTS       20            20  E           ___________________________________________________________ E           ___________Not_Currently_Running_DECwindows_Motif__________   E           System_Resource__Alpha_Value___VAX_Value___________________   /           CONTIG_GBLPAGES  92,000        47,000   E           FREE_GBLSECTS______260___________130_______________________   -     1.8.4.3 Setting the Size of the Page FileR  >           In order for DECwindows Motif to run with acceptableC           performance, the page file must be large enough to handle E           the virtual memory requirements of your system. The optimalpD           size of the page file depends on many factors, such as theE           amount of physical memory on the system and the application_           work load.       1-18 _  ,      I                                         Preparing to Install the Software I                                   1.8 Installation Procedure Requirements     F               As a general rule, the page file size should be at leastI               75,000 blocks on OpenVMS Alpha systems and 50,000 blocks on H               OpenVMS VAX systems. However, these sizes may be too smallI               on systems where a large number of applications are run. On I               a heavily loaded system it may be possible to achieve large I               performance improvements by increasing the size of the pagea.               file by a factor of two or more.  C               Normally you should run AUTOGEN with feedback and lettF               AUTOGEN calculate the size of the page file based on theI               usage pattern on your system. To run AUTOGEN with feedback,Y.               enter the following DCL command:  =               $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK-  H               You can also increase the size of the page file by runningE               the SYSGEN utility or by invoking the command procedureq'               SYS$UPDATE:SWAPFILES.COM.   E               For more information about setting the size of the page F               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 Performancet               Management.   B         1.8.4.4 Changing System Parameter Values Using the AUTOGEN                 UtilityV  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. TolB               change system parameters with AUTOGEN, edit the file'               SYS$SYSTEM:MODPARAMS.DAT.f  I               To change a parameter value listed in this file, delete theCH               current value associated with that parameter and enter the               new value.  H               To add a new parameter, add a line to the file and includeH               both the name of the parameter and its value. For example:                 MIN_MAXBUF = 8192n  D               To make incremental adjustments to parameters, such asG               global pages and global sections, use ADD_. The followinghA               example increases the global pages value by 30,000:   "               ADD_GBLPAGES = 30000  I                                                                      1-19  r  S      %     Preparing to Install the Softwaren+     1.8 Installation Procedure Requirementse    @           Table 1-6 lists the system parameters that you need to           adjust incrementally.   C           Table 1-6 Recommended System Parameter Values to Use withOE           __________the_ADD__Option__________________________________               System           AlphaE           Parameter________Increment_____VAX_Increment_______________   /           SYSMWCNT         -                235   /           GBLSECTIONS         280           140r  0           GBLPAGES          92,000        30,000  0           GBLPAGFIL           768          5,000  0           NPAGEDYN         300,000       500,000  E           PAGEDYN__________180,000_______100,000______________________  B           After you enter all your changes, exit from the file and@           execute the AUTOGEN utility to recalculate your systemE           parameters. Enter the following command to recalculate yourq2           system parameters and reboot the system:  .           $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT  B           When you specify REBOOT, the AUTOGEN utility performs anD           automatic system shutdown and then reboots the system. AnyD           users logged in to the system are immediately disconnected@           during the shutdown. The automatic reboot puts the new'           parameter values into effect.a  D           For details about using AUTOGEN, see the section about theD           AUTOGEN utility in the OpenVMS System Manager's Manual andD           the AUTOGEN section in OpenVMS System Management Utilities           Reference Manual.a  %     1.8.5 Backing Up Your System Disk   =           Compaq recommends that you back up your system diskeB           before you install any software. At the beginning of the?           installation, the installation procedure asks whether B           your system disk is backed up. Use the backup procedures>           that are established at your site. For details aboutA           performing a system disk backup, see the section on the C           Backup utility in the OpenVMS System Management Utilities            Reference Manual.c       1-20 1         I                                         Preparing to Install the SoftwarelI                                   1.8 Installation Procedure Requirements     #         1.8.6 Notifying Other Users   C               Inform users on the system that you plan to install aiI               product and that they must log out during the installation. F               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 followingR+                  command at the DCL prompt:s  M                  $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of -GR                  _$ Compaq DECwindows Motif for OpenVMS, Version 1.2--6 please..."  I               2. Enter the following command at the DCL prompt to preventIC                  nonprivileged users from logging in to the system:S  +                  $ SET LOGINS/INTERACTIVE=0s  I               If possible, give users an estimated time when they can loga%               in to the system again.i                                                  I                                                                      1-21  1                       I                                                                         2eI         _________________________________________________________________i  I                        Using the POLYCENTER Software Installation Utility     H               This chapter describes how to install and configure CompaqH               DECwindows Motif for OpenVMS software using the POLYCENTERE               Software Installation utility on Alpha and VAX systems.IF               The Compaq DECwindows Motif for OpenVMS product supportsI               POLYCENTER Software installations using the Digital Command '               Language (DCL) interface.u  C               This chapter presents information about the followings               topics:e  8               o  Section 2.1, Accessing Help Information  I               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 provides ?               information about several useful topics, such as:_  ,               o  Removing installed products  1               o  Reconfiguring installed productsD  7               o  Copying software kits to new locationsp  /               o  Retrieving product information   G               o  Discussing differences between the POLYCENTER Software0A                  Installation utility and the VMSINSTAL procedurei  I                                                                       2-1c t  e      6     Using the POLYCENTER Software Installation Utility      A           Refer to Section 1.4 for information about prerequisitep            software and licenses.  C              ________________________ Note ________________________l  =              You must use the VMSINSTAL Software Installation @              utility to install DECwindows Motif software on VMS#              Version 5.5-2 systems.   C              ______________________________________________________   D              _______________________ Caution _______________________  =              If you do not have a satisfactory backup copy of,?              your system disk, do not attempt to install Compaq ?              DECwindows Motif for OpenVMS software. Back up them=              system disk (as described in the OpenVMS upgraded>              and installation supplement for your Alpha or VAXB              processor) before you install Compaq DECwindows Motif"              for OpenVMS software.  9              Before beginning the installation procedure,c@              review Chapter 1 for information about installation+              preparations and requirements.   C              ______________________________________________________   "     2.1 Accessing Help Information  D           Online help is available with the installation utility forE           all PRODUCT commands and qualifiers. For help on a specifichE           command, enter the DCL command HELP followed by the commandY           and product name.   @           Refer to the following documents for information about4           tasks and PRODUCT commands and qualifiers:  ,           o  OpenVMS System Manager's Manual  A           o  OpenVMS System Management Utilities Reference Manuale  #           o  OpenVMS DCL Dictionaryc           2-2  a  e      I                        Using the POLYCENTER Software Installation Utility I                     2.2 Extracting and Printing the Product Release Notest    =         2.2 Extracting and Printing the Product Release Notesf  E               Before you begin the installation procedure, you shouldtD               read the product's release notes. To extract a copy ofD               the Compaq DECwindows Motif for OpenVMS Release Notes,F               define PCSI$SOURCE to point to the location (device nameD               and directory) of the PCSI kit. Then enter the PRODUCTI               EXTRACT RELEASE_NOTES command followed by the product name, )               DWMOTIF, at the DCL prompt.e                                                                        I                                                                       2-3r s         6     Using the POLYCENTER Software Installation Utility9     2.2 Extracting and Printing the Product Release Notesp               For example:  =           $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF126] 1           $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIFS  E           Once you extract the release notes to a file, you can printeD           the file. Note that you do not need to install the product/           before you extract the release notes.y  C           The Compaq DECwindows Motif for OpenVMS Release Notes arel@           also available in HTML and ASCII (.TXT) formats in theD           documentation directory on the Compaq DECwindows Motif forE           OpenVMS CD-ROM. Refer to the Guide to the Compaq DECwindows B           Motif for OpenVMS CD-ROM for information about accessingE           the release notes and other DECwindows Motif documentation.l       2.3 Installing the Softwarea  D              ______________________ Important ______________________  >              If you are installing Compaq DECwindows Motif forB              OpenVMS software on an OpenVMS Version 7.1 or VersionC              6.2 system, you must install an ECO for the POLYCENTER @              Software Installation utility before installing theC              DECwindows Motif software. See the Guide to the Compaq_B              DECwindows Motif for OpenVMS CD-ROM for details about<              this ECO. See Section 1.5 for more information.  C              ______________________________________________________   >           The sections that follow take you through the stages@           of installing your Compaq DECwindows Motif for OpenVMS=           software using the POLYCENTER Software InstallationtA           utility. The installation procedure is nearly identicaln#           on Alpha and VAX systems.k  B           Refer to Chapter 1 for information about account quotas,,           disk space, and system parameters.  C           Refer to the OpenVMS System Manager's Manual for complete <           information about responding to questions that the>           POLYCENTER Software Installation utility asks during@           product installation. For example, when you respond to.           questions, you can do the following:  =           o  Enter a value and press the Return key to select               options.N  ;           o  Press the Return key to accept default values.        2-4,           I                        Using the POLYCENTER Software Installation Utility I                                               2.3 Installing the Software     (               o  Confirm your responses.  D                  After you respond to questions by selecting optionsF                  or accepting default values, the installation utility4                  displays a summary of your answers.  D                  Then a question is displayed asking whether you areD                  satisfied with your answers and whether you want toH                  continue with the installation. If you decide to changeF                  your responses, type No and press the Return key. YouH                  can then either reenter your responses or answer No and4                  exit from the installation utility.  :               o  Stop the installation by pressing Ctrl/Y.  :                  Note that this option is not recommended.  '         2.3.1 Starting the Installation   D               To start the POLYCENTER Software Installation utility,D               enter one of the following commands at the DCL prompt:  A               $ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF126]n                 or  ?               $ DEFINE PCSI$SOURCE device:[PCSI_VAX_DWMOTIF126]d  A               where device is the name of the device on which the_-               distribution CD-ROM is mounted._  H               Next, invoke the POLYCENTER Software Installation utility:  '               $ PRODUCT INSTALL DWMOTIFa  %         2.3.2 The Installation Dialog   F               The installation dialog begins by displaying the name ofI               the product which PCSI is installing. You are then asked to I               verify that you wish to continue with the installation. The I               dialog continues with a display of product name, copyright, >               and Product Authorization Key (PAK) information.  0         The following product has been selected:B             DEC AXPVMS DWMOTIF V1.2-6              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.i  I                                                                       2-5t .  p      6     Using the POLYCENTER Software Installation Utility     2.3 Installing the Software     /     DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif   L         Compaq DECwindows Motif for OpenVMS Alpha, Version 1.2-6 is based onA         Release 5 (R5) of the MIT X11 Window System and OSF/Motif          Version 1.2.3.  M         DECwindows Motif V1.2-6 provides both runtime support and development_K         support for the X Window system. Runtime and development support isaK         provided for MIT X11 Release 5 and OSF/Motif Version 1.2.3. Runtime =         only support is provided for OSF/Motif Version 1.1.3.0  2         Copyright 2000 Compaq Computer Corporation  J         COMPAQ and the Compaq logo Registered in U.S. Patent and Trademark         Office.   I         Motif is a registered trademark and The Open Group is a trademark F         of The Open Group in the United States and/or other countries.  D         Confidential computer software. Valid license from Compaq orI         authorized sublicensor required for possession, use , or copying.PL         Consistent with FAR 12.211 and 12.212, Commercial Computer Software,J         Computer Software Documentation, and Technical Data for CommercialI         Items are licensed to the U.S. Government under vendor's standardD         commercial license.   #         Compaq Computer Corporation   E         This software product is sold by Compaq Computer Corporation.   +         This product uses the PAK: DW-MOTIF1  K         This software is furnished under the licensing provisions of Compaq J         Computer Corporation's Standard Terms and Conditions. For more in-K         formation about Compaq's licensing terms and policies, contact your          local Compaq office.  @     2.3.2.1 Verifying Sufficient Allocation for the GBLPAGES and             CLISYMTBL Values  C              ________________________ Note ________________________   B              If you are simultaneously installing or upgrading theB              OpenVMS operating system with DECwindows from the CD-B              ROM, the installation procedure will continue without       2-6n B  C      I                        Using the POLYCENTER Software Installation UtilitydI                                               2.3 Installing the Software     D                 checking your system values. It will check after the;                 installation is complete (see Section 2.5).   F                 ______________________________________________________  F               The installation command procedure checks to ensure thatH               adequate values are allocated for GBLPAGES, CLISYMTBL, and)               NPAGEDYN system parameters:_  D               o  On OpenVMS Alpha systems, the minimum value for theE                  GBLPAGES system parameter is 150,000; on OpenVMS VAXE6                  systems, the minimum value is 62,000.  D               o  On OpenVMS Alpha systems, the minimum value for theB                  CLISYMTBL system parameter is 512; on OpenVMS VAX3                  systems, the minimum value is 256.p  D               o  On OpenVMS Alpha systems, the minimum value for theG                  NPAGEDYN system parameter is 1,998,848; on OpenVMS VAX 7                  systems, the minimum value is 999,936.   D               If your system values are sufficient, the installationF               procedure continues. If the values are insufficient, theF               procedure abandons the installation and instructs you toG               run AUTOGEN and then restart the installation. On OpenVMS H               Alpha systems, the procedure displays a message similar to               the following:  /         Checking values of system parameters...e  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 valuespP           require modification to install the DECwindows Motif Version 1.2-6 for           OpenVMS software.i  Q           Please type the following command to run AUTOGEN and reboot your systemtR           before restarting the DECwindows installation.  This will set the systemO           parameters to appropriate values for running DECwindows Motif V1.2-6.   A                 @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK   8         The DECwindows installation is being terminated.  8         Please run AUTOGEN and restart the installation.  I                                                                       2-7t           6     Using the POLYCENTER Software Installation Utility     2.3 Installing the Software_    &     %PCSI-E-S_OPFAIL, operation failedQ     %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error conditionC  @           A similar message is displayed on OpenVMS VAX systems.       2.3.2.2 Running AUTOGEN   ?           If the installation procedure has prompted you to run D           AUTOGEN to correct your system values, enter the following           command:  =           $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK   C           The system runs AUTOGEN and produces a log similar to the            following example:  1     %AUTOGEN-I-BEGIN, GETDATA phase is beginning.fL     %AUTOGEN-I-NEWFILE,  Previous contents of SYS$SYSTEM:CLU$PARAMS.DAT haveF       been copied to SYS$SYSTEM:CLU$PARAMS.OLD.  You may wish to purge        SYS$SYSTEM:CLU$PARAMS.OLD.P     %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:PARAMS.DAT has been created.,             You may wish to purge this file.=     %AUTOGEN-I-END, GETDATA phase has successfully completed.E3     %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning. T     %AUTOGEN-I-NEWFILE, A new version of SYS$MANAGER:VMSIMAGES.DAT has been created.,             You may wish to purge this file.S     %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:SETPARAMS.DAT has been created.s,             You may wish to purge this file.?     %AUTOGEN-I-END, GENPARAMS phase has successfully completed.s2     %AUTOGEN-I-BEGIN, GENFILES phase is beginning.  M     %AUTOGEN-I-REPORT, AUTOGEN has produced some informational messages whichiP             have been stored in the file SYS$SYSTEM:AGEN$PARAMS.REPORT.  You may8             wish to review the information in that file.  >     %AUTOGEN-I-END, GENFILES phase has successfully completed.3     %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning. *     %AUTOGEN-I-SYSGEN, parameters modified?     %AUTOGEN-I-END, SETPARAMS phase has successfully completed.n0     %AUTOGEN-I-BEGIN, REBOOT phase is beginning.  D     The system is shutting down to allow the system to boot with the<     generated site-specific parameters and installed images.  C     The system will automatically reboot after the shutdown and the1     upgrade will be complete.        2-8  I  P      I                        Using the POLYCENTER Software Installation UtilityeI                                               2.3 Installing the Software_    >                 SHUTDOWN -- Perform an Orderly System Shutdown*                             on node MYNODE  A               You can now restart the installation procedure (seeh               Section 2.3.1).   2         2.3.2.3 Saving the Programming Environment  E               The installation procedure checks whether the OSF/MotifoB               Release 1.1.3 programming environment exists on yourB               system. If it is present, the installation procedureE               displays the following information and asks whether youwB               want to save the OSF/Motif Release 1.1.3 programming               environment:  O               The DECwindows Motif programming environment was installed with agU               previous version of this kit. This environment is incompatible with theaV               OSF/Motif Release 1.2 environment provided with DECwindows Motif VersionL               1.2-6. The XUI programming environment is also not included in-               DECwindows Motif Version 1.2-6.R  P               If you intend to continue developing programs for XUI or OSF/MotifM               Release 1.1.3, then save this environment.  Please refer to theMT               installation guide for more details and information on accessing these*               files in their new location.  N               If you do not choose to save the XUI and OSF/Motif Release 1.1.3R               programming environment, those files will be removed from the system               disk.R  O               Save the OSF/Motif Release 1.1.3 and XUI programming environment?r  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 filesmH               that support that programming environment are moved to the'               [.DECW$113] subdirectory.   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 occurmC               if you are simultaneously installing or upgrading the 7               OpenVMS operating system with DECwindows.d  I                                                                       2-9  :  -      6     Using the POLYCENTER Software Installation Utility     2.3 Installing the Software           2.3.2.4 Default Installation  E           Next, the dialog asks if you want the default installation.tD           On systems with no previous DECwindows Motif installation,>           the installation procedure installs all options that<           apply to your hardware platform. On systems with aB           previous DECwindows Motif installation, the installationE           procedure installs all options selected during the previouss           installation.m  9           Do you want the defaults for all options? [YES]o  E           The remainder of this chapter assumes that you answer No toe           this question.  9     2.3.2.5 Asking About Selecting a Desktop (Alpha Only)   >           On OpenVMS Alpha systems, the installation procedureA           displays information about the New Desktop and asks youn@           whether the New Desktop should be the default desktop.           Install New Desktop_  N         The New Desktop is a graphical user interface that is derived from theO         Common Desktop Environment (CDE).  It offers the following features not :         available with the traditional DECwindows desktop:  P             o Multiple workspaces for greater flexibility in managing windows on               the screen.n  N             o An icon-based File Manager to make it easier to manipulate files0               from the graphical user interface.  L             o Enhanced support for the drag-and-drop feature, which is fullyG               supported in the new File Manager and Application Managern               applications.m  <             o New Image Viewer and Icon Editor applications.  S         Both the New Desktop and the DECwindows desktop provide the same underlying R         X and Motif libraries and the same DECterm, Bookreader, Mail, and Calendar         applications.h  !         Install New Desktop [YES]   @             Install Manual (reference) pages for the New Desktop  E             The manual pages provide online help text for New Desktop D             functions. If installed they can be viewed using the man5             page viewer from the Application Manager.e  F             Install Manual (reference) pages for the New Desktop [YES]       2-10 0  s      I                        Using the POLYCENTER Software Installation Utility_I                                               2.3 Installing the Software     >                 Make the New Desktop the default desktop [YES]  2             Install traditional DECwindows Desktop  T             The traditional DECwindows Desktop is that provided since Version 1.2 ofS             DECwindows. If both new and traditional desktops are installed the user 4             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.   4         2.3.2.6 Programming Language Support Options  C               Next, the dialog asks you which programming languages E               you want to install and whether you want to install thei#               programming examples.m  G               On OpenVMS Alpha systems, the installation procedure uses #               the following dialog:e  4               Programming Support for the C Language  R               Headers and related files to support programs in C that will use the#               DECwindows libraries.O  :               Programming Support for the C Language [YES]  9               Programming Support for the Pascal Language   K               Include files to support programs in Pascal that will use the #               DECwindows libraries.   ?               Programming Support for the Pascal Language [YES]   :               Programming Support for the FORTRAN Language  L               Include files to support programs in FORTRAN that will use the#               DECwindows libraries.t  @               Programming Support for the FORTRAN Language [YES]  5               Programming Support for the New Desktopu  R               Headers and related files to support programs in C that will use the"               New Desktop widgets.  ;               Programming Support for the New Desktop [YES]   "               Programming examples  I                                                                      2-11t           6     Using the POLYCENTER Software Installation Utility     2.3 Installing the Softwaret    ?           Examples of programming to use the various libraries.   $           Programming examples [YES]  A           Do you want all the defaults for the subitems? [YES] not  !               Sound example files   @               Sample sound files that can be used with DECsound.  '               Sound example files [YES]   1               Programming examples for DECwindows   U               Examples, in various programming languages, of using the DECwindows and1-               standard widgets and libraries.f  7               Programming examples for DECwindows [YES]   6               Programming examples for the New Desktop  U               Examples, in C, of using the new widgets provided with the New Desktop.n  <               Programming examples for the New Desktop [YES]  E           On OpenVMS VAX systems, the installation procedure uses the            following dialog:   6           DECwindows Motif runtime support files [YES]  0           Programming Support for the C Language  N           Headers and related files to support programs in C that will use the           DECwindows libraries.   6           Programming Support for the C Language [YES]  5           Programming Support for the Pascal Languagen  G           Include files to support programs in Pascal that will use thew           DECwindows libraries.   ;           Programming Support for the Pascal Language [YES]   6           Programming Support for the FORTRAN Language  H           Include files to support programs in FORTRAN that will use the           DECwindows libraries.a  <           Programming Support for the FORTRAN Language [YES]       2-12 h  o      I                        Using the POLYCENTER Software Installation UtilityII                                               2.3 Installing the Softwared    (               Programming examples [YES]  (         2.3.2.7 Translated Image Support  D               The dialog now prompts you to install Translated ImageB               Support (TIS), which enables VAX programs to work inF               the DECwindows Motif for OpenVMS Alpha environment. NoteD               that TIS support is only available for the traditional-               DECwindows desktop environment.n  &               Translated Image Support  N               Translated image support allows programs translated from the VAXM               enviroment to work in the Alpha environment with the DECwindows W               libraries. Translated image support is not available for the New Desktop.t  ,               Translated Image Support [YES]  (         2.3.2.8 Language Variants Notice  H               The dialog now displays a warning about the need to updateF               any language variants. You should not install DECwindowsI               Motif Version 1.2-6 unless you will also install DECwindowseI               Motif Version 1.2-6 language variants for all the languagesa#               that you wish to use._  X               If a Local Language Variant is installed, refer to the Installation Guide.  S               If you have a language variant of DECwindows Motif installed then you R               must upgrade to the version for DECwindows Motif Version 1.2-6 afterU               completing this installation and before rebooting the system. A failure_>               to do so could prevent DECwindows from starting.  Z               If there is no local language variant upgrade available for DECwindows MotifT               Version 1.2-6 then you should remove the local language variant before8               installing DECwindows Motif Version 1.2-6.  ,               Do you want to continue? [YES]  2         2.3.2.9 Reviewing the Installation Options  E               The dialog gives you a chance to review the options youn;               have selected during the installation dialog.o    I                                                                      2-13            6     Using the POLYCENTER Software Installation Utility     2.3 Installing the Software     3           Do you want to review the options? [NO] yn  5           DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motifr&               Install New Desktop: YESI                 Install Manual (reference) pages for the New Desktop: YESr=                 Make the New Desktop the default desktop: YESi9               Install traditional DECwindows Desktop: YESq9               Programming Support for the C Language: YES >               Programming Support for the Pascal Language: YES?               Programming Support for the FORTRAN Language: YES :               Programming Support for the New Desktop: YES'               Programming examples: YES (                 Sound example files: YES8                 Programming examples for DECwindows: YES=                 Programming examples for the New Desktop: YESe+               Translated Image Support: YES   5           Are you satisfied with these options? [YES]        2.3.2.10 Execution Dialogi  >           During the execution phase, the installation utility@           begins by displaying the names of all products it willE           install or remove. This is followed by an indication of the            procedure's progress.   C              ________________________ Note ________________________   <              During the execution phase, a check is made forC              DECwindows Motif support files. If these files are not C              available, the dialog may ask if you want to continue.i7              See Section 2.3.2.11 for more information.   C              ______________________________________________________A  &           Execution phase starting ...  A           The following product will be installed to destination:tI               DEC AXPVMS DWMOTIF V1.2-6              DISK$2:[VMS$COMMON.]oA           The following product will be removed from destination:tI               DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.]V             2-14 r  A      I                        Using the POLYCENTER Software Installation UtilityrI                                               2.3 Installing the Softwarei                   Portion done: 0%               ...10%               ...20%               ...30%               ...40%               ...50%               ...60%               ...70%               ...80%               ...90%  9         2.3.2.11 Verifying DECwindows Motif Support FilesE  G               The installation procedure verifies that DECwindows MotifpF               applications and run-time support files are installed onC               the operating system (for example, transport and fontED               files, which are required for running DECwindows Motif               software).  X               **** DECwindows Motif application and run-time support files DETECTED ****  I               On OpenVMS VAX systems, if the files are not installed, thel-               following message is displayed:p  W               The DECwindows Motif application and run-time support files have not beend               installed.  S               You can use the DECwindows tailoring facility to tailor on the device P               support files and the 75DPI and/or the 100DPI font files using theU               DECwindows save sets which are shipped with the OpenVMS kit as follows:S  -                  $ RUN SYS$UPDATE:DECW$TAILOR   C               The installation of DECwindows Motif cannot continue.   G               On OpenVMS Alpha systems, the files are always installed.i  F               Next, the installation procedure checks for the presenceE               of support files that are needed to use the system as a I               workstation or as a workstation boot server. If the supporteF               files are installed, the following message is displayed:  @               **** DECwindows device support files DETECTED ****  E               On OpenVMS VAX systems, if the files are not installed, D               users are warned with the following message that theirC               systems cannot be a workstation or a workstation bootT               server:e  I                                                                      2-15h    g      6     Using the POLYCENTER Software Installation Utility     2.3 Installing the SoftwareB    U           The DECwindows device support files for using this machine as a workstationrE           or as a boot node for workstations have not been installed.S  O           You can use the DECwindows tailoring facility to tailor on the devicehL           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$TAILOR  C           On OpenVMS Alpha systems, if the files are not installed,e@           users are warned with the following message that their?           systems cannot be a workstation or a workstation bootl           server:h  S         The DECwindows device support files for using this machine as a workstationpC         or as a boot node for workstations have not been installed.L  N         You can use the POLYCENTER Software Installation utility to change theG         options selected when the OpenVMS Alpha software was installed. N         See the POLYCENTER Software Installation Utility User's Guide for moreR         information. To add the support files and the 75DPI and/or the 100DPI fontO         files using the DECwindows save sets which are shipped with the OpenVMSh<         kit, use the PRODUCT RECONFIGURE command as follows:  #           $ PRODUCT RECONFIGURE VMSo  M         You should add the "Support for DECwindows" subclass in the Utilitieso         class.  C           On both systems, the installation procedure then asks the            following question:f  S     Do you wish to continue with this installation without the workstation support?M  B           If you answer No (default) and press the Return key, theB           installation is stopped. See Section 5.3 for informationA           on adding the necessary support files. Once you installw?           the necessary support files, restart the installationv           procedure.  9           If you answer Yes and press the Return key, the !           installation continues.i  C           Note that this portion of the installation does not occur.?           if you are simultaneously installing or upgrading the 3           OpenVMS operating system with DECwindows.        2-16 e         I                        Using the POLYCENTER Software Installation UtilitytI                                               2.3 Installing the Softwareo    3         2.3.2.12 Reviewing Final Installation Notes   D               If the installation is successful, the dialog displaysD               a list of all products installed and removed. Finally,E               the procedure displays final installation notes for the '               DECwindows Motif product.                  ...100%.  7               The following product has been installed:tH                   DEC AXPVMS DWMOTIF V1.2-6              Layered Product5               The following product has been removed:eH                   DEC AXPVMS DWMOTIF V1.2-5              Layered Product  9               DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif   X                   System reboot will be required following upgrade of language variants.  U                   A system reboot will be required to install the new DECwindow Motif R                   images. If this is a new installation you should execute AUTOGEN.                   using the following command:  M                           $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACKn  U                   This command adjusts your system parameters and reboots the system.   U                   If you wish to use DECwindows with any language other than English,nQ                   install the appropriate DECwindows Motif Version 1.2-6 language O                   variant product before using AUTOGEN or rebooting the system.o  N                   Installation Verification Procedure can be run after reboot.  Z                   Run the Installation Verification Procedure (IVP) after the installationT                   is completed and the system is rebooted. The IVP is located in the=                   following directory: SYS$TEST:DECW$IVP.COM.t  "         2.4 Recovering from Errors  F               An error during installation can occur if one or more of.               the following conditions exists:  ;               o  The operating system version is incorrect.t  @               o  The prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation arek                  inadequate.  H               o  Process quotas required by the installation utility are                  inadequate.  I                                                                      2-17     t      6     Using the POLYCENTER Software Installation Utility     2.4 Recovering from Errors    :           o  The OpenVMS Help library is currently in use.  C           For descriptions of the error messages generated by these @           conditions, see the documents listed in the AssociatedD           Documents section in the Preface. These documents may helpC           you diagnose errors and decide what corrective actions toi           take.t  A           If the installation procedure fails for any reason, theeE           POLYCENTER Software Installation utility displays a messageh#           similar to the following:   Q           %PCSIUI-INSFAIL, The installation of DECwindows Motif Version 1.2-6 for            OpenVMS has failed.s  D           If the installation fails, fix the problem and restart the!           installation procedure.   /     2.5 Adjusting Parameters After Installatione  ?           If you are simultaneously installing or upgrading the ?           OpenVMS operating system with DECwindows from the CD-]D           ROM, the installation procedure will will check the system#           parameters at this point.   C              ________________________ Note ________________________   ;              You will not see this message if this is a newE(              installation of DECwindows.  C              ______________________________________________________t  D           When Compaq DECwindows Motif for OpenVMS attempts to start?           after successful installation, you will see a messagee#           similar to the following:   T     %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000E     %DECW-W-BADVALUE, Free GBLPAGES is 75040 should be at least 92000oO     %DECW-W_BADVALUE, SYSGEN parameter CLISYMTBL is 256, should be at least 512SM     Some SYSGEN parameters must be reset for DECwindows to start. If you typegQ     YES, AUTOGEN will change these parameters and reboot your system. If you type P     NO, AUTOGEN will not be run or cause a reboot but DECwindows will not start.7     Do you want the system to run AUTOGEN for you [YES]i  C           At this point, press RETURN. The system will run AUTOGEN, >           adjust your system parameters, reboot the system and'           display the DECwindows login.b       2-18                         I                                                                         3 I         _________________________________________________________________a  I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)r    D               This chapter explains how to install Compaq DECwindowsF               Motif for OpenVMS software using the VMSINSTAL procedureF               on VMS Version 5.5-2 systems. Included is a step-by-stepD               description of the installation procedure, informationF               about error recovery, and instructions for accessing the               release notes.  F                 ________________________ Note ________________________  E                 The VMSINSTAL installation procedure is only providedS?                 for VMS Version 5.5-2 systems and should not be C                 used on OpenVMS Version 6.2 and OpenVMS Version 7.1 A                 systems. Use the POLYCENTER Software InstallationlD                 utility to install DECwindows Motif on these OpenVMS'                 systems; see Chapter 2.n  F                 ______________________________________________________  H               Using the VMSINSTAL procedure, the Compaq DECwindows MotifF               for OpenVMS installation takes approximately 45 minutes,F               depending on the processor type. The VMSINSTAL procedureI               installs the Compaq DECwindows Motif for OpenVMS product oni               your system disk.d  F                 ________________________ Note ________________________  <                 A Product Authorization Key (PAK) for CompaqC                 DECwindows Motif for OpenVMS must be registered andeF                 loaded before starting the Compaq DECwindows Motif for%                 OpenVMS installation.S  F                 ______________________________________________________        I                                                                       3-1a n  u      :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)      D              _______________________ Caution _______________________  =              If you do not have a satisfactory backup copy of ?              your system disk, do not attempt to install Compaql?              DECwindows Motif for OpenVMS software. Back up the =              system disk (as described in the OpenVMS upgrade @              and installation supplement for your VAX processor)C              before you install Compaq DECwindows Motif for OpenVMSF              software.  9              Before beginning the installation procedure,u@              review Chapter 1 for information about installation+              preparations and requirements.t  C              ______________________________________________________   ?           This chapter presents information about the followingl           topics:   =           o  Section 3.1, Installation Procedure Requirementsp  0           o  Section 3.2, Installation Procedure  0           o  Section 3.3, Recovering from Errors  5           o  Section 3.4, Accessing the Release Notese  +     3.1 Installation Procedure Requirementst  E           This section discusses the requirements for installing youreD           Compaq DECwindows Motif for OpenVMS VAX software using the+           VMSINSTAL installation procedure.a  E           Refer to Section 1.8 for information on requirements commono3           to both VMSINSTAL and PCSI installations.T  @           Prepare to install Compaq DECwindows Motif for OpenVMSA           software by logging in to a privileged account, such asaD           the system manager (SYSTEM) account. See Section 3.1.1 forC           the prerequisite privileges. Although Compaq prefers thatoD           you perform the installation using the operator console orC           other hardcopy terminal, you can perform the installationa            from a DECterm window.         3-2     h      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)eI                                   3.1 Installation Procedure Requirementsa              3.1.1 Process Privileges  F               To install Compaq DECwindows Motif for OpenVMS software,E               you must be logged in to an account that has the SETPRVe4               privilege or the following privileges:                 o  CMKRNLr                 o  WORLD                 o  SYSPRVn  G               The installation procedures turn off the BYPASS privilege G               at the start of the installation and turn it back on when ,               the installation is completed.  /         3.1.2 Using an Alternate Working Device   C               You can use the alternate working device (AWD) option D               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 areG               necessary for the installation of Compaq DECwindows Motif C               for OpenVMS software from the AWD to the system disk.n  G               If this installation is to upgrade an existing DECwindowsrB               Motif environment, then the AWD option allows you toC               perform an installation with fewer free blocks on thet6               system disk than are otherwise required.  D               The installation procedure creates a temporary workingE               directory either on the AWD device or by default in the !               following location:o  +               SYS$SYSROOT:[SYSUPD.facunvvv]n  E               If you use the AWD option, you can specify a directory. C               Specifying a directory is optional, but the followingn               guidelines apply:E  G               o  If you specify an existing directory, the installationfH                  procedure creates a working directory as a subdirectoryD                  within the directory that you specify (for example,E                  [WORK.facunvvv]). The installation procedure deletes C                  the working subdirectory after the installation isd                  completed.   I                                                                       3-3r           :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)+     3.1 Installation Procedure Requirements     @           o  If you do not specify a directory, the installation9              procedure creates a working directory on the ?              specified device with a directory specification of B              [000000.facunvvv]. The installation procedure deletes<              the working directory after the installation is              completed.   E           o  If you specify a nonexistent directory, the installationeA              procedure creates both the specified directory and a E              working directory as subdirectories within the directory A              that you specify. The installation procedure deletesr>              only the working directory and not the originallyE              specified directory after the installation is completed. >              You must delete the specified directory manually.  D           Use the following format to invoke the VMSINSTAL procedure%           and specify the AWD option:   H           $ @SYS$UPDATE:VMSINSTAL facunvvv dkcu OPTIONS N,AWD=ddcu:[dir]  @           Use the following definitions for the variables in the           command line:r  >           o  For facunvvv, supply the product name and version              number.  8              For the Compaq DECwindows Motif for OpenVMSD              installation, the value of facunvvv is DWMOTIFVAXU6012.  D           o  For dkcu, give the device name of the source drive that*              holds the distribution media.  D           o  For ddcu, give the device name of the alternate working              device.  >           o  For dir, specify the name of the directory on theD              alternate working device where the product subdirectory6              will be created. The default is [000000].  A           For example, to install the Compaq DECwindows Motif for C           OpenVMS product from the compact disc onto an OpenVMS VAXiB           system using DKA2 as the alternate working device, enter            the following command:  @           $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 source-drive -            _$ OPTIONS N,AWD=DKA2:       3-4r l  s      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)sI                                   3.1 Installation Procedure Requirements     0         3.1.3 Using the Distributed File Service  E               You can specify a temporary working directory on a diskm;               that uses the Distributed File Service (DFS).s  E               If you use a DFS-mounted disk as your alternate workingeI               device, the installation procedure erroneously reports thatnG               there are -1 free blocks on the alternate working device.wH               This error occurs because the DFS client (the installationE               procedure, in this case) cannot determine the amount ofh6               free disk space on the DFS-mounted disk.  E               Before using a DFS-mounted disk, manually determine itsoH               free disk space. Log in to the system on which the disk isD               mounted, and enter the SHOW DEVICE command as follows:                 $ SHOW DEVICEi  "         3.2 Installation Procedure  B               The Compaq DECwindows Motif for OpenVMS installation=               procedure consists of a series of questions andsH               informational messages. Enter a question mark (?) for helpE               at any time during the installation. See Appendix B forrG               a sample VMSINSTAL installation of DECwindows Motif on anb!               OpenVMS VAX system.o  D               To stop the installation procedure, press Ctrl/Y. WhenF               you press Ctrl/Y, the installation procedure deletes allI               files created up to that point and then exits. You can thenS'               restart the installation.e  F                 ________________________ Note ________________________  /                 This option is not recommended.U  F                 ______________________________________________________  &         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 the F               distribution media. Refer to a product with its facilityF               name and version; refer to a drive with its device name.I               Use the following format to enter product and device names:o                 o  facunvvvy  I                                                                       3-5            :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    C              Represents the facility name and version number of the D              product being installed, also known as the installation=              name. The following table explains the format ofa              facunvvv.  E              ________________________________________________________aE              Variable__Definition____________________________________e  >              fac       Product name code (1 to 36 alphanumeric"                        characters)  9              u         Update character "u" (1 character)C  6              n         Update version number (1 digit)  E              vvv_______Major_version_number_(3_digits)_______________.  8              For the Compaq DECwindows Motif for OpenVMSE              installation, use the installation name DWMOTIFVAXU6012.t             o  ddcua  E              Specifies the device name of the source drive that holdss$              the distribution media.  ?           For additional information about device names on your A           system, see the upgrade and installation supplement forE           your VAX processor.   *     3.2.2 Invoking the VMSINSTAL Procedure  A           To start the installation, invoke the VMSINSTAL commandVA           procedure from a privileged account, such as the SYSTEMT;           account. The VMSINSTAL.COM file is located in theo           SYS$UPDATE directory.a  @           When the system prompts you with a question during theD           installation procedure, the default answer is often listed           in brackets ([]).t  D           Perform the following steps to run the VMSINSTAL procedureC           and install Compaq DECwindows Motif for OpenVMS software:O  ;           1. Locate the Compaq DECwindows Motif for OpenVMSu               distribution media.  @           2. If your system is not already running, start up theC              system and log in to a privileged account, such as thep-              system manager (SYSTEM) account.        3-6     a      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) I                                                3.2 Installation Procedure     E               3. Place the distribution media in the source drive. IfiF                  your Compaq DECwindows Motif for OpenVMS distributionC                  kit contains more than one volume, place the firstWH                  volume in the drive. During the installation procedure,H                  you will be prompted to load the next volume. The paperI                  labels on the media indicate the order in which you loadi                  them.  D               4. Start the VMSINSTAL procedure. On the command line,G                  specify the product name (that is, the facility name):a9                  DWMOTIFVAXU6012 for OpenVMS VAX systems.   I                  Specify OPTIONS N to access the release notes, which are H                  included in your media kit. The Compaq DECwindows MotifF                  for OpenVMS Release Notes can be displayed or printedD                  before the installation begins. Enter the following+                  command at the DCL prompt:o  H                  $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 ddcu: OPTIONS N  F                  For ddcu, specify the device name of the source driveI                  that holds the distribution media. See Section 3.2.1 foraH                  more information about the format of product and deviceF                  names. Also, see the OpenVMS upgrade and installation3                  supplement for your VAX processor.l  H                  For example, if you install Compaq DECwindows Motif forG                  OpenVMS from a magnetic tape cartridge in drive MUA0:,sD                  enter the following command to invoke the VMSINSTAL#                  command procedure:a  H                  $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 MUA0: OPTIONS N  I                  If you install Compaq DECwindows Motif for OpenVMS using G                  the alternate working device (AWD) option described inyI                  Section 3.1.2, invoke the VMSINSTAL command procedure as_                  follows:_  W                  $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 ddcu: OPTIONS N,AWD=ddcu:[dir]s  E                  The first instance of ddcu is the device name of the_D                  source drive that holds the distribution media. TheG                  second instance of ddcu is the device name of the AWD,lD                  which is the target device. The variable dir is theI                  name of the directory on the alternate working device in G                  which the product subdirectory is created. The default '                  directory is [000000].T  I                                                                       3-7f D  i      :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    A              For example, if you are installing Compaq DECwindowsE@              Motif for OpenVMS from a magnetic tape cartridge inA              drive MUA0: using alternate working device DUA2: ande>              directory [INSTALL], enter the following command:  N     $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012 MUA0: OPTIONS N,AWD=DUA2:[INSTALL]  >              If the command to execute the VMSINSTAL procedureC              fails, check to see if any of the following conditions_              occurred:  C              o  You entered the product name incorrectly. VMSINSTALe/                 displays the following message:r  O                 %VMSINSTAL-E-NOPRODS, None of the specified products were founde  E              o  You specified an incorrect name for the source drive.sD                 VMSINSTAL displays an "invalid device" error messageD                 and prompts you until you enter the name of a sourceE                 device that exists on the system. Remember to enter a 1                 colon (:)  after the device name._  B           The VMSINSTAL procedure displays messages similar to the           following:  H                   VAX/VMS Software Product Installation Procedure V5.5-2  $           It is 26-MAR-2000 at 08:02  9           Enter a question mark (?) at any time for help.t  "     3.2.3 Confirming System Backup  >           The VMSINSTAL procedure asks the following question:  H           * Are you satisfied with the backup of your system disk [Yes]?  B           If you made a backup copy of your system disk, press the2           Return key and proceed to Section 3.2.4.  B           If you did not make a backup copy of the system disk, do           the following:  =           1. Enter No and press the Return key. The VMSINSTALw:              procedure exits and returns you to DCL level.  @           2. Back up the system disk as described in the OpenVMS=              upgrade and installation supplement for your VAX               processor.        3-8w o  M      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)tI                                                3.2 Installation Procedure     I               3. After you make a backup copy of the system disk, restart I                  the installation procedure from step 4 in Section 3.2.2.n  )         3.2.4 Mounting Distribution Media   G               The VMSINSTAL procedure asks you where you will mount then#               distribution volumes:   ?               * Where will the distribution volumes be mounted:y  H               Enter the directory specification in the following format:  %               device-name:[directory]   C               Then the procedure tells you to enter the name of the =               product (facility name); enter DWMOTIFVAXU6012.   K               Enter the names of the product to be processed from the firstf&               distribution volume set.(               * Product: DWMOTIFVAXU6012  C               When the installation begins, the VMSINSTAL procedureaC               displays informational text similar to the following:_  7               The following products will be processed:e                   DWMOTIFVAX V1.2-6  K                 Beginning installation of DWMOTIFVAXU6 Version 1.2 at 10:36e  D               %VMSINSTAL-I-RESTORE, Restoring product save set  A...  -         3.2.5 Choosing a Release Notes Option   F               If you specify OPTIONS N during step 4 in Section 3.2.2,E               the VMSINSTAL procedure prompts you to select a releaset               notes option:   Q               Release notes included with this kit are always copied to SYS$HELP.n  3                   Additional Release Notes Options:8  +                   1.  Display release notes )                   2.  Print release notess"                   3.  Both 1 and 2'                   4.  None of the above   "               * Select option [2]:  6               Enter the number of the option you want:  E               o  Option 1 displays the release notes on the terminal..  I                                                                       3-9t o  a      :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    9           o  Option 2 prints the release notes (default).   <           o  Option 3 displays and prints the release notes.  E           o  Option 4 allows you to continue with the installation if C              you do not want to display or print the release notes.a  C              ________________________ Note ________________________g  A              Compaq strongly recommends that you read the releaset6              notes before continuing the installation.  C              ______________________________________________________   B           If you choose option 1, the release notes display on the@           terminal. You are prompted to press Return to continueC           reading the release notes. If you want to end the displayr@           and continue the installation, press Ctrl/C. After youB           press Ctrl/C, you are asked whether you want to continueB           with the installation; you are informed that the release,           notes have been moved to SYS$HELP.  D              _______________________ Caution _______________________  C              Do not press Ctrl/Y; if you do, the installation ends.   C              ______________________________________________________   D           If you choose option 2 or 3, you are prompted for the nameB           of the print queue. If you do not specify a print queue,?           the release notes are queued to SYS$PRINT by default.   %     3.2.6 Continuing the Installationh  D           After the VMSINSTAL procedure processes your release notes5           option, the following message is displayed:c  :           * Do you want to continue the installation [No]?  B           If you want to continue with the installation, enter Yes@           and press Return. If you want to end the installation,           press the Return key.c  @           Regardless of the release notes option you select, the=           VMSINSTAL procedure copies the release notes to the C           SYS$HELP directory. See Section 3.4 for information aboutoE           how to access the release notes once they are copied to thec           SYS$HELP directory.h       3-10 t  u      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)dI                                                3.2 Installation Procedurei    [                 %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   Y                       *** Installing Compaq DECwindows Motif for OpenVMS VAX software ***   <                   Copyright 2000 Compaq Computer Corporation  Y                   Confidential computer software. Valid license from Compaq or authorizedrX                   sublicensor required for possession, use , or copying. Consistent withX                   FAR 12.211 and 12.212, Commercial Computer Software, Computer SoftwareU                   Documentation, and Technical Data for Commercial Items are licensed T                   to the U.S. Government under vendor's standard commercial license.  @         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 isC               incompatible with Compaq DECwindows Motif for OpenVMS H               software. (Note that the OSF/Motif Release 1.2 programmingI               environment is overwritten with the OSF/Motif Release 1.2.3 F               Toolkit when you install the Compaq DECwindows Motif for                OpenVMS software.)  A               The installation procedure asks whether you want tom>               preserve the OSF/Motif Release 1.1.3 programming               environment:  S                   The DECwindows Motif programming environment was installed with alZ                   previous version of this kit.  This environment is incompatible with theZ                   OSF/Motif Release 1.2 environment provided with DECwindows Motif VersionP                   1.2-6. The XUI programming environment is also not included in1                   DECwindows Motif Version 1.2-6.   T                   If you intend to continue developing programs for XUI or OSF/MotifV                   Release 1.1.3 you should save this environment.  Please refer to theX                   installation guide for more details and information on accessing these.                   files in their new location.  R                   If you do not choose to save the XUI and OSF/Motif Release 1.1.3V                   programming environment, those files will be removed from the system                   disk.   I                 * Do you want to save the OSF/Motif Release 1.1.3 and XUI 1                 * programming support files [No]?q  I                                                                      3-11            :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    E           If you want to preserve the XUI and OSF/Motif Release 1.1.3eA           programming environment, enter Yes and press the ReturnrE           key. The installation procedure creates subdirectories thatlB           contain the OSF/Motif Release 1.1.3 programming files so@           that they can be used for programming at a later time.  D           See Section 1.6 for information about how to reference the<           previous version of the programming support files.  #     3.2.8 Installing the Entire Kit   @           You can install the entire Compaq DECwindows Motif forC           OpenVMS software kit, or you can install part of the kit. @           The DECwindows Motif base kit is always installed; theE           Compaq DECwindows Motif for OpenVMS programming environmentn           is optional.  @           The procedure asks you whether you want to install the           entire kit:s  P               You can install the DECwindows Motif kit completely or in selectedS               portions.  A complete installation requires as many as 82,500 blocks. M               If you choose to perform a partial installation, you can selectoQ               (tailor) the programming support files that support your DECwindowsuW               Motif application development.  Whether you perform a complete or partialSR               installation, this kit provides support for running DECwindows Motif6               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 Return keyiE           and verify your kit selections (see Section 3.2.10). If yousE           choose not to install the entire kit, enter No and continueaB           with questions about installing programming support (see           Section 3.2.9).   ,     3.2.9 Choosing Programming Support Files  E           The installation procedure asks whether you want to installi           programming support:  O               This installation procedure provides support files for developing-T               DECwindows Motif applications in several programming languages.  TheseW               files are needed only to develop applications and are not required to runoV               DECwindows Motif applications.  The free disk space requirement for eachG               programming support file ranges from 3000 to 8000 blocks.v  P             * Do you want to install DECwindows Motif programming support [Yes]?       3-12 _  f      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)mI                                                3.2 Installation Procedure     F               Press the Return key to install programming support. The-               following message is displayed:   ]                   Support files are supplied for the following OpenVMS programming languages:o  '                         FORTRAN, Pascalt  [                   In addition, support files are supplied for programming in the C languagesZ                   using conventions and standards developed at the Massachusetts Institute                    of Technology.  E               If you choose not to install programming support, enterlG               No and proceed to the instructions in Section 3.2.10. TheiI               installation procedure asks whether you want to install allh/               of the programming support files:p  V                 * Do you want to install all programming language support files [Yes]?  A               Press the Return key if you want to install all thesI               languages. If you do not want to install all the languages,eF               enter No and press the Return key. Each language is thenE               displayed. Enter Yes for each language that you want to                install.  I               The installation procedure asks whether you want to installC9               DECwindows Motif programming example files:.  U                 * Do you want to install DECwindows Motif programming examples [Yes]?   I               Press the Return key if you want to install the programming G               example files. If you enter No, the example files are note               installed.  '         3.2.10 Verifying Kit Selections   F               The components of the kit that you selected now display;F               you can verify that these choices are correct. A message4               similar to the following is displayed:  B               You have selected the following portions of the kit:  M                       o  DECwindows Motif Applications and Run-time Libraries   >                       o  DECwindows Motif programming examples  =                       o  DECwindows Motif programming supporth  (                          FORTRAN, Pascal?                          MIT C language programming conventions   J                       o  OSF/Motif Release 1.1.3 and XUI saved programming                           support  I                                                                      3-13e t         :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    /           * Are these selections correct [Yes]?i  A           Press the Return key if the choices are correct. If youo@           want to change your selections, enter No and press the@           Return key. You are prompted by the previous questions?           again, beginning with whether you want to install thei>           entire kit (see Section 3.2.8). After you repeat theE           selection procedure and are satisfied with your selections,r-           enter Yes and press the Return key.        3.2.11 Verifying Disk Spacea  D           The installation procedure checks whether your system disk6           contains a sufficient number of free blocks.  D           1. If the blocks are available, the installation continues"              (see Section 3.2.12).  ?           2. If you do not have sufficient system disk space tod=              install the portions you chose, the installationF9              displays a message similar to the following:   =              Your system disk has only 25364 free blocks, andaE              you have selected to install approximately 76050 blocks.c  :                                        * * * N O T E * * *  R              The installation procedure has determined that you do not have enoughR              disk space to complete the installation.  However, it may be possibleQ              to continue successfully if you are installing DECwindows Motif on aT@              system that already has DECwindows Motif installed.  U            * Do you want to reselect which DECwindows Motif options to install [Yes]?   >              If you press the Return key, you can reselect theD              DECwindows Motif options beginning with those describedB              in Section 3.2.8. If you enter No, the procedure asks;              whether you want to continue the installation:   E              * Do you want to continue the installation anyway [Yes]?   D              _______________________ Caution _______________________  :              If you press the Return key, the installation<              continues. However, if you exceed the amount of:              available disk space, the installation fails.  C              ______________________________________________________        3-14    0      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)NI                                                3.2 Installation Proceduren    E                  If you enter No, the installation ends. You can then E                  either free up blocks on the system disk and restartsG                  the installation or start the installation again usingdI                  the AWD option. (See Section 3.1.2 for information about '                  using the AWD option.)   I               3. If you specify an alternate working device that does notnG                  have sufficient disk space to install the portions you I                  have chosen, the installation displays a message similarc"                  to the following:  P                 Your specified alternate working directory device has only 68977[                 free blocks, and this installation will require approximately 76050 blocks.:  X                 You should either reselect which DECwindows Motif options to install, orZ                 restart this installation using an alternate working directory device with!                 more free blocks.f  6                                 *  *  *  NOTE  *  *  *  Y                 Although the installation procedure estimates you do not have enough disk R                 space to complete the installation, it may be possible to continueU                 successfully if you are installing DECwindows Motif on a system whichp1                 already has DECwindows installed.   X               * 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:p  I                  * Do you want to continue the installation anyway [Yes]?r  I                  If you press the Return key, the installation continues.   G                 _______________________ Caution _______________________n  :                 If you lack sufficient free disk space forA                 installation on the alternate working device, the ,                 installation procedure ends.  F                 ______________________________________________________  B                  If you enter No, the installation procedure ends.F                  Restart the installation once you set up an alternate@                  working device with sufficient disk space. (SeeG                  Section 3.1.2 for more information about using the AWD                   option.)o  I                                                                      3-15  i         :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    )     3.2.12 Verifying License Registrationn  C           The installation procedure continues and displays licenseN/           information similar to the following:   O               A registered and loaded product authorization key for DW-MOTIF isTR               required to run any DECwindows Motif for OpenVMS application. If youV               answer No to the next question, the installation of DECwindows Motif for)               OpenVMS will be terminated.   *                     Product:      DW-MOTIF%                     Producer:     DEC                      Version:!                     Release Date:   Q             * Does this product have an authorization key registered and loaded ?   D           Note that the NET-APP-SUP-250 and NET-APP-SUP-300 PAKs areA           also valid. Enter Yes to continue with the installationl@           if your authorization key is registered and loaded. IfB           you enter No, the following message is displayed and the           installation ends:  I           Installation of DECwindows Motif cannot continue because you dor=           not have a registered and loaded authorization key.p  <           See Section 1.1 for more information about license8           registration. After you register and load yourD           authorization key, restart the Compaq DECwindows Motif forD           OpenVMS installation beginning at step 4 in Section 3.2.2.  %     3.2.13 Performing a System Rebootr  @           The installation procedure suggests that you perform aC           system reboot to ensure successful installation of Compaq_0           DECwindows Motif for OpenVMS software:  O               DECwindows Motif will not start if your system parameters are not                correct.  O               o If you allow a system shutdown, the installation procedure williQ                 reboot the system at the end of the installation.  If your system Q                 parameters are incorrect, the installation will run AUTOGEN priorl%                 to the system reboot.o  Q               o If you do not allow a system shutdown, the installation procedure I                 will continue, and you will be informed at the end of the Q                 installation whether you need to modify your system parameters inu0                 order to start DECwindows Motif.       3-16 f  e      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)rI                                                3.2 Installation Procedureh    Q                   To complete the installation of this product, you should rebootiS                   the system.  If it is not convenient to reboot at this time, thenn5                   enter No to the following question.i  L                   If you enter No, the installation procedure will continue.  W                 * Will you allow a system reboot after this product is installed [Yes]?o  D               If you entered No to the shutdown question, no further"               questions are asked.  I               If you answered Yes to the shutdown question, the VMSINSTAL B               procedure displays the following questions about the               shutdown:t  9               * How many minutes for system shutdown [0]?(C               * Do you want to do an automatic system reboot [Yes]?   3                 No further questions will be asked.S  G                 _______________________ Caution _______________________   E                 To avoid confusion with file versions when activatingV>                 an image or application, perform the necessaryE                 procedures to restart the Compaq DECwindows Motif foraE                 OpenVMS software as indicated during the installatione"                 in Section 3.2.15.  F                 ______________________________________________________  -         3.2.14 Reading Informational Messages   D               The VMSINSTAL procedure lists the directories that areH               created and the save sets that are restored. The VMSINSTALF               procedure prints out a message indicating that the files8               will be moved to their target directories.  G               o  If you perform the installation using media other thanSI                  9-track magnetic tape, messages similar to the followinge                  display:i          I                                                                      3-17i           :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    K             %VMSINSTAL-I-SYSDIR, This product creates system disk directory -             VMI$ROOT:[DECW$INCLUDE.DECW$113].hK             %VMSINSTAL-I-SYSDIR, This product creates system disk directorym'             VMI$ROOT:[SYSEXE.DECW$113]. K             %VMSINSTAL-I-SYSDIR, This product creates system disk directoryl'             VMI$ROOT:[SYSLIB.DECW$113].hB             %VMSINSTAL-I_RESTORE, Restoring product save set B ...B             %VMSINSTAL-I_RESTORE, Restoring product save set C ...B             %VMSINSTAL-I_RESTORE, Restoring product save set D ...B             %VMSINSTAL-I-RESTORE, Restoring product save set E ...B             %VMSINSTAL-I-RESTORE, Restoring product save set F ...B             %VMSINSTAL-I-RESTORE, Restoring product save set G ...B             %VMSINSTAL-I-RESTORE, Restoring product save set H ...B             %VMSINSTAL-I-RESTORE, Restoring product save set I ...B             %VMSINSTAL-I-RESTORE, Restoring product save set J ...B             %VMSINSTAL-I-RESTORE, Restoring product save set L ...Z             %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  C           o  If you perform the installation using 9-track magnetici=              tape, some of the files are compressed into text C              libraries. The installation procedure informs you that A              the data is being decompressed and displays messagesr&              similar to the following:  B             %VMSINSTAL-I_RESTORE, Restoring product save set B ...B             %VMSINSTAL-I_RESTORE, Restoring product save set C ...B             %VMSINSTAL-I_RESTORE, Restoring product save set D ...B             %VMSINSTAL-I_RESTORE, Restoring product save set E ...B             %VMSINSTAL-I-RESTORE, Restoring product save set F ...B             %VMSINSTAL-I-RESTORE, Restoring product save set G ...B             %VMSINSTAL-I-RESTORE, Restoring product save set H ...B             %VMSINSTAL-I-RESTORE, Restoring product save set I ...*             Decompressing H_E_DECW$INCLUDE$             Decompressing H_E_SYSLIBB             %VMSINSTAL-I_RESTORE, Restoring product save set J ...B             %VMSINSTAL-I-RESTORE, Restoring product save set L ...Z             %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  E           The installation procedure then informs you that a spuriousk?           error message will be displayed, which you can safelym           ignore:t             3-18 t  s      I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)yI                                                3.2 Installation Procedure     @               You can ignore the following NCP error message(s).  &               %NCP-I-SUCCESS,  Success               Object = X$X0p5               %NML-I-RECDELET, Database entry deletedp  D               The installation procedure then reminds you to installE               the language variant product after the installation, ife               necessary.  Y               If you wish to use any language other than English, install the appropriate K               DECwindows Motif Version 1.2-6 language variant product after .               this installation has completed.  C               You are notified that you should run the InstallationeA               Verification Procedure (IVP) after the installation C               is completed and after you start the DECwindows Motif C               software. (See Section 4.2 for more information aboutc               running the IVP.)d  S               The Installation Verification Procedure (IVP) should be run after thesV               installation has been completed and DECwindows Motif has been restarted.<               The IVP can be found in SYS$TEST:DECW$IVP.COM.  A         3.2.15 Using the AUTOGEN Utility to Set System Parametersr  I               The installation procedure might automatically run AUTOGEN,a>               depending on which type of system you are using:  (               o  A nonworkstation system  H                  If you install Compaq DECwindows Motif for OpenVMS on aI                  nonworkstation system (that is, an OpenVMS host system),n4                  the following message is displayed:  2                  This system is not a workstation.9                  It will not be necessary to run AUTOGEN.r  G               o  A workstation system that runs Compaq DECwindows Motif D                  for OpenVMS software with correct system parameters  F                  If you install Compaq DECwindows Motif for OpenVMS onD                  a workstation system and your system parameters are=                  correct, the following message is displayed:n  I                                                                      3-19i           :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    W               The installation procedure has determined that your system parameters arepV               set correctly and that it will not be necessary to run AUTOGEN or reboot               the system.   T               If your system is already running DECwindows Motif, restart DECwindows3               Motif with the following DCL command:e  6                    $ @SYS$MANAGER:DECW$STARTUP RESTART  V               If your system is NOT already running DECwindows Motif, start DECwindows3               Motif with the following DCL command:e  .                    $ @SYS$MANAGER:DECW$STARTUP  ;                                         * * * N O T E * * *   W               If you are installing DECwindows Motif from your workstation console, log.H               off after you enter the command to start DECwindows Motif.  C           o  A workstation system that runs Compaq DECwindows MotifsB              for OpenVMS software with incorrect system parameters  D              If you install Compaq DECwindows Motif for OpenVMS on aE              workstation system and your system parameters need to bel7              reset, the following message is displayed:C  R              The installation of DECwindows Motif has determined that some of yourP              system parameter values will require modification in order to startN              Compaq DECwindows Motif for OpenVMS, Version 1.2--6.  To set yourO              parameters correctly, run AUTOGEN using the following DCL command:f  H                      $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK  K              This will adjust your system parameters and reboot the system.t  C           o  A workstation system that runs Compaq DECwindows Motif B              for OpenVMS with incorrect system parameters, and you.              answered Yes to a system shutdown  M              The OpenVMS AUTOGEN procedure will now be run to set your system P              parameters. After that, your system will be automatically rebooted.  O              After the system has been rebooted, successful installation of the L              workstation software will be indicated by the appearance of the"              Start Session window.       3-20           I                    Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only) I                                                3.2 Installation Procedure     >                  %AUTOGEN-I-BEGIN, GETDATA phase is beginning.                   .                    .i                   .e@                  %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning.                   .                    .t                   .,?                  %AUTOGEN-I-BEGIN, GENFILES phase is beginning.e                   .                    .s                   . @                  %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning.                   .                    .                    .*  L                         Installation of DWMOTIFVAXU6 V1.2 completed at 10:57  Z                  %VMSINSTAL-I-SHUTDOWN, This product requires that the system be rebooted.  F                         SHUTDOWN -- Perform an Orderly System Shutdown2                                     on node NODE01                   .i                   .                    .   4         3.2.16 Completing the Installation Procedure  F               When the installation is completed, a message similar to)               the following is displayed:   B               Installation of DWMOTIFVAXU6 V1.2 completed at 10:57  /               VMSINSTAL procedure done at 12:45o  E               These messages indicate that the installation proceduree%               completed successfully.   @               Your system automatically shuts down if AUTOGEN isD               run; you must then reboot your system. See the upgradeD               and installation supplement for your VAX processor for8               instructions on how to reboot your system.    I                                                                      3-21            :     Using the VMSINSTAL Procedure (VMS Version 5.5-2 Only)     3.2 Installation Procedure    C              ________________________ Note ________________________n  @              If you upgrade your system with a higher version ofA              OpenVMS at a later time, you might need to reinstallt>              the Compaq DECwindows Motif for OpenVMS software.  C              ______________________________________________________        3.3 Recovering from Errors  @           Errors can occur during the installation if any of the%           following conditions exist:f  8           o  Incorrect OpenVMS operating system version.  !           o  Insufficient quotas.s  7           o  Insufficient values for system parameters.:  6           o  OpenVMS help library is currently in use.  :           o  Product license is not registered and loaded.  C           For descriptions of the error messages generated by these @           conditions, see the documents listed in the AssociatedD           Documents section in the Preface. These documents may helpC           you diagnose errors and decide what corrective actions tof           take.   #     3.4 Accessing the Release Notes*  E           During the installation, the VMSINSTAL procedure copies thenB           Compaq DECwindows Motif for OpenVMS Release Notes to the?           SYS$HELP:DECW$MOTIFU6012.RELEASE_NOTES file. Once youyD           return to DCL level, you can print this file or display itD           at a terminal. Refer to Section 3.2.5 for more information,           about accessing the release notes.                     3-22                         I                                                                         4 I         _________________________________________________________________n  I                                             After Installing the Software     G               This chapter discusses the tasks that you need to perform H               after the Compaq DECwindows Motif for OpenVMS installation               is completed:   D               o  Section 4.1, Starting the DECwindows Motif Software  -               o  Section 4.2, Running the IVPe  ;               o  Section 4.3, Choosing an Alternate Consolei  @               o  Section 4.4, Selecting the Desktop (Alpha Only)  F               If the DW-MOTIF license that is installed on your systemH               is not valid, appropriate messages display on your consoleI               terminal and DECwindows Motif is not automatically started.rI               If this situation occurs, log in to the system, install the2F               valid license, and start your DECwindows Motif software.H               For complete information on installing licenses using LMF,@               see the OpenVMS License Management Utility Manual.  2         4.1 Starting the DECwindows Motif Software  G               If you perform a system reboot following the installationeH               of DECwindows Motif, the DECwindows startup procedure runsE               automatically when the system reboots. On OpenVMS Alpha E               systems, either the New Desktop login dialog box or thefG               DECwindows desktop Start Session dialog box is displayed,sI               depending on the value of the DECW$START_NEW_DESKTOP globalbH               symbol. (See Section 4.4 for more information.) On OpenVMSD               VAX systems the Start Session dialog box is displayed.G               Proceed to Section 4.2 if you allowed a system reboot andz2               DECwindows has successfully started.  =               If you chose not to reboot the system after the D               installation, you must start or restart the DECwindowsI               Motif software by running the DECwindows startup procedure,oH               as described in the following paragraphs. When the startup  I                                                                       4-1r           !     After Installing the Softwareo.     4.1 Starting the DECwindows Motif Software    >           procedure has successfully completed, either the NewB           Desktop login dialog box or the DECwindows desktop Start>           Session dialog box is displayed, as explained in the           previous paragraph.   E           Compaq DECwindows Motif for OpenVMS software can be startedeD           only if your system parameters are correct. Proceed to oneA           of the following sections if your system parameters aree           correct:  .           o  Section 4.1.1, Standalone Systems  3           o  Section 4.1.2, OpenVMS Cluster Systems   D           If your system parameters are not correct, then use one of;           the following methods to adjust them accordingly:   (           o  Invoke the AUTOGEN utility:  @              $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK  @           o  Attempt to start the DECwindows Motif software. TheB              DECwindows Motif startup procedure checks your systemD              parameters. If they are too low, the procedure displays@              a series of messages describing the required systemB              parameters. These same parameters are adjusted in theE              system's MODPARAMS.DAT file. Then the procedure displaysu              following:y  A     Some SYSGEN parameters must be reset for DECwindows to start.rQ     If you type YES, AUTOGEN will change these parameters and reboot your system.hJ     If you type NO, AUTOGEN will not run or cause a reboot, but DECwindows     will not start.n  @     To run AUTOGEN at a later date, enter the following command:  9       $ @SYS$UPDATE:AUTOGEN getdata reboot check_feedbackn  8     Do you want the system to run AUTOGEN for you [Yes]?  D           After the system is rebooted and the startup is completed,0           the Start Session dialog box displays.  A           The Compaq DECwindows Motif for OpenVMS software is nows/           installed and running on your system.r  >           Run the Installation Verification Procedure (IVP) asB           described in Section 4.2 to verify that the installationE           of Compaq DECwindows Motif for OpenVMS software is complete]           and accurate.f       4-2t s  l      I                                             After Installing the Software_I                                4.1 Starting the DECwindows Motif Softwaret              4.1.1 Standalone Systems  C               Perform one of the following procedures to start yourh?               DECwindows Motif software on a standalone system:a  E               o  If your system is not running DECwindows Motif, then C                  start DECwindows Motif with the following command:_  ,                  $ @SYS$MANAGER:DECW$STARTUP  F               o  If your system is currently running DECwindows Motif,A                  then restart DECwindows Motif with the followingV                  command:c  4                  $ @SYS$MANAGER:DECW$STARTUP RESTART  F                 ________________________ Note ________________________  B                 If your system has a workstation display, then theA                 command to restart DECwindows Motif will end yourhF                 current session. The Start Session dialog box displaysF                 on your terminal, and you must log back in to continue'                 using DECwindows Motif.   F                 ______________________________________________________  E               The Compaq DECwindows Motif for OpenVMS software is nows3               installed and running on your system.y  D               Run the IVP as described in Section 4.2 to verify thatH               the installation of Compaq DECwindows Motif for OpenVMS is$               complete and accurate.  %         4.1.2 OpenVMS Cluster Systems   =               Starting Compaq DECwindows Motif for OpenVMS onoB               nonsatellite and satellite nodes is described in the#               sections that follow.   4         4.1.2.1 Starting Nonsatellite and Boot Nodes  F               To start Compaq DECwindows Motif for OpenVMS software onI               each of the nonsatellite nodes within your cluster, perform .               one of the following procedures:  E               o  If your system is not running DECwindows Motif, then_C                  start DECwindows Motif with the following command:d  ,                  $ @SYS$MANAGER:DECW$STARTUP  I                                                                       4-3C a  E      !     After Installing the Software .     4.1 Starting the DECwindows Motif Software    B           o  If your system is currently running DECwindows Motif,=              then restart DECwindows Motif with the followingl              command:f  0              $ @SYS$MANAGER:DECW$STARTUP RESTART  C              ________________________ Note ________________________i  8              If the nonsatellite node or boot node has a=              workstation display, then the command to restarte@              DECwindows Motif will end your current session. The@              Start Session dialog box displays on your terminal;=              log in again to continue using DECwindows Motif.o  C              ______________________________________________________r  A           The Compaq DECwindows Motif for OpenVMS software is now /           installed and running on your system.t  D           Run the IVP as described in Section 4.2 to verify that theA           installation of the Compaq DECwindows Motif for OpenVMSP+           product is complete and accurate.y  $     4.1.2.2 Starting Satellite Nodes  C           To start the Compaq DECwindows Motif for OpenVMS softwareo@           that is installed on the boot node, perform one of theD           following procedures on each satellite node in the clusterE           that will run Compaq DECwindows Motif for OpenVMS software:   D           o  If the node is not running DECwindows Motif, then start9              DECwindows Motif with the following command:l  (              $ @SYS$MANAGER:DECW$STARTUP  D           o  If the node is currently running DECwindows Motif, thenA              restart DECwindows Motif with the following command:   0              $ @SYS$MANAGER:DECW$STARTUP RESTART  D           Once DECwindows Motif is started or restarted on each nodeE           in the OpenVMS Cluster, then the installation is consideredo@           complete. Now run the IVP as described in Section 4.2.         4-4            I                                             After Installing the SoftwaretI                                                       4.2 Running the IVPl             4.2 Running the IVPm  G               Run the IVP, SYS$TEST:DECW$IVP.COM, after you install andyD               start the Compaq DECwindows Motif for OpenVMS product.G               This procedure contains four tests, which verify that theg=               software installation is complete and accurate.a  C               First, the IVP procedure attempts to run two display-tD               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 findI               the images, a message displays to inform you that the testsr               will not be run.  F                 ________________________ Note ________________________  F                 If you are invoking the IVP from a LAT Xterminal using@                 LAT software, enter the following command first:  H                 $ SET DISPLAY/CREATE/NODE=LAT_nnnnnnnnnnnn/TRANSPORT=LAT  >                 Substitute your actual LAT terminal number for                 nnnnnnnnnn.o  :                 Enter the default at the _Display: prompt.  F                 ______________________________________________________  ?               Next, the IVP runs two nondisplay-oriented tests.   I               o  The first of these tests invokes the Motif UIL compiler. D                  If you did not install programming support, the IVPG                  informs you that this test will not be run because the I                  Motif UIL image does not exist. If this test is run, you 7                  are notified of its completion status.e  I                                                                       4-5u y  m      !     After Installing the Software      4.2 Running the IVPn    B           o  The last test converts a text file to DDIF format andB              then converts it back to text, comparing the original?              text file with the result. If the files match, thesC              test is successful. You are notified of its completiony              status.  3           Example 4-1 shows you how to run the IVP.a       Example 4-1 Sample IVP       $ @SYS$TEST:DECW$IVP  .     Copyright 2000 Compaq Computer Corporation  Q     Compaq DECwindows Motif for OpenVMS Installation Verification Procedure (IVP)e  N     This IVP is intended to test some of the functionality of DECwindows Motif@     and to provide a quick method of verifying the installation.  H     This machine is not a workstation.  Please provide the nodename of aN     workstation on which to display the IVP tests.  You must be sure that thisN     account and node have security access to the display node, or the IVP will	     fail.d  M     To skip the display-oriented tests, press Ctrl/Z at the following prompt.Y       _Display: NODE33::0.0y  4     %DECW-I-IVP, The IVP will display on NODE33::0.0B     %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute.0     %DECW-I-IVP, Press Ctrl/Y to interrupt test.0     %DCL-S-SPAWNED, process DECW$IVP_ICO spawnedB     %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute.0     %DECW-I-IVP, Press Ctrl/Y to interrupt test.2     %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned3     %DECW-I-IVP, Invoking the UIL Motif compiler...fD     %DECW-S-IVP, The UIL Motif compiler test completed successfully.2     %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP...-     %DECW-S-IVP, CONVERT/DOCUMENT IVP passed.S'     %DECW-S-IVP, The IVP has completed.s     $              4-6f           I                                             After Installing the SoftwarerI                                         4.3 Choosing an Alternate Consoleg    )         4.3 Choosing an Alternate Consolet  E               The Compaq DECwindows Motif for OpenVMS software allows$G               you to boot all configurations from the main console. YouiG               can then toggle between displaying and not displaying the F               operator window by pressing Ctrl/F2. The main console is*               always a workstation screen.  C               If you are logged in to the main console (workstation E               screen), you must log out before DECwindows will start.e@               Issue the following command from the main console:  +                $  @SYS$MANAGER:DECW$STARTUP   G               Once the command procedure completes, log out of the mainMF               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.c  H               If you boot from the main console, the alternative consoleG               is connected when you invoke the DECwindows Motif startupr                command procedure.  A               If you boot the system from an alternative console,sC               you cannot start the Console Window application. Thist<               application is described in the release notes.  .         4.4 Selecting the Desktop (Alpha Only)  C               On OpenVMS Alpha systems, Compaq DECwindows Motif forrI               OpenVMS provides a choice of two desktops: the New Desktop,dI               which is derived from the Common Desktop Environment (CDE),e5               and the traditional DECwindows desktop.   H               During the installation, if you choose to install both theI               New Desktop and the DECwindows desktop, you are asked whicht9               desktop you wish to be the default desktop.b  I               To select the other desktop as the default desktop, performt"               the following steps.  I               1. If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM doesbI                  not exist, copy it from DECW$PRIVATE_APPS_SETUP.TEMPLATE H                  (or create it if an earlier version of DECwindows MotifE                  has not been installed on your system). For example:s  I                                                                       4-7            !     After Installing the Softwarec*     4.4 Selecting the Desktop (Alpha Only)    B              $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE ->              _$ SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM  A           2. Edit SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM and addSC              a symbol definition for DECW$START_NEW_DESKTOP. If youOD              wish the New Desktop as the default enter the following&              global symbol definition:  /              $ DECW$START_NEW_DESKTOP == "TRUE"n  E              If you wish the DECwindows desktop as the default, enterd4              the following global symbol definition:  0              $ DECW$START_NEW_DESKTOP == "FALSE"  <           3. Restart DECwindows using the following command:  0              $ @SYS$MANAGER:DECW$STARTUP RESTART                                                           4-8-                         I                                                                         5 I         _________________________________________________________________   I                                        Managing DECwindows Motif SoftwareN    B               This chapter contains information about managing theE               performance of your Compaq DECwindows Motif for OpenVMSp?               software. It also describes how to add and removev@               DECwindows Motif files from your system disk using@               tailoring utilities. See Managing DECwindows MotifB               for OpenVMS Systems for additional system management               information.  A               The following topics are discussed in this chapter:   D               o  Section 5.1, Customizing the DECwindows X11 Display)                  Server Startup Proceduree  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  G               After you install the Compaq DECwindows Motif for OpenVMSnF               product, you can tune your system to enhance performanceB               or to decrease the use of some system resources. For@               information about tuning your system, see Managing3               DECwindows Motif for OpenVMS Systems.   A         5.1 Customizing the DECwindows X11 Display Server Startup              Proceduret  D               The DECwindows X11 display server manages the graphicsI               devices on your workstation, such as the display, keyboard,s               and mouse.  F                 ________________________ Note ________________________  F                 Start the DECwindows X11 display server on workstation                 systems only.i  F                 ______________________________________________________  I                                                                       5-1o q  C      &     Managing DECwindows Motif SoftwareG     5.1 Customizing the DECwindows X11 Display Server Startup Procedurer    @           The startup command procedures automatically determineA           most of the configuration parameters for the DECwindows D           X11 display server. However, the command procedures cannot6           determine some items, such as the following:  9           o  Whether you have a 75-dpi or 100-dpi monitor   >           o  Whether you have a North American keyboard layoutB              (such as for an LK201-AA or -LA or an LK401-AA or -LA              keyboard)  @           o  Whether the DECwindows X11 display server uses only=              DECnet for OpenVMS software and local transports:  @           o  Whether the DECwindows X11 display server logs both?              successful and unsuccessful connect and disconnecti9              messages to the DECW$SERVER_n_ERROR.LOG file$  D           To ensure that the DECwindows X11 display server is set up?           correctly, modify the server startup file as follows:t  >           1. Make a copy of the file SYS$MANAGER:DECW$PRIVATE_3              SERVER_SETUP.TEMPLATE and rename it to <              SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM. ThisB              server startup file shows how to customize individualA              workstations by adding a section of DCL commands forM              each workstation.  @              You can add setup options in either of two sectionsC              in the server startup file. Setup options added to the E              "Cluster Common or Standalone Workstation Setup" sectioneB              affect all nodes in a cluster. Setup options added toD              the "Cluster Member Workstation-Specific Setup" sectionD              affect only individual nodes. If you add a workstation-E              specific option, you must also update the variable node_R              list.  ?           2. If your screen supports 100 dots-per-inch, add the               following line:  +              $ DECW$SERVER_DENSITY == "100"   C              Add this line to the section for each workstation thatyE              has a 100 dots-per-inch monitor, or add it to the commonOB              section for all workstations (if all the workstations$              have 100-dpi monitors).       5-2e t  t      I                                        Managing DECwindows Motif SoftwarenI       5.1 Customizing the DECwindows X11 Display Server Startup Proceduret    E               3. If you want the server to log successful connect and =                  disconnect messages, add the following line:e  4                  $ DECW$SERVER_CONNECT_LOG == "TRUE"  I               4. Add the following line to the section for monochrome GPX,                  workstations:  (                  $ DECW$COLOR == "FALSE"  G                  No modification is necessary for grayscale (intensity)e                  screens.   G               5. Add the following line to the section for workstations-I                  with keyboards that are not North American LK201 models:   1                  $ DECW$DEFAULT_KEYMAP == "xxxxx"-  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 aTH                  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:i                    nn-nnnnn-xx  G                  Use the xx part of this number to choose a keymap name D                  from Table 5-1. Choose the keymap ending in _DP forI                  data-processing keyboard layout and the keymap ending in +                  _TW for typewriter layout.   I                  Table 5-1 is arranged according to the dialect for whichr+                  each keyboard is designed.   F                  After you choose a keymap name, modify the DECwindowsH                  X11 display server startup file. For example, to changeF                  the keyboard layout to a Dutch typewriter layout, addH                  the following line to the DECwindows X11 display server                  startup file:  B                  $ DECW$DEFAULT_KEYBOARD_MAP == "DUTCH_LK201LH_TW"  I                                                                       5-3  e  n      &     Managing DECwindows Motif SoftwareG     5.1 Customizing the DECwindows X11 Display Server Startup Proceduren    B              Add a similar line for each workstation that does notB              have a North American keyboard layout or add the lineC              to the common section for all workstations (if all the_8              workstations use the same keyboard layout).  D           6. Enter the following command to restart DECwindows MotifD              on the workstations for which you customized the server4              startup by using the following command:  0              $ @SYS$MANAGER:DECW$STARTUP RESTART                                                                           5-4_ _  _      I                                        Managing DECwindows Motif SoftwareaI       5.1 Customizing the DECwindows X11 Display Server Startup Procedureu    I         Table_5-1_DECwindows_Keymap______________________________________n  I         Dialect_________Model_____________DECwindows_Keymap______________n  D         Austrian/German LK201-            AUSTRIAN_GERMAN_LK201LG_DP%                         (AG,LG,BG,MG)V  D                                           AUSTRIAN_GERMAN_LK201LG_TW  D                         LK201-(NG,PG)     AUSTRIAN_GERMAN_LK201NG_DP  D                                           AUSTRIAN_GERMAN_LK201NG_TW  D                         LK401-(AG)        AUSTRIAN_GERMAN_LK401AG_TW  C         Belgian/French  LK201-            BELGIAN_FRENCH_LK201LP_DP %                         (AP,LP,BP,MP)   C                                           BELGIAN_FRENCH_LK201LP_TW   C         Belgian/French  LK401-(AP)        BELGIAN_FRENCH_LK401AP_DP   C                                           BELGIAN_FRENCH_LK401AP_TWw  <         British         LK201-            BRITISH_LK201LE_DP%                         (AE,LE,BE,ME)s  <                                           BRITISH_LK201LE_TW  <         British         LK401-(AA,PA)     BRITISH_LK401AA_DP  <                                           BRITISH_LK401AA_TW  D         Canadian/French LK201-            CANADIAN_FRENCH_LK201LC_DP%                         (AC,LC,BC,MC)   D                                           CANADIAN_FRENCH_LK201LC_TW  D         Canadian/French LK401-            CANADIAN_FRENCH_LK401AC_DP%                         (AC,LC,BC,MC)s  D                                           CANADIAN_FRENCH_LK401AC_TW  ;         Danish          LK201-            DANISH_LK201LD_DPm%                         (AD,LD,BD,MD)   ;                                           DANISH_LK201LD_TW   ;                         LK201-(ED,RD,FD)  DANISH_LK201RD_DPn  ;                                           DANISH_LK201RD_TWl  ;         Danish          LK401-            DANISH_LK401AD_DP %                         (AD,LD,BD,MD)   ;                                           DANISH_LK401AD_TW   I                                                  (continued on next page)   I                                                                       5-5s h  V      &     Managing DECwindows Motif SoftwareG     5.1 Customizing the DECwindows X11 Display Server Startup Procedurem    E     Table_5-1_(Cont.)_DECwindows_Keymap______________________________n  E     Dialect_________Model_____________DECwindows_Keymap_______________  6     Dutch           LK201-            DUTCH_LK201LH_DP!                     (AH,LH,BH,MH)   6                                       DUTCH_LK201LH_TW  3                     LK201-(NH,PH)     DUTCH_LK201NHn  3                     LK401-(NH,PH)     DUTCH_LK401AHc  8     Finnish         LK201-            FINNISH_LK201LF_DP!                     (AF,LF,BF,MF)   8                                       FINNISH_LK201LF_TW  8                     LK201-(NX,PX)     FINNISH_LK201NX_DP  8                                       FINNISH_LK201NX_TW  8     Finnish         LK401-            FINNISH_LK401AF_DP!                     (AF,LF,BF,MF)o  8                                       FINNISH_LK401AF_TW  8     Flemish         LK201-            FLEMISH_LK201LB_DP!                     (AB,LB,BB,MB)   8                                       FLEMISH_LK201LB_TW  8     Flemish         LK401-            FLEMISH_LK401AB_DP!                     (AB,LB,BB,MB)   8                                       FLEMISH_LK401AB_TW  :     Icelandic       LK201-            ICELANDIC_LK201LU_DP!                     (AU,LU,BU,MU)a  :                                       ICELANDIC_LK201LU_TW  8     Italian         LK201-            ITALIAN_LK201LI_DP!                     (AI,LI,BI,MI)s  8                                       ITALIAN_LK201LI_TW  8     Italian         LK401-            ITALIAN_LK401AI_DP!                     (AI,LI,BI,MI)P  8                                       ITALIAN_LK401AI_TW  <     North American  LK201-            NORTH_AMERICAN_LK201LA!                     (AA,LA,BA,MA)I  E                                              (continued on next page)w       5-6f    n      I                                        Managing DECwindows Motif Software I       5.1 Customizing the DECwindows X11 Display Server Startup Procedurei    I         Table_5-1_(Cont.)_DECwindows_Keymap______________________________h  I         Dialect_________Model_____________DECwindows_Keymap______________o  @         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_DP  >                                           NORWEGIAN_LK201RN_TW  >         Norwegian       LK401-            NORWEGIAN_LK401AN_DP%                         (AN,LN,BN,MN)v  >                                           NORWEGIAN_LK401AN_TW  <         Portuguese      LK201-            PORTUGUESE_LK201LV%                         (AV,LV,BV,MV)V  <         Portuguese      LK401-            PORTUGUESE_LK401AV%                         (AV,LV,BV,MV)   <         Spanish         LK201-            SPANISH_LK201LS_DP%                         (AS,LS,BS,MS)   <                                           SPANISH_LK201LS_TW  <         Spanish         LK401-            SPANISH_LK401AS_DP%                         (AS,LS,BS,MS)t  <                                           SPANISH_LK401AS_TW  <         Swedish         LK201-            SWEDISH_LK201LM_DP%                         (AM,LM,BM,MM)   <                                           SWEDISH_LK201LM_TW  <                         LK201-(NM,PM)     SWEDISH_LK201NM_DP  <                                           SWEDISH_LK201NM_TW  <         Swedish         LK401-            SWEDISH_LK401AM_DP%                         (AM,LM,BM,MM)   <                                           SWEDISH_LK401AM_TW  A         Swiss/French    LK201-            SWISS_FRENCH_LK201LK_DP %                         (AK,LK,BK,MK)h  A                                           SWISS_FRENCH_LK201LK_TWn  I                                                  (continued on next page)l  I                                                                       5-7            &     Managing DECwindows Motif SoftwareG     5.1 Customizing the DECwindows X11 Display Server Startup Procedured    E     Table_5-1_(Cont.)_DECwindows_Keymap______________________________u  E     Dialect_________Model_____________DECwindows_Keymap______________s  =     Swiss/French    LK401-            SWISS_FRENCH_LK401AK_DPt!                     (AK,LK,BK,MK)e  =                                       SWISS_FRENCH_LK401AK_TW   =     Swiss/German    LK201-            SWISS_GERMAN_LK201LL_DP !                     (AL,LL,BL,ML)f  =                                       SWISS_GERMAN_LK201LL_TWf  =     Swiss/German    LK401-            SWISS_GERMAN_LK401AL_DP !                     (AL,LL,BL,ML)   =                                       SWISS_GERMAN_LK401AL_TWo  0     Combined US/UK  LK201-(EE,RE,PE)  UK_LK201RE  0                                       US_LK201RE  0     Combined US/UK  LK401-(EE,RE,PE)  UK_LK401AA  E     __________________________________US_LK401AA_____________________   D     5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)  @           Use the DECW$MOTIF_TAILOR utility to remove DECwindows@           Motif files from the system disk (for example, supportC           files for the Toolkit, applications, and programming). IfsE           you later decide that you want DECwindows Motif programming C           support, add the files to the system disk by reinstalling B           the system. See Section 5.3 for information about adding           files.  C              ________________________ Note ________________________   :              Use the DECW$MOTIF_TAILOR utility only if youA              installed the DECwindows Motif for OpenVMS kit using >              VMSINSTAL. If you installed the Compaq DECwindows@              Motif for OpenVMS kit using the POLYCENTER Software@              Installation utility (PCSI), remove files using theA              PCSI commands PRODUCT REMOVE or PRODUCT RECONFIGURE.D?              (For more information on PCSI commands, enter HELPiA              PRODUCT at the DCL prompt or refer to the POLYCENTERO9              Software Installation Utility User's Guide.)o  C              ______________________________________________________        5-8            I                                        Managing DECwindows Motif Software I          5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)_    @               The DECW$MOTIF_TAILOR process includes two phases:  E               o  The first phase lists each class of DECwindows Motif I                  files and asks whether you want to delete the class from !                  the system disk.D  F               o  The second phase deletes the files you indicated from!                  the system disk.   D               Table 5-2 lists the classes (or groups) and subclassesE               of DECwindows Motif files that you can delete using the G               DECW$MOTIF_TAILOR utility. For a list of DECwindows Motif G               files and their descriptions and classes, see Appendix C.   I               Table 5-2 Classes of OpenVMS Files That Can Be Removed with I               __________the_DECW$MOTIF_TAILOR_Utility____________________W  I               Class__________Subclass_______Description__________________   E               VMS            No subclasses  DECwindows Motif run-time 4               DECwindows     in this        support.)               run-time       tailor classD               supportn  I               VMS            No subclasses  DECwindows Motif CDA support. $               DECwindows     in this)               CDA support    tailor class   @               VMS            DECwindows     The DECwindows MotifF               DECwindows     Motif          applications files provideF               Motif          computer-      a variety of applications."               applications   based(               files          instruction"                              (CBI)  I                                                  (continued on next page)_                  I                                                                       5-9y r         &     Managing DECwindows Motif SoftwareD     5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)    @           Table 5-2 (Cont.) Classes of OpenVMS Files That Can Be>                             Removed with the DECW$MOTIF_TAILORE           __________________Utility__________________________________d  E           Class__________Subclass_______Description__________________e  :           DECwindows     No subclasses  DECwindows Motif CA           Motif C        in this        programming support fileseB           programming    tailor class   are needed only to develop@           support files                 applications and are notB                                         required to run DECwindowsA                                         Motif applications. These >                                         files are provided forE                                         programming in the C languaget=                                         using conventions andeB                                         standards developed at theB                                         Massachusetts Institute of9                                         Technology (MIT).   A           DECwindows     No subclasses  FORTRAN support files are E           FORTRAN        in this        provided for this programmingR?           programming    tailor class   language. The files are >           support files                 needed only to develop@                                         applications and are notB                                         required to run DECwindows;                                         Motif applications.o  @           DECwindows     No subclasses  Pascal support files areE           Pascal         in this        provided for this programmingn?           programming    tailor class   language. The files are >           support files                 needed only to develop@                                         applications and are notB                                         required to run DECwindows;                                         Motif applications.   E                                              (continued on next page)h                       5-10 :         I                                        Managing DECwindows Motif Software I          5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)n    D               Table 5-2 (Cont.) Classes of OpenVMS Files That Can BeB                                 Removed with the DECW$MOTIF_TAILORI               __________________Utility__________________________________n  I               Class__________Subclass_______Description__________________   D               DECwindows     No subclasses  DECwindows Motif example2               Motif example  in this        files.)               files          tailor class   G               Sound editor   No subclasses  Sound-editor support files.f$               support files  in this)                              tailor class   D               NCSA Mosaic    No subclasses  NCSA Mosaic web browser.$                              in thisI               _______________tailor_class________________________________l  B               Removing DECwindows Motif Files from the System Disk  G               To remove DECwindows Motif files from the system disk, doL               the following:  .               1. Log in to the SYSTEM account.  ?               2. Enter the following command at the DCL prompt:t  3                  $ RUN SYS$UPDATE:DECW$MOTIF_TAILORl  F                  After a brief overview, the DECW$MOTIF_TAILOR utilityE                  lists each group, or class, of files and its size inhG                  blocks. Files are grouped according to their function. G                  For example, all the files required for DECwindows foriI                  OpenVMS device support are in one class. A file class isdG                  made up of many small subclasses. You can eliminate anrH                  entire class of files, or you can eliminate one or more0                  of its subclasses. For example:  @                  CLASS - VMS DECwindows Motif applications filesK                               Size of entire class (with subclasses): 12181kS                               Size of common files required for any subclass: 11160 T                               Do you wish to select the entire class (default = NO)?Y                               Do you wish to select any of its subclasses (default = NO)?m                            .                            .                            .  I                                                                      5-11            &     Managing DECwindows Motif SoftwareD     5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)    ?           3. Decide which file classes or subclasses you do not ?              need to support your system. The DECW$MOTIF_TAILORn?              utility displays step-by-step instructions. FollownB              these instructions to specify which of the classes or+              subclasses you want to remove.t  @           4. The DECW$MOTIF_TAILOR utility deletes the files you:              select and displays the names of those files.  D           You can ignore "file not found" messages in the log files;E           tailoring functions are not affected by these messages. TheoE           installation procedure deletes files that it does not read.   D              _______________________ Caution _______________________  @              To cancel DECW$MOTIF_TAILOR during the first phase,;              press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel C              DECW$MOTIF_TAILOR during the second phase, a partiallyf@              tailored disk may result. For a description of both%              phases, see Section 5.2._  C              ______________________________________________________   B           Example 5-1 shows how to use DECW$MOTIF_TAILOR to remove#           files from a system disk.   0     Example 5-1 Sample DECW$MOTIF_TAILOR Session  &     $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR        .        .        .       TAILOR-OFF     ----------J      You will now be prompted with a list of the classes and subclasses ofO      DECwindows files that are optional. The size of each class and subclass isKO      included in the list. This will help you decide whether or not you want to 1      remove a class or subclass from your system.   P      Under some classes there is a set of common files that is required in orderO      for any subclasses to work. These files will only be deleted if you remove O      the ENTIRE class. If you choose to keep any subclass, this set of files is       not deleted.0  E                                              (continued on next page)        5-12           I                                        Managing DECwindows Motif SoftwareAI          5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)S    <         Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session  M          NOTE: The files associated with selected classes and subclasses will +                be removed from your system._  8         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.  .         CLASS - VMS DECwindows Runtime Support?                   Size of entire class (with subclasses): 27303 5                   No subclasses in this tailor class. Q                   Do you wish to select the entire class (default = NO)? <Return>   *         CLASS - VMS DECwindows CDA Support>                   Size of entire class (with subclasses): 36255                   No subclasses in this tailor class. L                   Do you wish to select the entire class (default = NO)? Yes  7         CLASS - VMS DECwindows Motif applications files ?                   Size of entire class (with subclasses): 12181VC               Size of common files required for any subclass: 11160hM               Do you wish to select the entire class (default = NO)? <Return>ER               Do you wish to select any of its subclasses (default = NO)? <Return>  6         CLASS - DECwindows C programming support files>                   Size of entire class (with subclasses): 67271               No subclasses in this tailor class.UL                   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.KL                   Do you wish to select the entire class (default = NO)? Yes  I                                                  (continued on next page)_  I                                                                      5-13            &     Managing DECwindows Motif SoftwareD     5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5-2 Only)    8     Example 5-1 (Cont.) Sample DECW$MOTIF_TAILOR Session  &     CLASS - Sound editor support files:               Size of entire class (with subclasses): 1776-           No subclasses in this tailor class.0H               Do you wish to select the entire class (default = NO)? Yes       CLASS - NCSA Mosaic,:               Size of entire class (with subclasses): 1168-           No subclasses in this tailor class. M               Do you wish to select the entire class (default = NO)? <Return>        Files have been selected?     Do you wish to remove all of the options selected? <Return>.:     Do you wish to remove all of the options selected? Yes"     Removing files, please wait...N     %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[CDA$LIBRARY]DEFSTYLE.DDIF;*V     %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$CSW.UID;*W     %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEW.UID;* Z     %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT.UID;*\     %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT12.UID;*K     %VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSEXE]CDA$CONVERT.EXE;*      .      .A     .,  ,     5.3 Adding DECwindows Base-Support Files  B           If you previously chose not to install or if you removed>           DECwindows base-support software, perform one of theD           following procedures to add DECwindows base-support files:  @           o  On OpenVMS Alpha systems, reconfigure the operating=              system specifying that you want DECwindows Motif               support.   ,           o  On OpenVMS VAX systems, use theB              SYS$UPDATE:DECW$TAILOR.EXE procedure to add or remove0              support files from the system disk.                 5-14 N  _      I                                        Managing DECwindows Motif Software I                                  5.3 Adding DECwindows Base-Support Files     E         5.3.1 Reconfiguring the OpenVMS Operating System (Alpha Only)K  F               To reconfigure the OpenVMS Alpha operating system to addC               DECwindows Motif support, use the PRODUCT RECONFIGURE                command.  E         5.3.2 Using the SYS$UPDATE:DECW$TAILOR.EXE Command (VAX 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.  G               DECW$TAILOR is similar to DECW$MOTIF_TAILOR. However, the E               DECW$TAILOR utility is used to add or remove files that G               support the DECwindows display server (for example: base-w4               support, workstation, and font files).  0               DECW$TAILOR includes three phases:  E               o  The first phase asks whether you want to tailor yourcD                  system by adding files ("tailor on") or by deleting&                  files ("tailor off").  A               o  In the second phase, if you choose the tailor-on F                  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, E                  DECW$TAILOR lists each class of DECwindows files and E                  asks whether you want to delete them from the systemW                  disk.  A               o  In the third phase, DECW$TAILOR carries out your                   instructions.  F                 ________________________ Note ________________________  A                 To cancel DECW$TAILOR during the first and second ?                 phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you F                 cancel DECW$TAILOR during the third phase, a partially)                 tailored disk may result.s  F                 ______________________________________________________  F               Table 5-3 lists the classes and subclasses of DECwindowsE               files that you can add or remove from your system using                DECW$TAILOR.  I                                                                      5-15_ _  _      &     Managing DECwindows Motif Software,     5.3 Adding DECwindows Base-Support Files    C              ________________________ Note ________________________   @              VMS Version 5.5-2 uses different class names. These<              are shown in parentheses below the name used in)              Version 6.2 and Version 7.1.P  C              ______________________________________________________   A           Table 5-3 Classes of Files That Can Be Added or RemovedcE           __________with_the_DECW$TAILOR_Utility_____________________o  E           Class__________Subclass_______Description__________________.  B           DECwindows     No subclasses  Files necessary to run theC           base support   in this        DECwindows Motif client and B           files          tailor class   DECwindows display server.           (DECwindows            applications           files)  B           DECwindows     PEX for PHIGS  Files necessary to run theB           workstation    support files  DECwindows display server;A           support files                 the PEX subclass includes @           (DECwindows                   support files for three-=           device                        dimensional graphics.e           support            files)  @           75-dpi video   No subclasses  Device support files for8           font files     in this        75-dpi monitors.%                          tailor classs  @           100-dpi video  No subclasses  Device support files for9           font files     in this        100-dpi monitors.sE           _______________tailor_class_________________________________  4           Adding DECwindows Files to the System Disk  A           To add DECwindows files to the system disk, perform the_           following steps:  *           1. Log in to the SYSTEM account.  D           2. Enter the following command at the DCL prompt to invoke              the utility:D  )              $ RUN SYS$UPDATE:DECW$TAILOR        5-16 u  a      I                                        Managing DECwindows Motif Software I                                  5.3 Adding DECwindows Base-Support Filesd    F                  After a brief overview, the DECW$TAILOR program listsG                  each group, or class, of files and its size in blocks.aC                  Files are grouped according to their function. For F                  example, all the files required for DECwindows deviceE                  support are in one class. A file class is made up of_C                  many small subclasses. You can eliminate an entire D                  class of files, or you can eliminate one or more of-                  its subclasses. For example:t  8                  CLASS - DECwindows device support filesH                            Size of entire class (with subclasses): 14107P                            Size of common files required for any subclass: 10645Q                            Do you wish to select the entire class (default = NO)?_V                            Do you wish to select any of its subclasses (default = NO)?                     .                      .i                     .m  F               3. Decide which file classes or subclasses are needed toG                  support your system. DECW$TAILOR displays step-by-step I                  instructions. Follow these instructions to specify which >                  of the classes or subclasses you want to add.  G                 _______________________ Caution _______________________m  F                 To cancel DECW$TAILOR during this phase, press Ctrl/C,F                 Ctrl/Y, or Ctrl/Z. If you cancel DECW$TAILOR followingE                 this class selection phase, a partially tailored diskt                 may result.   F                 ______________________________________________________  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.   F                 ______________________________________________________  I               5. DECW$TAILOR adds the files you selected and displays the &                  names of those files.  I                                                                      5-17  e         &     Managing DECwindows Motif Software,     5.3 Adding DECwindows Base-Support Files    D           Example 5-2 shows how to use DECW$TAILOR to add files to aA           system disk. The example was run on a VMS 5.5-2 system.   *     Example 5-2 Sample DECW$TAILOR Session        $ RUN SYS$UPDATE:DECW$TAILOR        .        .        .  2      Do you want to tailor files "ON" or "OFF"? ON  
     TAILOR-ONf
     --------- G      You will now be prompted with a list of the classes and subclasses R      of DECwindows files that are optional. The size of each class and subclass isS      included in the list. This will help you decide whether or not you want to addt(      a class or subclass to your system.  Q      Under some classes, there is a set of common files that is required in order C      for any subclasses to work. These files are added when you ask :      for either the entire class or any of its subclasses.  4     Total size of the system disk is 1216665 blocks.:     Total space used on the system disk is 1121958 blocks.8     Total space left on the system disk is 94707 blocks.  )     CLASS - DECwindows applications filesN;               Size of entire class (with subclasses): 11544 1               No subclasses in this tailor class._H               Do you wish to select the entire class (default = NO)? YES  +     CLASS - DECwindows device support files ;               Size of entire class (with subclasses): 14107LC               Size of common files required for any subclass: 10645EM               Do you wish to select the entire class (default = NO)? <Return> R               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): 25391               No subclasses in this tailor class.aM               Do you wish to select the entire class (default = NO)? <Return>r  E                                              (continued on next page)e       5-18 c  s      I                                        Managing DECwindows Motif Software I                                  5.3 Adding DECwindows Base-Support Files     6         Example 5-2 (Cont.) Sample DECW$TAILOR Session  2         CLASS - 100 dots per inch video font files>                   Size of entire class (with subclasses): 38295                   No subclasses in this tailor class.mQ                   Do you wish to select the entire class (default = NO)? <Return>s  4         CLASS - DECwindows programming support files?                   Size of entire class (with subclasses): 26208dE                   Size of common files required for any subclass: 924 Q                   Do you wish to select the entire class (default = NO)? <Return> V                   Do you wish to select any of its subclasses (default = NO)? <Return>           CLASS - Example filesl>                   Size of entire class (with subclasses): 31605                   No subclasses in this tailor class.oQ                   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:            .            .            .                                          I                                                                      5-19  e  d      &     Managing DECwindows Motif Software*     5.4 Determining and Reporting Problems    *     5.4 Determining and Reporting Problems  ;           If you encounter a problem while using DECwindowsOA           Motif, report it to Compaq. Review the Software Product/B           Description (SPD) for an explanation of warranty. If youA           encounter a problem during the warranty period, you canl,           take one of the following actions:  E           o  Call your Compaq support representative if your software_E              contract or warranty agreement entitles you to telephoneI              support.   B           o  If you discover a problem with or have comments about=              the documentation, print or edit the online form >              SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us yourB              comments by Internet, fax, or mail. (See the Reader's<              Comments section in the Preface for addresses.)                                                             5-20 e  e                    I                                                                         AsI         _________________________________________________________________f  I             POLYCENTER Software Installation Utility Sample Installations     G               This appendix contains sample installations of the Compaq D               DECwindows Motif for OpenVMS software on the following               OpenVMS systems:  ?               o  Section A.1 presents a sample DECwindows Motif I                  installation on an OpenVMS Alpha Version 7.1-2 operatingy                  system.  ?               o  Section A.2 presents a sample DECwindows Motif E                  installation on an OpenVMS VAX Version 7.1 operatings                  system.  ?               o  Section A.3 presents a sample DECwindows MotifsG                  installation on an OpenVMS Alpha Version 6.2 operating2                  system.  G               Refer to Chapter 2 for details about using the POLYCENTERwH               Software Installation utility to install Compaq DECwindows)               Motif for OpenVMS software.s  C               The sample installations assume that you have set the @               default directory to the device name and directoryI               containing the PCSI ECO and DECwindows Motif savesets. (The)E               PCSI ECO is only required for the supported versions of G               OpenVMS prior to Version 7.2. See the Guide to the Compaq H               DECwindows Motif for OpenVMS CD-ROM for details about this               ECO.)(                  I                                                                       A-1h           A     POLYCENTER Software Installation Utility Sample Installations D     A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 System    D     A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 System  E           Example A-1 contains a sample installation of the mandatory E           PCSI ECO. Example A-2 contains a sample installation of theoD           Compaq DECwindows Motif for OpenVMS software on an OpenVMSE           Alpha Version 7.1-2 operating system with sufficient systeme           resources.  D     Example A-1 Sample Installation of the Mandatory ECO for PCSI on'                 an OpenVMS Alpha Systemc  H               Welcome to the OpenVMS Alpha Operating System, Version 7.1  /     $ PRODUCT INSTALL VMS62TO71U2_PCSI <Return>s  ,     The following product has been selected:J         DEC AXPVMS VMS62TO71U2_PCSI V1.0        Patch (maintenance update)  +     Do you want to continue? [YES] <Return>   $     Configuration phase starting ...  R     You will be asked to choose options, if any, for each selected product and forS     any products that may be installed to satisfy software dependency requirements.s  $     DEC AXPVMS VMS62TO71U2_PCSI V1.0  ;     * This product does not have any configuration options.         Execution phase starting ...  ;     The following product will be installed to destination:gD         DEC AXPVMS VMS62TO71U2_PCSI V1.0        DISK$2:[VMS$COMMON.]       Portion done: 0%
     ...10%
     ...20%
     ...40%
     ...50%
     ...80%
     ...90%  E                                              (continued on next page)i         A-2) 7         I             POLYCENTER Software Installation Utility Sample InstallationscI          A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 System     H         Example A-1 (Cont.) Sample Installation of the Mandatory ECO for;                             PCSI on an OpenVMS Alpha System            ...100%l  1         The following product has been installed: N             DEC AXPVMS VMS62TO71U2_PCSI V1.0        Patch (maintenance update)                                                                            I                                                                       A-3. F         A     POLYCENTER Software Installation Utility Sample InstallationsDD     A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 System    ?     Example A-2 Sample Installation of an Upgrade of DECwindowseC                 Motif on an OpenVMS Alpha Version 7.1-2 System With-+                 Sufficient System ResourcesA  &     $ PRODUCT INSTALL DWMOTIF <Return>  ,     The following product has been selected:>         DEC AXPVMS DWMOTIF V1.2-6              Layered Product  +     Do you want to continue? [YES] <Return>u  $     Configuration phase starting ...  R     You will be asked to choose options, if any, for each selected product and forS     any products that may be installed to satisfy software dependency requirements.   /     DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif   2         Copyright 2000 Compaq Computer Corporation  #         Compaq Computer CorporationO  +         This product uses the PAK: DW-MOTIFS  +     Checking values of system parameters...o,                                           OK  <     Do you want the defaults for all options? [YES] <Return>  R         If a Local Language Variant is installed, refer to the Installation Guide.  /         Do you want to continue? [YES] <Return>   6     Do you want to review the options? [NO] Y <Return>  /     DEC AXPVMS DWMOTIF V1.2-6: DECwindows MotifV'         DEC AXPVMS VMS V7.1 [Installed]           Install New Desktop: YESC           Install Manual (reference) pages for the New Desktop: YESs7           Make the New Desktop the default desktop: YES 3         Install traditional DECwindows Desktop: YESa3         Programming Support for the C Language: YESa  E                                              (continued on next page)m       A-4W T  T      I             POLYCENTER Software Installation Utility Sample InstallationsfI          A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 Systeme    @         Example A-2 (Cont.) Sample Installation of an Upgrade ofH                             DECwindows Motif on an OpenVMS Alpha VersionI                             7.1-2 System With Sufficient System Resourcesd  <             Programming Support for the Pascal Language: YES=             Programming Support for the FORTRAN Language: YESc8             Programming Support for the New Desktop: YES%             Programming examples: YES &               Sound example files: YES<                     Programming examples for DECwindows: YES;               Programming examples for the New Desktop: YES$  =         Are you satisfied with these options? [YES]  <Return>   $         Execution phase starting ...  ?         The following product will be installed to destination:hG             DEC AXPVMS DWMOTIF V1.2-6              DISK$2:[VMS$COMMON.] ?         The following product will be removed from destination:_G             DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.]n           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%   1         The following product has been installed: B             DEC AXPVMS DWMOTIF V1.2-6              Layered Product/         The following product has been removed:   I                                                  (continued on next page)a    I                                                                       A-5_ _  _      A     POLYCENTER Software Installation Utility Sample Installations D     A.1 Sample Installation on an OpenVMS Alpha Version 7.1-2 System    <     Example A-2 (Cont.) Sample Installation of an Upgrade ofD                         DECwindows Motif on an OpenVMS Alpha VersionE                         7.1-2 System With Sufficient System ResourcesC  >         DEC AXPVMS DWMOTIF V1.2-5              Layered Product  /     DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif   N         System reboot will be required following upgrade of language variants.  D         Installation Verification Procedure can be run after reboot.     $ Logout <Return>E                                                                       A-6            I             POLYCENTER Software Installation Utility Sample Installations I              A.2 Sample Installation on an OpenVMS VAX Version 7.1 Systemu    D         A.2 Sample Installation on an OpenVMS VAX Version 7.1 System  F               Example A-3 contains a sample installation of the CompaqE               DECwindows Motif for OpenVMS software on an OpenVMS VAXeC               Version 7.1 operating system with insufficient systemr               resources.  ?         Example A-3 Sample Installation of an Upgrade of CompaqlB                     DECwindows Motif for OpenVMS on an OpenVMS VAXI                     Version 7.1 System With Insufficient System Resources   0         The following product has been selected:B             DEC VAXVMS DWMOTIF V1.2-6              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.S  3         DEC VAXVMS DWMOTIF V1.2-6: DECwindows Motif   3          Copyright 2000 Compaq Computer Corporationf  '             Compaq Computer Corporation   /             This product uses the PAK: DW-MOTIF   /         Checking values of system parameters...RZ           %DECW-W-BADVALUE, SYSGEN parameter PQL_MBYTLM is 40000, should be at least 48000  U           The installation procedure has determined that some system parameter valuespP           require modification to install the DECwindows Motif Version 1.2-6 for           OpenVMS software.d  Q           Please type the following command to run AUTOGEN and reboot your system R           before restarting the DECwindows installation.  This will set the systemO           parameters to appropriate values for running DECwindows Motif V1.2-6.f  A                 @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACKs  I                                                  (continued on next page)b    I                                                                       A-7  f  t      A     POLYCENTER Software Installation Utility Sample Installationsc@     A.2 Sample Installation on an OpenVMS VAX Version 7.1 System    C     Example A-3 (Cont.) Sample Installation of an Upgrade of CompaqsB                         DECwindows Motif for OpenVMS on an OpenVMS@                         VAX Version 7.1 System With Insufficient(                         System Resources  4     The DECwindows installation is being terminated.  4     Please run AUTOGEN and restart the installation.  &     %PCSI-E-S_OPFAIL, operation failedQ     %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error conditionl  8       SYSTEM       logged out at 20-NOV-2000 17:03:49.25  9           At this point, run AUTOGEN and then restart thet           installation.u  ,     The following product has been selected:>         DEC VAXVMS DWMOTIF V1.2-6              Layered Product  "     Do you want to continue? [YES]  $     Configuration phase starting ...  R     You will be asked to choose options, if any, for each selected product and forE     any products that may be installed to satisfy software dependency      requirements.d  /     DEC VAXVMS DWMOTIF V1.2-6: DECwindows Motifi  .     Copyright 2000 Compaq Computer Corporation  #         Compaq Computer Corporation_  +         This product uses the PAK: DW-MOTIFD  +     Checking values of system parameters...l  -                                            OK   3     Do you want the defaults for all options? [YES]   E                                              (continued on next page)e         A-8i D  i      I             POLYCENTER Software Installation Utility Sample InstallationstI              A.2 Sample Installation on an OpenVMS VAX Version 7.1 System     G         Example A-3 (Cont.) Sample Installation of an Upgrade of CompaqEF                             DECwindows Motif for OpenVMS on an OpenVMSD                             VAX Version 7.1 System With Insufficient,                             System Resources  V             If a Local Language Variant is installed, refer to the Installation Guide.  )            Do you want to continue? [YES]i  9         Do you want to review the options? [NO]Y <Return>a  3         DEC VAXVMS DWMOTIF V1.2-6: DECwindows Motife+             DEC VAXVMS VMS V7.1 [Installed]u7             DECwindows Motif runtime support files: YESl=                   Programming Support for the C Language: YES =             Programming Support for the FORTRAN Language: YES1<             Programming Support for the Pascal Language: YES%             Programming examples: YESh  ;         Are you satisfied with these options? [YES]<Return>a$         Execution phase starting ...  ?         The following product will be installed to destination:nR             DEC VAXVMS DWMOTIF V1.2-6              DISK$VAX71_124_P2:[VMS$COMMON.]?         The following product will be removed from destination: R             DEC VAXVMS DWMOTIF V1.2-5              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 ****<           **** DECwindows device support files DETECTED ****           ...100%e  I                                                  (continued on next page)s  I                                                                       A-9o n         A     POLYCENTER Software Installation Utility Sample Installations @     A.2 Sample Installation on an OpenVMS VAX Version 7.1 System    C     Example A-3 (Cont.) Sample Installation of an Upgrade of Compaq B                         DECwindows Motif for OpenVMS on an OpenVMS@                         VAX Version 7.1 System With Insufficient(                         System Resources  -     The following product has been installed: >         DEC VAXVMS DWMOTIF V1.2-6              Layered Product+     The following product has been removed:i>         DEC VAXVMS DWMOTIF V1.2-5              Layered Product  /     DEC VAXVMS DWMOTIF V1.2-6: DECwindows Motifn  N         System reboot will be required following upgrade of language variants.  D         Installation Verification Procedure can be run after reboot.6            DEC VAXVMS DWMOTIF V1.2-6: DECwindows Motif  N         System reboot will be required following upgrade of language variants.D         Installation Verification Procedure can be run after reboot.                                                         A-10 a         I             POLYCENTER Software Installation Utility Sample InstallationslI            A.3 Sample Installation on an OpenVMS Alpha Version 6.2 Systeme    F         A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System  I               Example A-4 contains a sample installation of the mandatory C               ECO for the PCSI software on an OpenVMS Alpha Version A               6.2 operating system. Example A-5 contains a sampleeE               installation of the Compaq DECwindows Motif for OpenVMSnG               software on an OpenVMS Alpha Version 6.2 operating systemD1               with insufficient system resources.e  H         Example A-4 Sample Installation of the Mandatory ECO for PCSI on+                     an OpenVMS Alpha Systemb  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 startingp0         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 netr           Portion Done: 0%         ...10%         ...40%         ...80%         ...90%         ...100% 1         The following product has been installed:-(         DEC AXPVMS VMS62TO71U2_PCSI V1.0                        I                                                                      A-11_ _  _      A     POLYCENTER Software Installation Utility Sample InstallationslB     A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System    E     Example A-5 Sample Installation of an Upgrade of DECwindows MotiftC                 on an OpenVMS Alpha System With Insufficient Systemm                 Resourcesi  &     $ PRODUCT INSTALL DWMOTIF <Return>  ,     The following product has been selected:>         DEC AXPVMS DWMOTIF V1.2-6              Layered Product  +     Do you want to continue? [YES] <Return>d  $     Configuration phase starting ...  N     You will be asked to choose options, if any, for each selected product andI     for any products that may be installed to satisfy software dependencys     requirements.n  /     DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motifs  2         Copyright 2000 Compaq Computer Corporation  #         Compaq Computer Corporation   +         This product uses the PAK: DW-MOTIFm  +     Checking values of system parameters... T     %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 110000, should be at least 150000V     %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1867776, should be at least 1998848  Q       The installation procedure has determined that some system parameter valuesqL       require modification to install the DECwindows Motif Version 1.2-6 for       OpenVMS software.C  M       Please type the following command to run AUTOGEN and reboot your system N       before restarting the DECwindows installation.  This will set the systemK       parameters to appropriate values for running DECwindows Motif V1.2-6.t  =             @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACKo    4     The DECwindows installation is being terminated.  E                                              (continued on next page)x         A-12 s  s      I             POLYCENTER Software Installation Utility Sample InstallationssI            A.3 Sample Installation on an OpenVMS Alpha Version 6.2 Systemo    @         Example A-5 (Cont.) Sample Installation of an Upgrade ofG                             DECwindows Motif on an OpenVMS Alpha Systems>                             With Insufficient System Resources  8         Please run AUTOGEN and restart the installation.  *         %PCSI-E-S_OPFAIL, operation failedU         %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error conditione  =               At this point, run AUTOGEN and then restart then               installation.n      0         The following product has been selected:B             DEC AXPVMS DWMOTIF V1.2-6              Layered Product  /         Do you want to continue? [YES] <Return>t  (         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.c4          DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif  6             Copyright 2000 Compaq Computer Corporation  '             Compaq Computer Corporation   /             This product uses the PAK: DW-MOTIF   /         Checking values of system parameters...e  1                                                OK   @         Do you want the defaults for all options? [YES] <Return>  V             If a Local Language Variant is installed, refer to the Installation Guide.  3             Do you want to continue? [YES] <Return>E  I                                                  (continued on next page)     I                                                                      A-13E X  S      A     POLYCENTER Software Installation Utility Sample Installations B     A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System    <     Example A-5 (Cont.) Sample Installation of an Upgrade ofC                         DECwindows Motif on an OpenVMS Alpha Systemn:                         With Insufficient System Resources  6     Do you want to review the options? [NO] Y <Return>  /     DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motif +         DEC AXPVMS VMS V6.2-1H3 [Installed]m#            Install New Desktop: YESsC           Install Manual (reference) pages for the New Desktop: YESo7           Make the New Desktop the default desktop: YESM3         Install traditional DECwindows Desktop: YESu3         Programming Support for the C Language: YESo8         Programming Support for the Pascal Language: YES9         Programming Support for the FORTRAN Language: YESr4         Programming Support for the New Desktop: YES!         Programming examples: YESV"           Sound example files: YES2           Programming examples for DECwindows: YES7           Programming examples for the New Desktop: YESs  8     Are you satisfied with these options? [YES] <Return>        Execution phase starting ...  ;     The following product will be installed to destination:fC         DEC AXPVMS DWMOTIF V1.2-6              DISK$2:[VMS$COMMON.] ;     The following product will be removed from destination:yC         DEC AXPVMS DWMOTIF V1.2-5              DISK$2:[VMS$COMMON.]          Portion done: 0%
     ...10%
     ...20%
     ...30%
     ...40%
     ...50%
     ...60%
     ...70%
     ...80%
     ...90%  P       **** DECwindows Motif application and run-time support files DETECTED ****  E                                              (continued on next page)n         A-14    w      I             POLYCENTER Software Installation Utility Sample Installations I            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 Systemp>                             With Insufficient System Resources    <           **** DECwindows device support files DETECTED ****           ...100%e  1         The following product has been installed: B             DEC AXPVMS DWMOTIF V1.2-6              Layered Product/         The following product has been removed: B             DEC AXPVMS DWMOTIF V1.2-5              Layered Product5           DEC AXPVMS DWMOTIF V1.2-6: DECwindows Motifr  R             System reboot will be required following upgrade of language variants.  H             Installation Verification Procedure can be run after reboot.                                                      I                                                                      A-15.                         I                                                                         BVI         _________________________________________________________________l  I                                             VMSINSTAL Sample Installation     ?               This appendix contains a sample VMSINSTAL product%               installation.3  F         B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2             System  F               Example B-1 contains a sample installation of the CompaqD               DECwindows Motif for OpenVMS software on a VMS VersionG               5.5-2 operating system using the VMSINSTAL procedure. ThenH               sample installation assumes that no users are logged in toH               the system and that you specified OPTIONS N to display the               release notes.  7         Example B-1 Sample Installation Using VMSINSTAL   /         $ @SYS$UPDATE:VMSINSTAL DWMOTIFVAXU6012   F                 VAX/VMS Software Product Installation Procedure V5.5-2  #         It is 26-MAR-2000 at 10:36.a  7         Enter a question mark (?) at any time for help.C  O         * Are you satisfied with the backup of your system disk [YES]? <Return>f  O         * Where will the distribution volumes be mounted: DAD2:[000000]<Return>S  R         Enter the products to be processed from the first distribution volume set.,         * Products: dwmotifvaxu6012 <Return>  E         * Enter installation options you wish to use (none): <Return>e  1         The following products will be processed:d             DWMOTIFVAXU6 V1.2   I                                                  (continued on next page)   I                                                                       B-1n i  y      !     VMSINSTAL Sample InstallationSI     B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 Systema    ;     Example B-1 (Cont.) Sample Installation Using VMSINSTAL   @             Beginning installation of DWMOTIFVAXU6 V1.2 at 10:36  :     %VMSINSTAL-I-RESTORE, Restoring product save set A ...O     %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   H             *** Installing DECwindows Motif for OpenVMS VAX software ***  0       Copyright 2000 Compaq Computer Corporation  <       COMPAQ Registered in U.S. Patent and Trademark Office.  M       Confidential computer software. Valid license from Compaq or authorizedsL       sublicensor required for possession, use , or copying. Consistent withL       FAR 12.211 and 12.212, Commercial Computer Software, Computer SoftwareI       Documentation, and Technical Data for Commercial Items are licensedeH       to the U.S. Government under vendor's standard commercial license.  H       You can install the DECwindows Motif kit completely or in selectedK       portions.  A complete installation requires as many as 68,400 blocks. E       If you choose to perform a partial installation, you can select I       (tailor) the programming support files that support your DECwindows O       Motif application development.  Whether you perform a complete or partial4J       installation, this kit provides support for running DECwindows Motif.       applications on OpenVMS compute servers.  <     * Do you want to install the entire kit [Y]? No <Return>  G       This installation procedure provides support files for developingTL       DECwindows Motif applications in several programming languages.  TheseO       files are needed only to develop applications and are not required to runrN       DECwindows Motif applications.  The free disk space requirement for each?       programming support file ranges from 3000 to 8000 blocks.   O     * Do you want to install DECwindows Motif programming support [Y]? <Return>   Q       Support files are supplied for the following OpenVMS programming languages:U         FORTRAN, Pascaln  O       In addition, support files are supplied for programming in the C languagelN       using conventions and standards developed at the Massachusetts Institute       of Technology.  Q     * Do you want to install all programming language support files [Y]? <Return>c  P     * Do you want to install DECwindows Motif programming examples [Y]? <Return>  E                                              (continued on next page).       B-2S -  P      I                                             VMSINSTAL Sample InstallationoI     B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System:    ?         Example B-1 (Cont.) Sample Installation Using VMSINSTALt  >           You have selected the following portions of the kit:  G                 o  DECwindows Motif Applications and Run-time Libraries   8                 o  DECwindows Motif programming examples  7                 o  DECwindows Motif programming supporti'                         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 is N           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.e  &                 Product:      DW-MOTIF!                 Producer:     DEC                  Version:                 Release Date:   Y         * Does this product have an authorization key registered and loaded? Yes <Return>m  K           DECwindows Motif will not start if your system parameters are not            correct.  K           o If you allow a system shutdown, the installation procedure willfM             reboot the system at the end of the installation.  If your systemtM             parameters are incorrect, the installation will run AUTOGEN priora!             to the system reboot.d  M           o If you do not allow a system shutdown, the installation procedure E             will continue, and you will be informed at the end of the M             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 rebooteM             the system.  If it is not convenient to reboot at this time, then /             enter NO to the following question.Y  F             If you enter NO, the installation procedure will continue.  ]         * Will you allow a system shutdown after this product is installed [YES]? No <Return>r  I                                                  (continued on next page)-  I                                                                       B-3  l         !     VMSINSTAL Sample InstallationEI     B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 System     ;     Example B-1 (Cont.) Sample Installation Using VMSINSTAL3  )       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 ...:     %VMSINSTAL-I-RESTORE, Restoring product save set E ...:     %VMSINSTAL-I-RESTORE, Restoring product save set F ...:     %VMSINSTAL-I-RESTORE, Restoring product save set G ...:     %VMSINSTAL-I-RESTORE, Restoring product save set H ...:     %VMSINSTAL-I-RESTORE, Restoring product save set I ...:     %VMSINSTAL-I-RESTORE, Restoring product save set J ...:     %VMSINSTAL-I-RESTORE, Restoring product save set L ...R     %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  ?       You may safely ignore the following NCP error message(s):        %NCP-I-SUCCESS,  Success     Object = X$X0 +     %NML-I-RECDELET, Database entry deletedT  K       The Installation Verification Procedure (IVP) should be run after thevN       installation has been completed and DECwindows Motif has been restarted.4       The IVP can be found in SYS$TEST:DECW$IVP.COM.  O       The installation procedure has determined that your system parameters aretN       set correctly and that it will not be necessary to run AUTOGEN or reboot       the system.w  L       If your system is already running DECwindows Motif, restart DECwindows+       Motif with the following DCL command:t  .            $ @SYS$MANAGER:DECW$STARTUP RESTART  N       If your system is NOT already running DECwindows Motif, start DECwindows+       Motif with the following DCL command:n  &            $ @SYS$MANAGER:DECW$STARTUP  3                                 * * * N O T E * * *   O       If you are installing DECwindows Motif from your workstation console, log @       off after you enter the command to start DECwindows Motif.  Q       The installation procedure has determined that your system parameter valuesp>       are acceptable.  A reboot of the system is not required.  E                                              (continued on next page)t       B-4O V  A      I                                             VMSINSTAL Sample InstallationcI     B.1 Sample Installation Using VMSINSTAL on a VMS Version 5.5-2 SystemS    ?         Example B-1 (Cont.) Sample Installation Using VMSINSTALl  D                 Installation of DWMOTIFVAXU6 V1.2 completed at 10:57  Q         Enter the products to be processed from the next distribution volume set.2         * Products: <Return>-             VMSINSTAL procedure done at 12:45                                                                             I                                                                       B-5  K                       I                                                                         C I         _________________________________________________________________   I                                                       Software ComponentsV    H               If you installed Compaq DECwindows Motif for OpenVMS usingC               the POLYCENTER Software Installation utility, you canYF               obtain a list of all installed files and the directoriesE               and subdirectories into which the files were installed.   A               To obtain this list, enter the following POLYCENTER 4               Software Installation utility command:  3               $ PRODUCT SHOW OBJECT/product=dwmotifL  =               Following is a sample output from this command.:  B               OBJECT                                   OBJECT TYPEB               ------                                   -----------@               [000000]                                 directoryH               [000000]DEC-AXPVMS-DWMOTIF-V0102-6-1.PCSI$DESCRIPTION file@               [000000]DEC-AXPVMS-DWMOTIF-V0102-6-1.PCSI$TLB file@               [CDA$LIBRARY]                            directory;               [CDA$LIBRARY]CL_DAY.DOC_STYLE            filet;               [CDA$LIBRARY]DEFSTYLE.DDIF               fileh@               [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 fileNA               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCALC.DAT filesC               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCREATE.DAT file A               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTFILE.DAT fileDB               [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTHELLO.DAT file               .i               .                .     I                                                                       C-1                                  F      _________________________________________________________________  F                                                                  Index      1      A                                 AWD option <      _______________________________     specifying (cont'd);      Account quotas                         variables,  3-4   .        See also Quotas                   usingD        required for installation,           with fewer than required?          1-11                                  free blocks, 3-3t        Alternate working devicenF        See AWD option                  B______________________________  -      Alternative console               Backup:B        See Console                       backing up a system disk,0      ASTLM parameter                        1-20B        required quota for                confirming system backup,/          installation,  1-11                3-8t/      AUTHORIZE utility                 Base kit C        using to change Quotas, 1-11      required disk space,  1-12 6      AUTOGEN utility                   BIOLM parameter;        invoking during installation,     required quota for >          3-19                               installation, 1-11-        preparing for installation,     Blocksl8          1-16                            See Free blocks1        rebooting the system, 1-20      Bookreader D        using to change system            copying customized files toB          parameters,  1-19                  another directory, 1-9F      AWD option                          saving customized files,  1-9.        installing, 3-7                 Booting?        lacking sufficient disk space     DECwindows Motif,  4-1 A          ,  3-15                         standalone systems,  4-3a6        restarting the installation,    BYTLM parameter;          3-15                            required quota forl>        specifying                           installation, 1-11#           another storage disk, 3-3e           command line, 3-4            directory, 3-3  F                                                                Index-1 r                 7                                        DFS-mounted diskVD     C______________________________     determining free disk space,  .     CDE,  4-7                              3-55     Components                          for AWD,  3-5t@       DECwindows X11 display            on the system disk,  3-56          server, fonts, device         DIOLM parameter:          drivers, 1-4                   required quota for=       operating system                     installation, 1-11 1          DECwindows transports and     Disk space 3             base-system support,        determiningm8             1-4                            amount,  1-12A     Console                                number of free blocks, 2       alternative,  4-7                       1-12D       main,  4-7                        on the DFS-mounted AWD,  3-50     Customize                           required>       system after installation,           by component,  1-128          5-1                            verifying,  3-14  E     Customizing                        Distributed File Service (DFS)   <       Bookreader files                  See DFS-mounted disk9          saving,  1-9                  Distribution media96                                         mounting,  3-9  #     D______________________________ F     DECW$MOTIF_TAILOR utility          E______________________________  6       overview,  5-8                   ENQLM parameter:       removing files from a system      required quota for=          disk, 5-11                        installation, 1-11 ;     DECW$TAILOR utility                Error recovery, 3-22 7       adding base support files to     Example programsSB          a system disk, 5-16            required disk space,  1-12         overview,  5-15 F       using,  5-15                     F______________________________  9     DECwindows X11 Display server      Facility name, 3-5 ,       customizing startup,  5-1        Files@     Desktop                             adding DECwindows files,/       selecting,  2-10, 4-7                5-14L6     Device name                        FILLM parameter:       AWD                               required quota for=          ddcu,  3-7                        installation, 1-11a2       source drive                     Free blocksA          ddcu,  3-7                     determining amount,  1-12 8       specifying for installation,     Free global pages:          3-5                            calculating,  1-17  7                                         required,  1-18_       Index-2_ _  _              -         Free global sections              Kit <          calculating,  1-17                 installing, 3-12G          required,  1-18                    loading distribution media, 1                                               3-6tH         G______________________________     preserving OSF/Motif Release:         Global pages                          1.1.3,  3-11  +          See Free global pages            LsI         Global sections                   _______________________________S3          See Free global sections         Languagest<                                             installing, 3-13;         H                                 Language variants <         _______________________________     installing, 2-13D         Hardware                          License registration,  1-2H          supported by DECwindows Motif      sample PAK registration, B-1;             ,  1-3                          verifying, 3-16 5                                           Logging outrA         I______________________________     notifying users, 1-21f  +         Installation name                 MeI          See Facility name                _______________________________o7         Installation procedure            Magnetic tape G          completing,  3-21                  installation procedure, 3-7s<         Installation requirements,        Main console,  4-7C           1-10, 3-2                       Memory requirements,  1-4 1         Installation Verification         Monitor 8           Procedure                         100 dpi, 5-2G          See IVP                          Monochrome workstations,  5-3s  I         Insufficient quotas               N______________________________2  H          See Error recovery               NET-APP-SUP-250 license,  3-16H         IVP                               NET-APP-SUP-300 license,  3-165          notification during product      New Desktop @             installation,  3-19             selecting, 2-10, 4-7H          running                          North American keyboard layout2             after starting the product       , 5-2                ,  4-5 +             procedure,  3-19              OaI                                           _______________________________aH         K______________________________   Operating system prerequisitesI         Keyboard                            using the POLYCENTER SoftwarewH          customizing layout,  5-3             Installation utility,  1-3?          model number,  5-3               Operator window,  4-7o           Keymap names          determining,  5-5          list,  5-5M  I                                                                   Index-3r i                 7                                        PostinstallationsA     P______________________________     determining and reportingf  9     Page file size                         problems, 5-20e-       setting,  1-18                    tasksaA     PAK registration,  B-1                 customizing DECwindowsE8       See also License registration           Motif, 5-1B     Parameters                         Postinstallation tasks, 4-1E       See System parameters             choosing an alternate consolep0     PCSI installation                      , 4-7=       checking                          running the IVP,  4-5oE          programming environment,       starting DECwindows software,t.             2-9                            4-1<       displaying                       Prerequisite softwareE          language variants,  2-13       using the POLYCENTER SoftwaremD       installing                           Installation utility, 1-31          TIS support,  2-13            Privileges B       verifying                         required for installation,.          applications and run-time         3-3  @             support files, 2-15        Product Authorization Key  <          device support files,          See PAK registration3             2-15, 2-16                 Product nameyD          system parameters,  2-6        specifying for installation,.     POLYCENTER Software                    3-52        Installation utility            Programming3       accessing DCL help,  2-2          environmentAC       backing up the system disk,          disk space requirements,n2          2-2                                  1-12B       confirming your responses to         installing,  3-12, 3-13D          questions, 2-5                    installing support files,2       displaying                              3-12B          messages when the                 preserving,  3-11, 3-127             installation fails,            saving,  2-9 0             2-18                        examples<       extracting the release notes,        installing,  3-13/          2-3                            support ?       prerequisites for                    compatibility in theT?          installation, 1-3                    XUI and OSF/MotifS?       responding to questions                 environments, 1-8hC          during installation, 2-4          OSF/Motif Release 1.1.3,m1       running the installation                1-8             command procedure, 2-5 "       selecting the desktop,  2-10       Index-4a                   A                                           SYSGEN utility (cont'd)<G         Q______________________________     preparing for installation,m  2         Quotas, 3-5                           1-160          minimum required for             System4             installation,  1-10             shutdownD          verifying and changing,  1-11         notifying users, 1-217                                             tuning, 5-1 >         R______________________________   SYSTEM account,  3-65         Rebooting the system, 3-16        System disk B         Release notes                       adding DECwindows baseB          accessing,  3-9, 3-22                support files,  5-14@             POLYCENTER Software             backing up, 2-2, 3-87                Installation utility,        customizingbI                2-3                             DECW$MOTIF_TAILOR utility,m5             VMSINSTAL procedure,  3-7            5-11nH          displaying,  3-9, 3-10, 3-22          DECW$TAILOR utility, 5-167          extracting to a file               determiningiE             POLYCENTER Software                number of free blocks, 5                Installation utility,             1-12 C                2-3, 2-4                     free space required for G          options,  3-9                        installation,  1-12, 3-14l  C          printing,  3-9, 3-10, 3-22       System Generation utility-  >          specifying OPTIONS N,  3-7         See SYSGEN utility;                                           System parametersr2         S                                   addingC         _______________________________        new parameters, 1-19n4         Selecting a desktop, 4-7            changingC         Server startup                         by using the AUTOGENr?          customizing,  5-1                       utility,  1-19 ;         Shutting down the system               values, 1-19a4          notifying users,  1-21             checking;         Software                               values, 1-17cB          required operating system          minimum required, 1-145             version,  1-3                   modifying G         Starting DECwindows Motif, 4-1         incremental adjustments,o5          on boot nodes,  4-3                     1-19S?          on nonsatellites,  4-3             recalculating, 1-20eB          on OpenVMS Cluster systems,        reset by AUTOGEN, 3-20F             4-3                             setting WINDOW_SYSTEM, 4-1          on satellites,  4-4$          on standalone systems,  4-3         SYSGEN utility"          checking system parameter             values,  1-17t  I                                                                   Index-5N    o              C                                        VMSINSTAL procedure (cont'd) B     T______________________________     starting the installation,  3     TIS support                            3-6, 3-7 B       installing,  2-13                 stopping the installation,.     Translated-image support               3-5B       required disk space,  1-12        using the AWD option,  3-7     Tuning the system,  5-1   F                                        W______________________________E     V______________________________    WINDOW_SYSTEM system parameter   5     VMSINSTAL procedure                 setting,  4-1 8       backing up the system disk,      Workstations, 5-3          3-2        changing selections,  3-14"       copying the release notes to          SYS$HELP, 3-10a       displaying release notes, 
          3-10        entering directory          specifications, 3-9!       entering product name,  3-9        installing          entire kit,  3-12          programming examples,             3-13"       listing directories and save          sets, 3-17V        locating the VMSINSTAL.COM          file, 3-6#       mounting distribution volumess          , 3-9        preserving the programming           environment, 3-11, 3-12!       rebooting the system,  3-16         registering and installing"          the Product Authorization          Key (PAK), 3-1         reselecting options,  3-15       running the Installation          Verification Procedure           (IVP), 3-19#       specifying incorrect name for_          the source drive, 3-8#       specifying product name,  3-7        Index-6 