 












                    hp DECwindows Motif
                    for_hp_OpenVMS_Alpha________________________________
                    Installation Guide


                    Order Number: AA-RT26A-TE


                    February 2003

                    This manual provides step-by-step instructions for
                    installing HP DECwindows Motif for HP OpenVMS Alpha
                    Version 1.3.







                    Revision/Update Information:  This manual supersedes
                                                  the DECwindows Motif
                                                  Version 1.2-6 for
                                                  OpenVMS Installation
                                                  Guide.

                    Operating System:             HP OpenVMS Alpha
                                                  Version 7.3-1

                    Software Version:             HP DECwindows Motif
                                                  for HP OpenVMS Alpha
                                                  Version 1.3




                    Hewlett-Packard Company
                    Palo Alto, California

 






          ________________________________________________________________

           2003 Hewlett-Packard Development Company, L.P.

          Motif, OSF/1, UNIX, and the "X" device are registered
          trademarks and The Open Group is a trademark of The Open
          Group in the U.S. and other countries.

          Confidential computer software. Valid license from HP
          and/or its subsidiaries required for possession, use, or
          copying. Consistent with FAR 12.211 and 12.212, Commercial
          Computer Software, Computer Software Documentation, and
          Technical Data for Commercial Items are licensed to the
          U.S. Government under vendor's standard commercial license.

          Neither HP nor any of its subsidiaries shall be liable
          for technical or editorial errors or omissions contained
          herein. The information in this document is provided
          "as is" without warranty of any kind and is subject to
          change without notice. The warranties for HP products
          are set forth in the express limited warranty statements
          accompanying such products. Nothing herein should be
          construed as constituting an additional warranty.

                                                               ZK6434

          The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3
          documentation set is available on CD-ROM.

 














  _________________________________________________________________

                                                           Contents



  Preface...................................................    vii

  1  Preparing to Install the Software

        1.1   License Registration..........................    1-2
        1.2   Supported Hardware............................    1-2
        1.3   Prerequisites for the Installation
              Procedures....................................    1-3
        1.4   Required Operating System Software............    1-3
        1.5   OSF/Motif Release 1.1.3 and XUI Programming
              Support.......................................    1-5
        1.6   Saving Customized Bookreader Files............    1-6
        1.7   Installation Procedure Requirements...........    1-7
        1.7.1     Process Account Quotas....................    1-8
        1.7.2     Disk Space................................    1-9
        1.7.3     System Parameters.........................   1-11
        1.7.4     Additional System Maintenance
                  Procedures................................   1-13
        1.7.4.1     Checking System Parameter Values........   1-13
        1.7.4.2     Calculating the Number of Free Global
                    Pages and Global Sections...............   1-14
        1.7.4.3     Setting the Size of the Page File.......   1-15
        1.7.4.4     Changing System Parameter Values Using
                    the AUTOGEN Utility.....................   1-16
        1.7.5     Backing Up Your System Disk...............   1-18
        1.7.6     Notifying Other Users.....................   1-18








                                                                iii

 







    2  Using the POLYCENTER Software Installation Utility

          2.1   Accessing Help Information....................    2-2
          2.2   Extracting and Printing the Product Release
                Notes.........................................    2-3
          2.3   Installing the DECwindows Motif Software......    2-5
          2.3.1     Starting the Installation.................    2-5
          2.3.2     The Installation Dialog...................    2-6
          2.3.2.1     Verifying Sufficient Allocation for the
                      GBLPAGES and CLISYMTBL Values...........    2-7
          2.3.2.2     Running AUTOGEN.........................    2-8
          2.3.2.3     Saving the Programming Environment......    2-9
          2.3.2.4     Default Installation....................    2-9
          2.3.2.5     Installation of Server Software.........   2-10
          2.3.2.6     Euro Currency Sign Support..............   2-10
          2.3.2.7     LBX Proxy Installation..................   2-11
          2.3.2.8     Selecting Installation of Client
                      Software................................   2-11
          2.3.2.9     Asking About Selecting a Desktop........   2-11
          2.3.2.10    Programming Language Support Options....   2-13
          2.3.2.11    Translated Image Support................   2-14
          2.3.2.12    Language Variants Notice................   2-14
          2.3.2.13    Reviewing the Installation Options......   2-14
          2.3.2.14    Execution Dialog........................   2-15
          2.3.2.15    Verifying DECwindows Motif Support
                      Files...................................   2-16
          2.3.2.16    Reviewing Final Installation Notes......   2-17
          2.4   Recovering from Errors........................   2-18
          2.5   Adjusting Parameters After Installation.......   2-18

    3  After Installing the Software

          3.1   Starting the DECwindows Motif Software........    3-1
          3.2   Running the IVP...............................    3-2
          3.3   Choosing an Alternate Console.................    3-4
          3.4   Selecting the Desktop.........................    3-5









    iv

 







        4  Managing DECwindows Motif Software

              4.1   Customizing the DECwindows X11 Display Server
                    Startup Procedure.............................    4-2
              4.2   Determining and Reporting Problems............    4-3

        A  POLYCENTER Software Installation Utility Sample
           Installation

              A.1   Sample Installation on an OpenVMS Alpha
                    Version 7.3-1 System..........................    A-2

        B  Software Components

        Index


        Examples

              3-1       Sample IVP................................    3-3

              A-1       Sample Installation of an Upgrade of the
                        DECwindows Motif Software on an OpenVMS
                        Alpha Version 7.3-1 System With Sufficient
                        System Resources..........................    A-2

        Tables

              1-1       DECwindows Motif Support Options for
                        OpenVMS...................................    1-4

              1-2       Directories for Previous XUI or OSF/Motif
                        Programming Environments..................    1-5

              1-3       Process Quotas for the Installation
                        Account...................................    1-8

              1-4       Required Disk Space by Component (in
                        Blocks)...................................   1-10

              1-5       Minimum Required System Parameter
                        Values....................................   1-11

              1-6       Required Number of Contiguous Free Global
                        Pages and Free Global Sections............   1-15

              1-7       Recommended System Parameter Values to Use
                        with the ADD_ Option......................   1-17

                                                                        v

 












        _________________________________________________________________

                                                                  Preface



        Intended Audience

              This manual is intended for anyone who plans to install
              the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3
              software.

        Document Structure

              This manual contains the following chapters and appendixes:

              o  Chapter 1 discusses how to prepare for installing
                 DECwindows Motif software.

              o  Chapter 2 discusses how to install DECwindows Motif
                 using the POLYCENTER Software Installation utility.

              o  Chapter 3 provides startup procedures. This chapter also
                 includes a sample Installation Verification Procedure
                 (IVP).

              o  Chapter 4 discusses customizing the environment, and
                 reporting errors.

              o  Appendix A presents a sample DECwindows Motif
                 installation using the POLYCENTER Software Installation
                 utility on an OpenVMS Alpha Version 7.3-1 system.

              o  Appendix B shows how to obtain a list of the software
                 components for the DECwindows Motif product using the
                 POLYCENTER Software Installation utility.




                                                                      vii

 







    Related Documents

          In addition to this manual, the following documents are
          useful when installing the DECwindows Motif software:

          o  HP DECwindows Motif for HP OpenVMS Alpha New Features

          o  HP DECwindows Motif for HP OpenVMS Alpha Release Notes

          o  Guide to the HP DECwindows Motif for HP OpenVMS Alpha
             CD-ROM

          o  Getting Started With the New Desktop

          o  Managing DECwindows Motif for OpenVMS Systems

          o  OpenVMS System Manager's Manual

          o  OpenVMS System Management Utilities Reference Manual

          For additional information about OpenVMS or DECwindows
          Motif products and services, visit the following web site:

          http://www.openvms.compaq.com

    Reader's Comments

          HP welcomes your comments on this manual. Please send
          comments to either of the following addresses:

          Internet    openvmsdoc@hp.com

          Mail        Hewlett-Packard Company
                      OSSG Documentation Group, ZKO3-4/U08
                      110 Spit Brook Rd.
                      Nashua, NH 03062-2698

    How To Order Additional Documentation

          For information about how to order additional
          documentation, visit the following World Wide Web address:

          http://www.openvms.compaq.com/doc/


    viii

 







        Conventions

              DECwindows Motif contains a graphical user interface that
              is derived from the Common Desktop Environment (CDE). This
              interface is referred to throughout this document as the
              New Desktop.

              Unless otherwise specified, references to OpenVMS Clusters,
              VMSclusters, or clusters in this document are synonymous
              with HP OpenVMS Clusters.

              All uses of DECwindows and DECwindows Motif refer to the
              HP DECwindows Motif for HP OpenVMS Alpha software; and
              all uses of X server and X display server refer to the HP
              DECwindows X11 Display Server. Additionally, all uses of
              DECwindows XUI (X User Interface) refer to the DECwindows
              product prior to DECwindows Motif Version 1.0.




























                                                                       ix

 







          The following conventions are also used in this manual:

          Ctrl/x           A sequence such as Ctrl/x indicates that
                           you must hold down the key labeled Ctrl
                           while you press another key or a pointing
                           device button.

          <Return>         In examples, a key name enclosed in a
                           box indicates that you press a key on
                           the keyboard. (In text, a key name is not
                           enclosed in a box.)

                           In the HTML version of this document, this
                           convention appears as brackets, rather
                           than a box.

           . . .           Horizontal ellipsis points in
                           examples indicate one of the following
                           possibilities:

                           o  Additional optional arguments in a
                              statement have been omitted.

                           o  The preceding item or items can be
                              repeated one or more times.

                           o  Additional parameters, values, or other
                              information can be entered.

          .                Vertical ellipsis points indicate the
          .                omission of items from a code example
          .                or command format; the items are omitted
                           because they are not important to the
                           topic being discussed.

          ( )              In command format descriptions,
                           parentheses indicate that you must enclose
                           the choices in parentheses if you choose
                           more than one.






    x

 








              [ ]              In command format descriptions, brackets
                               indicate optional elements. You can
                               choose one, none, or all of the options.
                               (Brackets are not optional, however, in
                               the syntax of a directory name in an
                               OpenVMS file specification or in the
                               syntax of a substring specification in
                               an assignment statement.)

              |                In command format descriptions, vertical
                               bars separating items inside brackets
                               indicate that you choose one, none, or
                               more than one of the options.

              { }              In command format descriptions, braces
                               surround a required choice of options; you
                               must choose one of the options listed.

              text style       This text style represents the
                               introduction of a new term or the name
                               of an argument, an attribute, or a reason.

                               In the HTML version of this document, this
                               convention appears as italic text.

              italic text      Italic text indicates important
                               information, complete titles of
                               manuals, or variables. Variables include
                               information that varies in system messages
                               (Internal error number), in command
                               lines (/PRODUCER=name), and in command
                               parameters in text (where dd represents
                               the predefined code for the device type).

              UPPERCASE TEXT   Uppercase text indicates a command, the
                               name of a routine, the name of a file, or
                               the abbreviation for a system privilege.







                                                                       xi

 








          Monospace type   Monospace type indicates code examples and
                           interactive screen displays.

                           In the C programming language, monospace
                           type in text identifies the following
                           elements: keywords, the names of
                           independently compiled external functions
                           and files, syntax summaries, and
                           references to variables or identifiers
                           introduced in an example.

          -                A hyphen at the end of a command format
                           description, command line, or code line
                           indicates that the command or statement
                           continues on the following line.

          numbers          All numbers in text are assumed to be
                           decimal unless otherwise noted. Nondecimal
                           radixes-binary, octal, or hexadecimal-are
                           explicitly indicated.
























    xii

 










                                                                        1
        _________________________________________________________________

                                        Preparing to Install the Software


              This chapter describes the preparation and requirements for
              installing HP DECwindows Motif for HP OpenVMS Alpha Version
              1.3 software using the POLYCENTER Software Installation
              utility.

                ________________________ Note ________________________

                HP strongly recommends that you read the release
                notes before proceeding with the installation. The
                DECwindows Motif product provides online release
                notes. See Section 2.2 for instructions on how to
                access this information.

                ______________________________________________________

              This chapter presents information about the following
              topics:

              o  Section 1.1, License Registration

              o  Section 1.2, Supported Hardware

              o  Section 1.3, Prerequisites for the Installation
                 Procedures

              o  Section 1.4, Required Operating System Software

              o  Section 1.5, OSF/Motif Release 1.1.3 and XUI Programming
                 Support

              o  Section 1.6, Saving Customized Bookreader Files

              o  Section 1.7, Installation Procedure Requirements



                                                                      1-1

 



    Preparing to Install the Software
    1.1 License Registration


    1.1 License Registration

          Before you install and run DECwindows Motif software on
          a newly licensed node or cluster, you must first register
          a License Product Authorization Key (License PAK) using
          the License Management Facility (LMF). The License PAK is
          provided along with the kit if you ordered the license and
          media together; otherwise, it is provided separately to a
          location based on your license order.

          If you are installing DECwindows Motif software as an
          update on a node or cluster already licensed for this
          software, you have already completed the License PAK
          registration requirements.

          You must register and load your license for DECwindows
          Motif before you run the Installation Verification
          Procedure (IVP) and use the software.

          To register a license, log in to the system manager account
          (SYSTEM). Then choose one of the following options to
          register the license:

          o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When the
             procedure prompts you for information, respond with data
             from your License PAK.

          o  At the DCL prompt, enter the LICENSE REGISTER command
             with the appropriate qualifiers that correspond to
             License PAK information.

          If you plan to use DECwindows Motif software on more than
          one node in a VMScluster, load the license on the other
          nodes after you complete this installation.

          For complete information about using LMF, see the OpenVMS
          License Management Utility Manual.

    1.2 Supported Hardware

          HP DECwindows Motif for HP OpenVMS Alpha Version 1.3
          software can be installed on any supported Alpha processor.
          For a complete list of supported hardware, see the OpenVMS
          Alpha Version 7.3-1 and HP DECwindows Motif for HP OpenVMS
          Alpha Version 1.3 Software Product Descriptions (SPDs).

    1-2

 



                                        Preparing to Install the Software
                        1.3 Prerequisites for the Installation Procedures


        1.3 Prerequisites for the Installation Procedures

              Before you can install and configure DECwindows Motif
              software, you must have the required version of the
              OpenVMS operating system software, sufficient memory, and
              a license. (Refer to Section 1.1 for information about
              registering a License Product Authorization Key [PAK].)

              Use the POLYCENTER Software Installation utility to install
              your DECwindows Motif software according to the following
              operating system information.

        1.4 Required Operating System Software

              The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3
              software requires that the OpenVMS Alpha Version 7.3-1
              operating system be installed with the DECwindows support
              options described in Table 1-1.

              If your system is not running a supported version of
              OpenVMS before you attempt to install DECwindows Motif,
              the installation fails.

              A minimum of 64 MB of memory is required; at least 128 MB
              of memory is highly recommended.

              The OpenVMS operating system provides two subsets of
              components to support DECwindows Motif. To use DECwindows
              Motif software, your system must be running a version of
              the OpenVMS system that includes the following components,
              as described in Table 1-1.














                                                                      1-3

 



    Preparing to Install the Software
    1.4 Required Operating System Software


          Table_1-1_DECwindows_Motif_Support_Options_for_OpenVMS_____

          Option____________Description______________________________

          DECwindows        This component is required to install
          Motif network     DECwindows Motif and to run DECwindows
          transport and     Motif applications. During the
          base system       installation of OpenVMS, you are prompted
          support           to specify whether you want to install
                            this option.

                            To determine whether this option was
                            installed during the installation of
                            OpenVMS, check for the existence of the
                            following file:

                            SYS$LIBRARY:DECW$TRANSPORT_COMMON.EXE

          DECwindows X11    This component is necessary to display
          Display Server,   DECwindows Motif applications or any
          fonts, and        other X Window applications on your
          device drivers    system. During the installation of
                            OpenVMS, you are prompted to specify
                            whether you want to install this option.

                            To determine whether this option was
                            installed during the installation of
                            OpenVMS, check for the existence of the
                            following file:

                            SYS$SYSTEM:DECW$SERVER_MAIN.EXE

                            If the DECW$SERVER_MAIN.EXE file is
                            not on your system, you cannot display
                            DECwindows Motif or other X Window
                            applications on your local system[1]. The
                            DECwindows Motif installation procedure
                            asks whether you want to continue the
                            installation without workstation support.
          [1]If_this_component_is_not_installed_locally,_note_that___

          you can run DECwindows Motif applications and redirect
          their display to a remote system that does have the
          DECwindows X11 Display Server installed.
          ___________________________________________________________

             ________________________ Note ________________________

             See the release notes and cover letter for the version
             of the OpenVMS operating system that you are running

    1-4

 



                                        Preparing to Install the Software
                                   1.4 Required Operating System Software


                for more information about the DECwindows X11 Display
                Server.

                ______________________________________________________

        1.5 OSF/Motif Release 1.1.3 and XUI Programming Support

              The X Window System and OSF/Motif libraries that are
              provided with DECwindows Motif software are incompatible
              with those libraries provided with versions of DECwindows
              Motif prior to Version 1.2. Run-time compatibility is
              preserved, but the earlier OSF/Motif Release 1.1.3 and
              XUI programming environments are not compatible with the
              later OSF/MOTIF Release 1.2 programming environment.

              Programming in the XUI and OSF/Motif Release 1.1.3
              environments that were provided in previous versions of
              DECwindows Motif is no longer supported in the DECwindows
              Motif product. However, the installation procedure gives
              you the option of saving the XUI and OSF/Motif Release
              1.1.3 programming files that already exist on your system.
              If you choose to save these programming files, they are
              moved to subdirectories where you can access them for
              programming. Specifically, the installation creates a
              subdirectory called [.DECW$113] in each of the directories
              listed in Table 1-2 and moves the previous files into the
              new [.DECW$113] subdirectory.

        Table 1-2 Directories for Previous XUI or OSF/Motif Programming
        __________Environments___________________________________________

        Directory_____Contents____New_Location___________________________

        DECW$INCLUDE  C header    SYS$SYSROOT:[DECW$INCLUDE.DECW$113]
                      files

        SYS$SYSTEM    UIL         SYS$SYSROOT:[SYSEXE.DECW$113]
                      compiler

        SYS$LIBRARY   Non-C       SYS$SYSROOT:[SYSLIB.DECW$113]
                      language
        ______________bindings___________________________________________



                                                                      1-5

 



    Preparing to Install the Software
    1.5 OSF/Motif Release 1.1.3 and XUI Programming Support


             ________________________ Note ________________________

             The process for using the saved programming
             environment is documented in the programmer chapter of
             the release notes.

             ______________________________________________________

    1.6 Saving Customized Bookreader Files

          The installation procedure replaces the following file with
          a new version:

          SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF

          If you customized this file and want to save it, copy the
          file to another directory or rename the file prior to the
          installation of DECwindows Motif software so that it is not
          deleted.

          To copy your customized file to another directory, create
          the directory and define a global symbol in the file
          DECW$PRIVATE_APPS_SETUP.COM.

          To create a Bookreader directory called
          SYS$COMMON:[DECW$BOOK_LOCAL], perform the following steps:

          1. Create the directory and assign world read access as
             follows:

             $ CREATE/DIRECTORY/PROTECTION=WORLD:R -
             _$ SYS$COMMON:[DECW$BOOK_LOCAL]

          2. Copy the LIBRARY.DECW$BOOKSHELF file to the new
             directory as follows:

             $ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF -
             _$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG







    1-6

 



                                        Preparing to Install the Software
                                   1.6 Saving Customized Bookreader Files


              3. If the SYS$MANAGER directory does not contain the
                 DECW$PRIVATE_APPS_SETUP.COM command file, copy the
                 template file to a command file as follows:

                 $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE -
                 _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG

              4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and define
                 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]"

              5. Restart DECwindows Motif using the following command if
                 you performed step 4 after installing the product and
                 after DECwindows had been started (for example, after a
                 reboot):

                 $ @SYS$MANAGER:DECW$STARTUP RESTART

              For more information about customizing your DECwindows
              Motif environment, see Managing DECwindows Motif for
              OpenVMS Systems.

        1.7 Installation Procedure Requirements

              This section discusses the requirements for installing the
              DECwindows Motif software using PCSI.

              The installation procedure checks the following:

              o  Whether any other users are logged in to the system

              o  Whether you have the minimum required system account
                 quotas and limits

              o  Whether you have the minimum required disk space

              o  Whether you have the minimum required system parameter
                 values





                                                                      1-7

 



    Preparing to Install the Software
    1.7 Installation Procedure Requirements


    1.7.1 Process Account Quotas

          The installation procedure requires that the installation
          account has the minimum quotas shown in Table 1-3.

          Table_1-3_Process_Quotas_for_the_Installation_Account______

          Quota_Name__Value__________________________________________

          ASTLM          250

          BIOLM          150

          BYTLM        64,000

          DIOLM          150

          ENQLM         2,000

          FILLM__________100_________________________________________

          Use the OpenVMS AUTHORIZE utility to verify and to change
          process quotas for the installation account in the user
          authorization file (UAF). (Some sites may restrict the use
          of the AUTHORIZE utility to certain accounts or users.)
          For example, to change the BYTLM quota for the account-name
          installation account, enter the following commands:

          $ SET DEFAULT SYS$SYSTEM
          $ RUN AUTHORIZE
          UAF> SHOW account-name
          UAF> MODIFY account-name /BYTLM = 64000
          UAF> SHOW account-name
          UAF> EXIT
          $ LOGOUT

          After you change the quotas for the installation account,
          log out of the installation account and log in again for
          the new quotas to take effect. You can then proceed with
          the installation.

          User account quotas are stored in the file
          SYS$SYSTEM:SYSUAF.DAT. For more information about modifying
          account quotas, see the description of the AUTHORIZE
          utility in the OpenVMS System Management Utilities
          Reference Manual.

    1-8

 



                                        Preparing to Install the Software
                                  1.7 Installation Procedure Requirements


        1.7.2 Disk Space

              Use Table 1-4 to determine the amount of free disk space
              that is required on the system disk to install DECwindows
              Motif components. However, because you can choose not
              to install all the components, your actual disk space
              requirement may be less.

              To determine the number of free blocks on the system disk,
              enter the following command at the DCL prompt:

              $ SHOW DEVICE SYS$SYSDEVICE

              The installation procedure checks for free disk space on
              the system disk. If sufficient space is not available, the
              installation procedure provides the following options:

              o  Install fewer optional files.

              o  Terminate the installation, create more free disk space
                 on the system disk, and restart the installation.

              o  Continue the installation and risk running out of disk
                 space.

                ________________________ Note ________________________

                If you run out of free disk space during the
                installation, the installation procedure fails.

                ______________________________________________________














                                                                      1-9

 



    Preparing to Install the Software
    1.7 Installation Procedure Requirements


          Table_1-4_Required_Disk_Space_by_Component_(in_Blocks)_____

          Component/Subcomponent___Requirement_Subtotals___Totals____

          Installation overhead:    40,000[1]   40,000      40,000

          Server software:

              Server base kit        4,120       4,120

              Euro currency         19,880      19,880
              support

              Server total                                  24,000

          LBX support:                950         950         950

          Client software:

              Client base kit       58,450      58,450

              Desktop support

                  New Desktop       42,340

                  DECwindows         7,860
                  desktop

                  Manual pages       2,810
                  for
                  New Desktop

                  Desktop                       53,010
                  subtotal

              Programming
              environment

                  C, C++             7,870

                  FORTRAN            2,060

                  Pascal             3,020

                  New Desktop         150

                  Programming                   13,100
                  subtotal
          [1]Includes_excess_disk_space_allocation_(dependent_on_____

          disk cluster size), PCSI overhead, and log files. The value
          shown is for the combined installation of the server, LBX,
          and client software.

                                             (continued on next page)

    1-10

 



                                        Preparing to Install the Software
                                  1.7 Installation Procedure Requirements


              Table 1-4 (Cont.) Required Disk Space by Component (in
              __________________Blocks)__________________________________

              Component/Subcomponent___Requirement_Subtotals___Totals____

                  Example programs

                      Sound examples     1,560

                      Programming       10,220
                      examples

                      New Desktop        1,250
                      examples

                      Examples                      13,030
                      subtotal

                  Translated image      28,330      28,330
                  support

                  Client total                                 165,920

              Total for all                                    230,870
              components:________________________________________________

        1.7.3 System Parameters

              Table 1-5 lists the minimum required system parameter
              values for the installation. Depending on the kinds of
              programs and applications running at your site, you might
              need higher values for some settings.

              Table_1-5_Minimum_Required_System_Parameter_Values_________

              System
              Parameter________Value_____________________________________

              GBLSECTIONS          600[1]

              [1]If_you_have_installed_other_software_that_uses_global___

              pages or global sections, you might need a higher minimum
              value. When you boot your system and DECwindows Motif
              starts, the values of free GBLPAGES and GBLSECTIONS are
              checked for your system. If you do not have sufficient
              values for GBLPAGES and GBLSECTIONS, the DECwindows
              Motif startup procedure prints a warning and provides a
              recommended value for these parameters.

                                                 (continued on next page)

                                                                     1-11

 



    Preparing to Install the Software
    1.7 Installation Procedure Requirements


          Table_1-5_(Cont.)_Minimum_Required_System_Parameter_Values_

          System
          Parameter________Value_____________________________________

          GBLPAGES          150,000[1]

          GBLPAGFIL           1,024

          SWPOUTPGCNT          512

          MAXBUF              8,192

          VIRTUALPAGECNT       -

          CHANNELCNT           255

          PROCSECTCNT           64

          PQL_DPGFLQUOTA       -

          PQL_MPGFLQUOTA     32,768

          PQL_MASTLM           100

          PQL_MBIOLM           100

          PQL_MBYTLM        100,000

          PQL_MDIOLM           100

          PQL_MENQLM           300

          PQL_MFILLM           100

          PQL_MPRCLM            10

          PQL_MWSDEFAULT      1,024

          PQL_MWSQUOTA        2,048

          PQL_MWSEXTENT       8,192

          CLISYMTBL            512

          GH_RES_CODE         1,024

          GH_RES_DATA          512

          [1]If_you_have_installed_other_software_that_uses_global___

          pages or global sections, you might need a higher minimum
          value. When you boot your system and DECwindows Motif
          starts, the values of free GBLPAGES and GBLSECTIONS are
          checked for your system. If you do not have sufficient
          values for GBLPAGES and GBLSECTIONS, the DECwindows
          Motif startup procedure prints a warning and provides a
          recommended value for these parameters.

                                             (continued on next page)

    1-12

 



                                        Preparing to Install the Software
                                  1.7 Installation Procedure Requirements


              Table_1-5_(Cont.)_Minimum_Required_System_Parameter_Values_

              System
              Parameter________Value_____________________________________

              IMGREG_PAGES        2,000

              WINDOW_SYSTEM          1

              NPAGEDYN         1,998,848

              PAGEDYN           600,000

              WSMAX______________12,000__________________________________

                _______________________ Caution _______________________

                If you do not ensure that your system has the
                necessary number of global pages and global sections
                for the installation, the DCL tables can become
                corrupted.

                ______________________________________________________

        1.7.4 Additional System Maintenance Procedures

              This section explains how to use the System Generation
              utility (SYSGEN) and the AUTOGEN utility to prepare your
              system for the DECwindows Motif installation. The AUTOGEN
              utility uses system configuration data to automatically set
              system parameters.

                ________________________ Note ________________________

                The DECwindows Motif installation and startup
                procedures automatically check for required system
                parameter values and pass the appropriate values to
                AUTOGEN. Therefore, in most cases you do not have to
                check and modify these values manually.

                ______________________________________________________

        1.7.4.1 Checking System Parameter Values

              To check the values of your system parameters, invoke the
              SYSGEN utility by entering the following command at the DCL
              prompt:

              $ RUN SYS$SYSTEM:SYSGEN
              SYSGEN>

                                                                     1-13

 



    Preparing to Install the Software
    1.7 Installation Procedure Requirements


          At the SYSGEN prompt, enter the SHOW command to display the
          value of a system parameter. The following command displays
          the value for the MAXBUF system parameter:

          SYSGEN> SHOW MAXBUF

          After checking the parameters with the SHOW command, enter
          the EXIT command at the SYSGEN prompt to return to DCL
          level.

          If the current values are less than the values in
          Table 1-5, increase the system parameter settings.
          Section 1.7.4.4 describes the procedures for using the
          AUTOGEN utility to increase these values.

    1.7.4.2 Calculating the Number of Free Global Pages and Global
            Sections

          If your system parameter values are equal to or greater
          than the minimum values specified in Table 1-5, you can
          continue with the product installation. However, to install
          and run DECwindows Motif software, you must have sufficient
          free global pages and global sections for the DECwindows
          Motif software and the file SYS$LIBRARY:DCLTABLES.EXE.

          First, determine how many free global pages and global
          sections exist on your system and how many are required
          to reinstall a new version of SYS$LIBRARY:DCLTABLES.EXE.
          Then, if necessary, use the AUTOGEN utility to increase the
          values of the GBLPAGES and GBLSECTIONS system parameters.

          Enter the following DCL command to determine the number of
          global pages required for SYS$LIBRARY:DCLTABLES.EXE:

          $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE

          This command returns the size (in blocks) of the file
          SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this
          figure as the number of global pages needed for the file.

          Enter the WRITE command with the F$GETSYI lexical function
          to find the number of contiguous free global pages and the
          number of free global sections. The following example shows
          how to obtain this information at your terminal, which is
          the default for SYS$OUTPUT:

    1-14

 



                                        Preparing to Install the Software
                                  1.7 Installation Procedure Requirements


              $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") <Return>
              15848
              $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") <Return>
              24

              See Table 1-6 to determine whether the number of contiguous
              free global pages and the number of free global sections is
              sufficient. If these values are not sufficient to continue
              with the installation, then see Section 1.7.4.4, which
              describes the procedures for increasing these values using
              the AUTOGEN utility.

              Table 1-6 Required Number of Contiguous Free Global Pages
              __________and_Free_Global_Sections_________________________

              ____________Currently_Running_DECwindows_Motif_____________

              System_Resource__Value_____________________________________

              CONTIG_GBLPAGES  12,000

              FREE_GBLSECTS       20

              ___________________________________________________________
              __________Not_Currently_Running_DECwindows_Motif___________

              System_Resource__Value_____________________________________

              CONTIG_GBLPAGES  92,000

              FREE_GBLSECTS______260_____________________________________

        1.7.4.3 Setting the Size of the Page File

              In order for DECwindows Motif to run with acceptable
              performance, the page file must be large enough to handle
              the virtual memory requirements of your system. The optimal
              size of the page file depends on many factors, such as the
              amount of physical memory on the system and the application
              work load.

              As a general rule, the page file size should be at least
              75,000 blocks. However, this size may be too small on
              systems where a large number of applications are run. On
              a heavily loaded system it may be possible to achieve large
              performance improvements by increasing the size of the page
              file by a factor of two or more.

                                                                     1-15

 



    Preparing to Install the Software
    1.7 Installation Procedure Requirements


          Normally, you should run AUTOGEN with feedback and let
          AUTOGEN calculate the size of the page file based on the
          usage pattern on your system. To run AUTOGEN with feedback,
          enter the following DCL command:

          $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT FEEDBACK

          You can also increase the size of the page file by running
          the SYSGEN utility or by invoking the command procedure
          SYS$UPDATE:SWAPFILES.COM.

          For more information about setting the size of the page
          file and running AUTOGEN, see the section about the AUTOGEN
          utility in the OpenVMS System Manager's Manual and the
          AUTOGEN section in OpenVMS System Management Utilities
          Reference Manual. For more information about performance
          tuning in general, see the OpenVMS Performance Management
          manual.

    1.7.4.4 Changing System Parameter Values Using the AUTOGEN
            Utility

          Use the AUTOGEN utility to change system parameters.
          AUTOGEN automatically adjusts values for parameters that
          are associated with the values you reset manually. To
          change system parameters with AUTOGEN, edit the file
          SYS$SYSTEM:MODPARAMS.DAT.

          To change a parameter value listed in this file, delete the
          current value associated with that parameter and enter the
          new value.

          To add a new parameter, add a line to the file and include
          both the name of the parameter and its value. For example:

          MIN_MAXBUF = 8192

          To make incremental adjustments to parameters, such as
          global pages and global sections, prefix the parameter name
          with ADD_. The following example increases the global pages
          value by 30,000:

          ADD_GBLPAGES = 30000


    1-16

 



                                        Preparing to Install the Software
                                  1.7 Installation Procedure Requirements


              Table 1-7 lists the system parameters that you need to
              adjust incrementally.

              Table 1-7 Recommended System Parameter Values to Use with
              __________the_ADD__Option__________________________________

              System
              Parameter________Increment_________________________________

              SYSMWCNT            -

              GBLSECTIONS         280

              GBLPAGES          92,000

              GBLPAGFIL           768

              NPAGEDYN         300,000

              PAGEDYN__________180,000___________________________________

























                                                                     1-17

 



    Preparing to Install the Software
    1.7 Installation Procedure Requirements


          After you enter all your changes, exit from the file and
          execute the AUTOGEN utility to recalculate your system
          parameters. Enter the following command to recalculate your
          system parameters and reboot the system:

          $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

          When you specify REBOOT, the AUTOGEN utility performs an
          automatic system shutdown and then reboots the system. Any
          users logged in to the system are immediately disconnected
          during the shutdown. The automatic reboot puts the new
          parameter values into effect.

          For details about using AUTOGEN, see the section about the
          AUTOGEN utility in the OpenVMS System Manager's Manual and
          the AUTOGEN section in OpenVMS System Management Utilities
          Reference Manual.

    1.7.5 Backing Up Your System Disk

          HP recommends that you back up your system disk before you
          install any software. At the beginning of the installation,
          the installation procedure asks whether your system disk is
          backed up. Use the backup procedures that are established
          at your site. For details about performing a system disk
          backup, see the section on the Backup utility in the
          OpenVMS System Management Utilities Reference Manual.

    1.7.6 Notifying Other Users

          Inform users on the system that you plan to install a
          product and that they must log out during the installation.
          To make sure that you are the only user logged in to the
          system, follow these steps:

          1. Notify current users to log out. Enter the following
             command at the DCL prompt:

             $ REPLY/ALL/BELL/SHUTDOWN "Log out for the installation of -
             _$ Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 please..."

          2. Enter the following command at the DCL prompt to prevent
             nonprivileged users from logging in to the system:

             $ SET LOGINS/INTERACTIVE=0

          If possible, give users an estimated time when they can log
          in to the system again.

    1-18

 










                                                                        2
        _________________________________________________________________

                       Using the POLYCENTER Software Installation Utility


              This chapter describes how to install and configure
              DECwindows Motif software using the POLYCENTER Software
              Installation (PCSI) utility. The DECwindows Motif product
              supports POLYCENTER Software installations using the
              Digital Command Language (DCL) interface.

              This chapter presents information about the following
              topics:

              o  Section 2.1, Accessing Help Information

              o  Section 2.2, Extracting and Printing the Product Release
                 Notes

              o  Section 2.3, Installing the DECwindows Motif Software

              o  Section 2.4, Recovering from Errors



















                                                                      2-1

 



    Using the POLYCENTER Software Installation Utility



          For HP DECwindows Motif for HP OpenVMS Alpha Version 1.3,
          the DECwindows X11 Display Server installs a patch kit
          that provides the necessary, updated server images to the
          OpenVMS Alpha Version 7.3-1 software. This installation is
          an integral part of the PCSI installation of Version 1.3.
          The server and client software will be installed in the
          proper order.

          Refer to the OpenVMS System Manager's Manual for complete
          details about installing and managing software products on
          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

          o  Reconfiguring installed products

          o  Copying software kits to new locations

          o  Retrieving product information

          Refer to Section 1.4 for information about prerequisite
          software and licenses.

             _______________________ Caution _______________________

             If you do not have a satisfactory backup copy of your
             system disk, do not attempt to install DECwindows
             Motif software. Back up the system disk (as described
             in the OpenVMS upgrade and installation supplement
             for your system) before you install DECwindows Motif
             software.

             Before beginning the installation procedure,
             review Chapter 1 for information about installation
             preparations and requirements.

             ______________________________________________________

    2.1 Accessing Help Information

          Online help is available with the installation utility for
          all PRODUCT commands and qualifiers. For help on a specific
          command, enter the DCL command HELP followed by the command
          and product name.

    2-2

 



                       Using the POLYCENTER Software Installation Utility
                                           2.1 Accessing Help Information


              Refer to the following documents for information about
              tasks and PRODUCT commands and qualifiers:

              o  OpenVMS System Manager's Manual

              o  OpenVMS System Management Utilities Reference Manual

              o  OpenVMS DCL Dictionary

              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.

              o  Press the Return key to accept default values.

              o  Confirm your responses.

                 After you respond to questions by selecting options
                 or accepting default values, the installation utility
                 displays a summary of your answers.

                 Then a question is displayed asking whether you are
                 satisfied with your answers and whether you want to
                 continue with the installation. If you decide to change
                 your responses, type No and press the Return key. You
                 can then either reenter your responses or answer No and
                 exit from the installation utility.

              o  Stop the installation by pressing Ctrl/Y. (Note that
                 this option is not recommended.)

        2.2 Extracting and Printing the Product Release Notes

              Before you begin the installation procedure, you should
              read the product's release notes. To extract a copy of the
              HP DECwindows Motif for HP OpenVMS Alpha Release Notes,
              define PCSI$SOURCE to point to the location (device name
              and directory) of the PCSI kit. Then enter the PRODUCT
              EXTRACT RELEASE_NOTES command followed by the product name,
              DWMOTIF, at the DCL prompt.

                                                                      2-3

 



    Using the POLYCENTER Software Installation Utility
    2.2 Extracting and Printing the Product Release Notes


          For example:

          $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF13]
          $ PRODUCT EXTRACT RELEASE_NOTES DWMOTIF

          Once you extract the release notes to a file, you can print
          the file. Note that you do not need to install the product
          before you extract the release notes.

          The HP DECwindows Motif for HP OpenVMS Alpha Release Notes
          are also available in HTML and ASCII (.TXT) formats in
          the documentation directory on the DECwindows Motif CD-
          ROM. Refer to the Guide to the HP DECwindows Motif for HP
          OpenVMS Alpha CD-ROM for information about accessing the
          release notes and other DECwindows Motif documentation.






























    2-4

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


        2.3 Installing the DECwindows Motif Software

                _______________________ Warning _______________________

                The DECwindows Motif software installation includes
                patches to the server software that is included in
                the OpenVMS Alpha operating system. Once these patches
                are installed, you cannot uninstall them. Removing
                the DECwindows Motif software using the PRODUCT REMOVE
                command does not remove the patches. The only method
                to restore your system to its former state is to
                reinstall the OpenVMS Alpha operating system. See
                Section 2.3.2.5 for more information.

                ______________________________________________________

              The sections that follow take you through the stages
              of installing your DECwindows Motif software using the
              POLYCENTER Software Installation utility.

              Refer to Chapter 1 for information about account quotas,
              disk space, and system parameters.

        2.3.1 Starting the Installation

              To start the POLYCENTER Software Installation utility,
              enter the following command at the DCL prompt:

              $ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF13]

              where device is the name of the device on which the
              distribution CD-ROM is mounted or on which the installation
              kit is located.

              Next, invoke the POLYCENTER Software Installation utility:

              $ PRODUCT INSTALL DWMOTIF

                ________________________ Note ________________________

                If you want to see the help text shown in this
                chapter, use the /HELP qualifier with the PRODUCT
                INSTALL command.

                ______________________________________________________

                                                                      2-5

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


    2.3.2 The Installation Dialog

          The installation dialog begins by displaying the name of
          the product which PCSI is installing. You are then asked to
          verify that you want to continue with the installation. The
          dialog continues with a display of product name, copyright,
          and Product Authorization Key (PAK) information.

    The following product has been selected:
        DEC AXPVMS DWMOTIF V1.3-0              Layered Product

    Do you want to continue? [YES]

    Configuration phase starting ...

    You will be asked to choose options, if any, for each selected product and for
    any products that may be installed to satisfy software dependency requirements.

    DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif

        Compaq DECwindows Motif for OpenVMS Alpha, Version 1.3 is based on Version 11
        Release 6.6 of the X Window System (X11R6.6) and OSF/Motif Version 1.2.3.

        DECwindows Motif V1.3-0 provides both runtime and development support for
        the X Window System. Runtime and development support is provided for X11
        Release 6.6 (X11R6.6) and OSF/Motif Version 1.2.3. For OSF/Motif Version 1.1.3,
        only runtime support is provided.

        Copyright 2003 Compaq Information Technologies Group, L.P.

        Compaq and the Compaq logo are trademarks of Compaq Information
        Technologies Group, L.P. in the U.S. and/or other countries.
        Motif is a registered trademark and The Open Group is a trademark
        of The Open Group in the United States and/or other countries.

        Confidential computer software. Valid license from Compaq or
        authorized sublicensor required for possession, use, or copying.
        Consistent with FAR 12.211 and 12.212, Commercial Computer Software,
        Computer Software Documentation, and Technical Data for Commercial
        Items are licensed to the U.S. Government under vendor's standard
        commercial license.

        Compaq Computer Corporation

        This software product is sold by Compaq Computer Corporation

        This product uses the PAK: DW-MOTIF

    2-6

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


            This software is furnished under the licensing provisions of Compaq
            Computer Corporation's Standard Terms and Conditions. For more in-
            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

              The installation command procedure checks to ensure that
              adequate values are allocated for the system parameters
              shown in Table 1-5 and Table 1-6. If your system values
              are sufficient, the installation procedure continues. If
              any of the values are insufficient, the procedure abandons
              the installation and instructs you to run AUTOGEN and then
              restart the installation. On OpenVMS Alpha systems, the
              procedure displays messages similar to the following:

        Checking values of system parameters...

        %DECW-W-BADVALUE, SYSGEN parameter GBLSECTIONS is 380, should be at least 600
        %DECW-W-BADVALUE, Free GBLSECTIONS is 15, should be at least 260

        %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000
        %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1294336, should be at least 1998848
        %DECW-W-BADVALUE, SYSGEN parameter CLISYMTBL is 265, should be at least 512

          The installation procedure has determined that some system parameter values
          require modification to install the DECwindows Motif Version 1.3 for
          OpenVMS software.

          Please type the following command to run AUTOGEN and reboot your system
          before restarting the DECwindows installation.  This will set the system
          parameters to appropriate values for running DECwindows Motif Version 1.3.

                @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

        The DECwindows installation is being terminated.

        Please run AUTOGEN and restart the installation.

        %PCSI-E-S_OPFAIL, operation failed
        %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error condition



                                                                      2-7

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


    2.3.2.2 Running AUTOGEN

          If the installation procedure has prompted you to run
          AUTOGEN to correct your system values, enter the following
          command:

          $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

          The system runs AUTOGEN and produces a log similar to the
          following example:

    %AUTOGEN-I-BEGIN, GETDATA phase is beginning.
    %AUTOGEN-I-NEWFILE,  Previous contents of SYS$SYSTEM:CLU$PARAMS.DAT have
      been copied to SYS$SYSTEM:CLU$PARAMS.OLD.  You may wish to purge
      SYS$SYSTEM:CLU$PARAMS.OLD.
    %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.
    %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning.
    %AUTOGEN-I-NEWFILE, A new version of SYS$MANAGER:VMSIMAGES.DAT has been created.
            You may wish to purge this file.
    %AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:SETPARAMS.DAT has been created.
            You may wish to purge this file.
    %AUTOGEN-I-END, GENPARAMS phase has successfully completed.
    %AUTOGEN-I-BEGIN, GENFILES phase is beginning.

    %AUTOGEN-I-REPORT, AUTOGEN has produced some informational messages which
            have been stored in the file SYS$SYSTEM:AGEN$PARAMS.REPORT.  You may
            wish to review the information in that file.

    %AUTOGEN-I-END, GENFILES phase has successfully completed.
    %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning.
    %AUTOGEN-I-SYSGEN, parameters modified
    %AUTOGEN-I-END, SETPARAMS phase has successfully completed.
    %AUTOGEN-I-BEGIN, REBOOT phase is beginning.

    The system is shutting down to allow the system to boot with the
    generated site-specific parameters and installed images.

    The system will automatically reboot after the shutdown and the
    upgrade will be complete.

            SHUTDOWN -- Perform an Orderly System Shutdown
                        on node MYNODE

          You can now restart the installation procedure (see
          Section 2.3.1).

    2-8

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


        2.3.2.3 Saving the Programming Environment

              The installation procedure checks whether the OSF/Motif
              Release 1.1.3 programming environment exists on your
              system. If it is present, the installation procedure
              displays the following information and asks whether you
              want to save the OSF/Motif Release 1.1.3 programming
              environment:

              The DECwindows Motif programming environment was installed with a
              previous version of this kit. This environment is incompatible with the
              OSF/Motif Release 1.2 environment provided with DECwindows Motif Version
              V1.3-0. The XUI programming environment is also not included in
              DECwindows Motif Version 1.3.

              If you intend to continue developing programs for XUI or OSF/Motif
              Release 1.1.3, then save this environment.  Please refer to the
              installation guide for more details and information on accessing these
              files in their new location.

              If you do not choose to save the XUI and OSF/Motif Release 1.1.3
              programming environment, those files will be removed from the system
              disk.

              Save the OSF/Motif Release 1.1.3 and XUI programming environment?

              If you answer Yes and press the Return key to save the
              OSF/Motif Release 1.1.3 and XUI programming environment,
              a subdirectory called [.DECW$113] is created. The files
              that support that programming environment are moved to the
              [.DECW$113] subdirectory.

              If you answer No and press the Return key, the files are
              deleted.

              Refer to Section 1.5 for information about accessing
              files related to the OSF/Motif Release 1.1.3 programming
              environment.

        2.3.2.4 Default Installation

              Next, the dialog asks if you want the default installation.
              On systems with no previous DECwindows Motif installation,
              the installation procedure installs all options that
              apply to your hardware platform. On systems with a
              previous DECwindows Motif installation, the installation
              procedure installs all options selected during the previous
              installation. Any options not present in the installed

                                                                      2-9

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


          version are installed according to the defaults for those
          options in Version 1.3.

          Do you want the defaults for all options? [YES]

          The remainder of this chapter assumes that you answer No to
          this question.

    2.3.2.5 Installation of Server Software

          The installation proceeds with an important warning about
          the DECwindows Motif server patch about to be installed by
          the installation procedure.

              DECwindows Motif V1.3-0 cannot be uninstalled.

              The DECwindows Motif for OpenVMS Alpha Version 1.3 software
              upgrade also updates certain images that are part of the OpenVMS Alpha
              operating system.  Removing the DECwindows Motif Version 1.3 product
              (using PRODUCT REMOVE) does not restore the operating system
              images to their proper state.

              To revert to a previous version of DECwindows Motif, you must first
              reinstall the OpenVMS Alpha operating system and then install the
              appropriate version of DECwindows Motif.

              Be sure that you want to install the DECwindows Motif Version 1.3 software
              before proceeding.

              Do you want to continue? [YES]

          Note that the server patch is always installed with
          DECwindows Motif. The question in this section asks if
          you want to continue with the product installation, not if
          you want to install the server software.

    2.3.2.6 Euro Currency Sign Support

          The dialog asks if you want to install support for the Euro
          currency sign.

    This option provides Euro sign support for Compaq DECwindows Motif for OpenVMS Alpha
    Version 1.3. After installing the option and performing the setup
    process, you can enter and display the Euro sign.

    Install the DECwindows Motif Euro sign support [NO]

          See the HP DECwindows Motif for HP OpenVMS Alpha New
          Features manual for more information about the Euro option.

    2-10

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


        2.3.2.7 LBX Proxy Installation

              Following the server installation, the dialog asks if you
              want to install the Low-Bandwidth X (LBX) proxy option.

            The LBX proxy reduces the overall network bandwidth required for
            client-to-server communications.  The LBX proxy can be installed as a standalone
            option or in conjunction with the DECwindows Motif client software.

            Install Low Bandwidth X (LBX) Support [YES]

              See the HP DECwindows Motif for HP OpenVMS Alpha New
              Features manual for more information about the LBX feature.

        2.3.2.8 Selecting Installation of Client Software

              Next, the installation procedure asks if you want to
              install the client software:

              Install the DECwindows Motif Version 1.3 client software? [YES]

              Answer Yes if you intend to run any programs requiring a
              DECwindows display, either on this system or on any remote
              system.

              If you answer No, skip to Section 2.3.2.12.

              If you answer Yes, the dialog asks if you want the default
              client installation:

              Do you want the defaults for all suboptions? [YES]

              Answer Yes if you want to take all the defaults for
              the client installation. If you answer Yes, skip
              to Section 2.3.2.12. If you answer No, proceed to
              Section 2.3.2.9.

        2.3.2.9 Asking About Selecting a Desktop

              The installation procedure displays information about the
              New Desktop and traditional DECwindows desktop. You can
              elect to install one of the desktops or both desktops.
              If you elect to install the New Desktop, the dialog asks
              whether the New Desktop should be the default desktop.

                  The New Desktop is a graphical user interface that is derived from the
                  Common Desktop Environment (CDE).  It offers the following features not
                  available with the traditional DECwindows desktop:

                      o Multiple workspaces for greater flexibility in managing windows on
                        the screen.

                                                                     2-11

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


                  o An icon-based File Manager to make it easier to manipulate files
                    from the graphical user interface.

                  o Enhanced support for the drag-and-drop feature, which is fully
                    supported in the new File Manager and Application Manager
                    applications.

                  o New Image Viewer and Icon Editor applications.

              Both the New Desktop and the DECwindows desktop provide the same underlying
              X and Motif libraries and the same DECterm, Bookreader, Mail, and Calendar
              applications.

              Install New Desktop [YES]

                  The manual pages provide online help text for New Desktop
                  functions. If installed they can be viewed using the man
                  page viewer from the Application Manager.

                  Install Manual (reference) pages for the New Desktop [YES]

                  If the New Desktop is the default, the new login box will be used and
                  the user has the option at login to use either the New or the traditional
                  desktop.

                  If the New Desktop is not the default, the traditional login box will be
                  used and only the traditional desktop will be available.

                  You can change the default desktop by editing the file
                  [SYSMGR]DECW$DEFAULT_DESKTOP.COM and restarting DECwindows.

                  Make the New Desktop the default desktop [YES]

              The traditional DECwindows Desktop is that provided since Version 1.2 of
              DECwindows. If both new and traditional desktops are installed the user
              can select which to run when logging in.

              Install traditional DECwindows Desktop [YES]

          See Section 3.4 for instructions about how to change the
          choice of desktop after the installation has completed.




    2-12

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


        2.3.2.10 Programming Language Support Options

              Next, the dialog asks you which programming languages
              you want to install and whether you want to install the
              programming examples.

              The installation procedure uses the following dialog:

              Headers and related files to support programs in C that will use the
              DECwindows libraries.

              Programming Support for the C Language [YES]

              Include files to support programs in Pascal that will use the
              DECwindows libraries.

              Programming Support for the Pascal Language [YES]

              Include files to support programs in FORTRAN that will use the
              DECwindows libraries.

              Programming Support for the FORTRAN Language [YES]

              Headers and related files to support programs in C that will use the
              New Desktop widgets.

              Programming Support for the New Desktop [YES]

              Examples of programming to use the various libraries.

              Programming examples [YES]

              Do you want all the defaults for the subitems? [YES] no

                  Sample sound files that can be used with DECsound.

                  Sound example files [YES]

                  Examples, in various programming languages, of using the DECwindows and
                  standard widgets and libraries.

                  Programming examples for DECwindows [YES]

                  Examples, in C, of using the new widgets provided with the New Desktop.

                  Programming examples for the New Desktop [YES]

                                                                     2-13

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


    2.3.2.11 Translated Image Support

          The dialog now prompts you to install Translated Image
          Support (TIS), which enables VAX programs to work in the
          Alpha environment. Note that TIS support is only available
          for the traditional DECwindows desktop environment.

          Translated image support allows programs translated from the VAX
          environment to work in the Alpha environment with the DECwindows
          libraries. Translated image support is not available for the New Desktop.

          Translated Image Support [YES]

    2.3.2.12 Language Variants Notice

          The dialog now displays a warning about the need to update
          any language variants. You should not install DECwindows
          Motif Version 1.3 unless you will also install DECwindows
          Motif Version 1.3 language variants for all the languages
          that you want to use.

          If a Local Language Variant is installed, refer to the Installation Guide.

          If you have a language variant of DECwindows Motif installed, then you
          must upgrade to the version for DECwindows Motif Version 1.3 after
          completing this installation and before rebooting the system. A failure
          to do so could prevent DECwindows from starting.

          If there is no local language variant upgrade available for DECwindows Motif
          Version 1.3, then you should remove the local language variant before
          installing DECwindows Motif Version 1.3.

          Do you want to continue? [YES]

    2.3.2.13 Reviewing the Installation Options

          The dialog gives you a chance to review the options you
          have selected during the installation dialog.

          Do you want to review the options? [NO] y





    2-14

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


              DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif
                  DEC AXPVMS VMS V7.3-1 [Installed]
                  Install the DECwindows Motif Euro sign support: NO
                  Install Low Bandwidth X (LBX) Support: YES
                  Install the DECwindows Motif V1.3-0 client software: YES
                    Install New Desktop: YES
                      Install Manual (reference) pages for the New Desktop: YES
                      Make the New Desktop the default desktop: YES
                    Install traditional DECwindows Desktop: YES
                    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: YES
                      Programming examples for DECwindows: YES
                      Programming examples for the New Desktop: YES
                    Translated Image Support: YES

              Are you satisfied with these options? [YES]

        2.3.2.14 Execution Dialog

              During the execution phase, the installation utility
              begins by displaying the names of all products it will
              install or remove. This is followed by an indication of the
              procedure's progress.

                ________________________ Note ________________________

                During the execution phase, a check is made for
                DECwindows Motif support files. If these files are not
                available, the dialog may ask if you want to continue.
                See Section 2.3.2.15 for more information.

                ______________________________________________________

              Execution phase starting ...

              The following product will be installed to destination:
                  DEC AXPVMS DWMOTIF V1.3-0              DISK$ALPHASYS:[VMS$COMMON.]
              The following product will be removed from destination:
                  DEC AXPVMS DWMOTIF V1.2-6              DISK$ALPHASYS:[VMS$COMMON.]


                                                                     2-15

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


          Portion done: 0%
          ...10%
          ...20%
          ...30%
          ...40%
          ...50%
          ...60%
          ...70%
          ...80%
          ...90%

    2.3.2.15 Verifying DECwindows Motif Support Files

          The installation procedure verifies that DECwindows Motif
          applications and run-time support files are installed on
          the operating system (for example, transport and font
          files, which are required for running DECwindows Motif
          software).

          **** DECwindows Motif application and run-time support files DETECTED ****

          On OpenVMS Alpha systems, the files are always installed.

          Next, the installation procedure checks for the presence
          of support files that are needed to use the system as a
          workstation or as a workstation boot server. If the support
          files are installed, the following message is displayed:

          **** DECwindows device support files DETECTED ****

          If the files are not installed, users are warned with
          the following message that their systems cannot be a
          workstation or a workstation boot server:

              The DECwindows device support files for using this machine as a workstation
              or as a boot node for workstations have not been installed.

              You can use the POLYCENTER Software Installation utility to change the
              options selected when the OpenVMS Alpha software was installed.
              See the POLYCENTER Software Installation Utility User's Guide for more
              information. To add the support files and the 75DPI and/or the 100DPI font
              files using the DECwindows save sets which are shipped with the OpenVMS
              kit, use the PRODUCT RECONFIGURE command as follows:

                $ PRODUCT RECONFIGURE VMS

              You should add the "Support for DECwindows" subclass in the Utilities
              class.

    2-16

 



                       Using the POLYCENTER Software Installation Utility
                             2.3 Installing the DECwindows Motif Software


              The installation procedure then asks the following
              question:

              Do you wish to continue with this installation without the workstation support?

              If you answer No (default) and press the Return key, the
              installation is stopped. Add the necessary support files.
              Once you install the necessary support files, restart the
              installation procedure.

              If you answer Yes and press the Return key, the
              installation continues.

        2.3.2.16 Reviewing Final Installation Notes

              If the installation is successful, the dialog displays a
              list of all products installed and removed. Finally, the
              procedure displays additional installation notes for the
              DECwindows Motif product.

              ...100%

              The following product has been installed:
                  DEC AXPVMS DWMOTIF V1.3-0              Layered Product
              The following product has been removed:
                  DEC AXPVMS DWMOTIF V1.2-6              Layered Product

              DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif

                  System reboot is required.

                  If using a language variant, reboot after upgrade of language variant.

                  A system reboot is required to install the new DECwindows Motif
                  images. If this is a new installation you should execute AUTOGEN using
                  the following command:

                          $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

                  This command adjusts your system parameters and reboots the system.

                  If you wish to use DECwindows with any language other than English,
                  install the appropriate DECwindows Motif Version 1.3 language
                  variant product before using AUTOGEN or rebooting the system.

                  Installation Verification Procedure can be run after reboot.

                  Run the Installation Verification Procedure (IVP) after the installation
                  is completed and the system is rebooted. The IVP is located in the
                  following directory: SYS$TEST:DECW$IVP.COM.

                                                                     2-17

 



    Using the POLYCENTER Software Installation Utility
    2.3 Installing the DECwindows Motif Software


    2.4 Recovering from Errors

          An error during installation can occur if one or more of
          the following conditions exists:

          o  The operating system version is incorrect.

          o  The prerequisite software version is incorrect.

          o  Quotas necessary for successful installation are
             inadequate.

          o  Process quotas required by the installation utility are
             inadequate.

          o  The OpenVMS Help library is currently in use.

          For descriptions of the error messages generated by these
          conditions, see the documents listed in the Associated
          Documents section in the Preface. These documents may help
          you diagnose errors and decide what corrective actions to
          take.

          If the installation procedure fails for any reason, the
          POLYCENTER Software Installation utility displays a message
          similar to the following:

          %PCSIUI-INSFAIL, The installation of DECwindows Motif Version 1.3 for
          OpenVMS has failed.

          If the installation fails, fix the problem and restart the
          installation procedure.

    2.5 Adjusting Parameters After Installation

          If you are simultaneously installing or upgrading the
          OpenVMS operating system with DECwindows from the CD-
          ROM, the installation procedure will will check the system
          parameters at this point (see Table 1-5 and Table 1-6).

             ________________________ Note ________________________

             You will not see this message if this is a new
             installation of DECwindows.

             ______________________________________________________

    2-18

 



                       Using the POLYCENTER Software Installation Utility
                              2.5 Adjusting Parameters After Installation


              When DECwindows Motif attempts to start after successful
              installation, you will see messages similar to the
              following:

        %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 120000, should be at least 150000
        %DECW-W-BADVALUE, Free GBLPAGES is 75040 should be at least 92000
        %DECW-W_BADVALUE, SYSGEN parameter CLISYMTBL is 256, should be at least 512
        Some SYSGEN parameters must be reset for DECwindows to start. If you type
        YES, AUTOGEN will change these parameters and reboot your system. If you type
        NO, AUTOGEN will not be run or cause a reboot but DECwindows will not start.
        Do you want the system to run AUTOGEN for you [YES]

              At this point, press RETURN. The system will run AUTOGEN,
              adjust your system parameters, reboot the system and
              display the DECwindows login.






























                                                                     2-19

 










                                                                        3
        _________________________________________________________________

                                            After Installing the Software


              This chapter discusses the tasks that you need to perform
              after the DECwindows Motif installation is completed:

              o  Section 3.1, Starting the DECwindows Motif Software

              o  Section 3.2, Running the IVP

              o  Section 3.3, Choosing an Alternate Console

              o  Section 3.4, Selecting the Desktop

        3.1 Starting the DECwindows Motif Software

              The DECwindows startup procedure runs automatically when
              the system reboots. Either the New Desktop login dialog
              box or the DECwindows desktop Start Session dialog box
              is displayed, depending on the value of the DECW$START_
              NEW_DESKTOP global symbol. (See Section 3.4 for more
              information.)

              If the DW-MOTIF license that is installed on your system
              is not valid, appropriate messages display on your console
              terminal and DECwindows Motif is not automatically started.
              If this situation occurs, log in to the system, install the
              valid license, and start your DECwindows Motif software.
              For complete information on installing licenses using
              LMF, see the OpenVMS License Management Utility Manual.
              For information on starting DECwindows, see the chapter
              entitled "Starting DECwindows Motif" in Managing DECwindows
              Motif for OpenVMS Systems.






                                                                      3-1

 



    After Installing the Software
    3.2 Running the IVP


    3.2 Running the IVP

          Run the IVP, SYS$TEST:DECW$IVP.COM, after you install and
          start the DECwindows Motif product. This procedure contains
          six tests, which verify that the software installation is
          complete and accurate.

          First, the IVP procedure attempts to run two display-
          oriented tests. When you invoke the IVP, it identifies
          your type of hardware.

          o  If you are using a workstation, you are asked where
             the display-oriented tests should display. Your current
             workstation is the default.

          o  If you are not using a workstation, the procedure
             prompts you for a display name.

          Press Ctrl/Z at the prompt if you do not want to run the
          display-oriented tests. The IVP runs these tests only if
          the images exist on the system. If the IVP does not find
          the images, a message displays to inform you that the tests
          will not be run.

          Next, if the display-oriented tests were selected and the
          display has been configured to support the LBX feature, the
          IVP repeats the same display-oriented tests using an LBX
          proxy server. For a description of how to configure support
          for the LBX feature, see the HP DECwindows Motif for HP
          OpenVMS Alpha New Features manual.

          Finally, the IVP runs two nondisplay-oriented tests.

          o  The first of these tests invokes the Motif UIL compiler.
             If you did not install programming support, the IVP
             informs you that this test will not be run because the
             Motif UIL image does not exist. If this test is run, you
             are notified of its completion status.

          o  The last test converts a text file to DDIF format and
             then converts it back to text, comparing the original
             text file with the result. If the files match, the
             test is successful. You are notified of its completion
             status.

    3-2

 



                                            After Installing the Software
                                                      3.2 Running the IVP


              Example 3-1 shows you how to run the IVP.

        Example 3-1 Sample IVP

        $ @SYS$TEST:DECW$IVP

        Copyright 2003 Compaq Information Technologies Group, L.P.

        Compaq DECwindows Motif for OpenVMS Alpha Installation Verification Procedure (IVP)

        This IVP is intended to test some of the functionality of DECwindows Motif
        and to provide a quick method of verifying the installation.

        This machine is not a workstation.  Please provide the nodename of a
        workstation on which to display the IVP tests.  You must be sure that this
        account and node have security access to the display node, or the IVP will
        fail.

        To skip the display-oriented tests, press Ctrl/Z at the following prompt.

        _Display: NODE33::0.0

        %DECW-I-IVP, The IVP will display on NODE33::0.0
        %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute.
        %DECW-I-IVP, Press Ctrl/Y to interrupt test.
        %DCL-S-SPAWNED, process DECW$IVP_ICO spawned
        %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute.
        %DECW-I-IVP, Press Ctrl/Y to interrupt test.
        %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned

        %DECW-I-IVP, Server does not support LBX. Proxy test skipped.

        %DECW-I-IVP, Invoking the UIL Motif compiler...
        %DECW-S-IVP, The UIL Motif compiler test completed successfully.
        %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP...
        %DECW-S-IVP, CONVERT/DOCUMENT IVP passed.
        %DECW-S-IVP, The IVP has completed.
        $

              If the server supports LBX proxies, the following messages
              are displayed instead of the Server does not support LBX
              message shown in the preceding example:



                                                                      3-3

 



    After Installing the Software
    3.2 Running the IVP


    %DECW-I-IVP, LBX Proxy tests, test will execute through a proxy
    %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute.
    %DECW-I-IVP, Press Ctrl/Y to interrupt test.
    %DCL-S-SPAWNED, process DECW$IVP_LBX spawned
    PROXY_MANAGER=local/MISATO:9999
    $ lbxproxy
    %DECW-I-ATTACHED, transport TCPIP attached to its network
    %DECW-I-ATTACHED, transport DECNET attached to its network
    %DCL-S-SPAWNED, process DECW$IVP_ICO spawned
    %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute.
    %DECW-I-IVP, Press Ctrl/Y to interrupt test.
    %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned

    3.3 Choosing an Alternate Console

          The DECwindows Motif software allows you to boot all
          configurations from the main console. You can then
          toggle between displaying and not displaying the operator
          window by pressing Ctrl/F2. The main console is always a
          workstation screen.

          If you are logged in to the main console (workstation
          screen), you must log out before DECwindows will start.
          Issue the following command from the main console:

           $  @SYS$MANAGER:DECW$STARTUP

          Once the command procedure completes, log out of the main
          console. Otherwise the server will not start and a login
          box will not appear.

          For an alternative console, you can use a terminal
          connected to the workstation by means of a terminal port.

          If you boot from the main console, the alternative console
          is connected when you invoke the DECwindows Motif startup
          command procedure.

          If you boot the system from an alternative console,
          you cannot start the Console Window application. This
          application is described in the release notes.




    3-4

 



                                            After Installing the Software
                                                3.4 Selecting the Desktop


        3.4 Selecting the Desktop

              DECwindows Motif provides a choice of two desktops: the
              New Desktop, which is derived from the Common Desktop
              Environment (CDE), and the traditional DECwindows desktop.

              During the installation, if you choose to install both the
              New Desktop and the DECwindows desktop, you are asked which
              desktop you wish to be the default desktop.

              To select the other desktop as the default desktop, perform
              the following steps.

              1. If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does
                 not exist, copy it from DECW$PRIVATE_APPS_SETUP.TEMPLATE
                 (or create it if an earlier version of DECwindows Motif
                 has not been installed on your system). For example:

                 $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE -
                 _$ SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM

              2. Edit SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM and add
                 a symbol definition for DECW$START_NEW_DESKTOP. If you
                 wish the New Desktop as the default enter the following
                 global symbol definition:

                 $ DECW$START_NEW_DESKTOP == "TRUE"

                 If you want the DECwindows desktop as the default, enter
                 the following global symbol definition:

                 $ DECW$START_NEW_DESKTOP == "FALSE"

              3. Restart DECwindows using the following command:

                 $ @SYS$MANAGER:DECW$STARTUP RESTART









                                                                      3-5

 










                                                                        4
        _________________________________________________________________

                                       Managing DECwindows Motif Software


              After you install the HP DECwindows Motif for HP OpenVMS
              Alpha product, you can tune your system to enhance
              performance, decrease the use of some system resources,
              and specify certain server settings. This chapter contains
              information about setting up your DECwindows Motif
              environment. See Managing DECwindows Motif for OpenVMS
              Systems and HP DECwindows Motif for HP OpenVMS Alpha New
              Features for additional system management information.

              The following topics are discussed in this chapter:

              o  Section 4.1, Customizing the DECwindows X11 Display
                 Server Startup Procedure

              o  Section 4.2, Determining and Reporting Problems





















                                                                      4-1

 



    Managing DECwindows Motif Software
    4.1 Customizing the DECwindows X11 Display Server Startup Procedure


    4.1 Customizing the DECwindows X11 Display Server Startup
        Procedure

          The DECwindows X11 Display Server manages the graphics
          devices on your workstation, such as the display, keyboard,
          and mouse. The initial startup command procedures
          automatically determine most of the configuration
          parameters for the DECwindows X11 Display Server. However,
          the command procedures cannot determine some items, such as
          the:

          o  List of screens associated with this server

          o  Font, resolution, and color capabilities for each screen

          o  Layout of the keyboard (such as, LK201-AA or LK401-AA)

          o  Appropriate network transport

          o  List of valid font servers and whether to active the
             font server on this system

          o  Level of auditing for client connections

          o  List of X server extensions to activate (such as,
             XINERAMA, SECURITY, or XKB)

          o  Current security policy (if using SECURITY)

          o  Current location of X authority file

          o  List of users that have trusted access to this server

          o  Number and order of screens in a multihead configuration
             (if using XINERAMA)

          o  X keyboard layout and related options (if using XKB)

          You can specify these display server settings by modifying
          the server startup file as follows:

          1. Make a copy of the file SYS$MANAGER:DECW$PRIVATE_
             SERVER_SETUP.TEMPLATE and rename it to
             SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM. This
             server startup file shows how to customize individual
             workstations by adding a section of DCL commands for
             each workstation.

    4-2

 



                                       Managing DECwindows Motif Software
      4.1 Customizing the DECwindows X11 Display Server Startup Procedure


              2. Edit the file to add or change the desired setup options
                 in either of two sections in the server startup file.
                 Details on these options are available from Managing
                 DECwindows Motif for OpenVMS Systems, HP DECwindows
                 Motif for HP OpenVMS Alpha New Features, and the file
                 itself. Setup options added to the "Cluster Common
                 or Standalone Workstation Setup" section affect all
                 nodes in a cluster. Setup options added to the "Cluster
                 Member Workstation-Specific Setup" section affect only
                 individual nodes. If you add a workstation-specific
                 option, you must also update the variable node_list.

              3. Restart DECwindows Motif on the workstations for which
                 you customized the server startup using the following
                 command:

                 $ @SYS$MANAGER:DECW$STARTUP RESTART

        4.2 Determining and Reporting Problems

              If you encounter a problem while using DECwindows Motif,
              report it to HP. Review the Software Product Description
              (SPD) for an explanation of warranty. If you encounter a
              problem during the warranty period, you can take one of the
              following actions:

              o  Call your HP support representative if your software
                 contract or warranty agreement entitles you to telephone
                 support.

              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 your
                 comments by Internet, fax, or mail. (See the Reader's
                 Comments section in the Preface for addresses.)










                                                                      4-3

 










                                                                        A
        _________________________________________________________________

             POLYCENTER Software Installation Utility Sample Installation


              This appendix contains a sample installation of the
              DECwindows Motif software on the OpenVMS Alpha Version
              7.3-1 operating system.

              Refer to Chapter 2 for details about using the POLYCENTER
              Software Installation utility to install DECwindows Motif
              software.

              The sample installation assumes that you have set the
              default directory to the device name and directory
              containing the DECwindows Motif saveset, as well as any
              necessary ECOs.
























                                                                      A-1

 



    POLYCENTER Software Installation Utility Sample Installation
    A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System


    A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System

          Example A-1 contains a sample of the DECwindows Motif
          software installation on an OpenVMS Alpha Version 7.3-1
          operating system with sufficient system resources.

    Example A-1 Sample Installation of an Upgrade of the DECwindows
                Motif Software on an OpenVMS Alpha Version 7.3-1
                System With Sufficient System Resources

    $ PRODUCT INSTALL DWMOTIF <Return>

    The following product has been selected:
        DEC AXPVMS DWMOTIF V1.3-0              Layered Product

    Do you want to continue? [YES] <Return>

    Configuration phase starting ...

    You will be asked to choose options, if any, for each selected product and for
    any products that may be installed to satisfy software dependency requirements.

    DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif

        Copyright 2003 Compaq Information Technologies Group, L.P.

        Compaq Computer Corporation

        This product uses the PAK: DW-MOTIF

    Checking values of system parameters...

                                           OK

        DECWindows Motif V1.3-0 cannot be uninstalled.

        The DECwindows Motif for OpenVMS Alpha Version 1.3 software
        upgrade also updates certain images that are part of the OpenVMS Alpha
        operating system.  Removing the DECwindows Motif Version 1.3 product
        (using PRODUCT REMOVE) does not restore the operating system
        images to their proper state.

                                             (continued on next page)


    A-2

 



             POLYCENTER Software Installation Utility Sample Installation
         A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System


        Example A-1 (Cont.) Sample Installation of an Upgrade of the
                            DECwindows Motif Software on an OpenVMS Alpha
                            Version 7.3-1 System With Sufficient System
                            Resources

            To revert to a previous version of DECwindows Motif, you must first
            reinstall the OpenVMS Alpha operating system and then install the
            appropriate version of DECwindows Motif.

            Be sure that you want to install the DECwindows Motif Version 1.3 software
            before proceeding.

        Do you want the defaults for all options? [YES] <Return>

        If a Local Language Variant is installed, refer to the Installation Guide.

        Do you want to continue? [YES] <Return>

        Do you want to review the options? [NO] Y <Return>

        DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif
            DEC AXPVMS VMS V7.3-1 [Installed]
            Install the DECwindows Motif Euro sign support: NO
            Install Low Bandwidth X (LBX) Support: YES
            Install the DECwindows Motif V1.3-0 client software: YES
              Install New Desktop: YES
                Install Manual (reference) pages for the New Desktop: YES
                Make the New Desktop the default desktop: YES
              Install traditional DECwindows Desktop: YES
              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: YES
                Programming examples for DECwindows: YES
                Programming examples for the New Desktop: YES
              Translated Image Support: YES

        Are you satisfied with these options? [YES]  <Return>


                                                 (continued on next page)


                                                                      A-3

 



    POLYCENTER Software Installation Utility Sample Installation
    A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System


    Example A-1 (Cont.) Sample Installation of an Upgrade of the
                        DECwindows Motif Software on an OpenVMS Alpha
                        Version 7.3-1 System With Sufficient System
                        Resources

    Execution phase starting ...

    The following product will be installed to destination:
        DEC AXPVMS DWMOTIF V1.3-0              DISK$2:[VMS$COMMON.]
    The following product will be removed from destination:
        DEC AXPVMS DWMOTIF V1.2-6              DISK$2:[VMS$COMMON.]

    Portion done: 0%
    ...10%
    ...20%
    ...30%
    ...40%
    ...50%
    ...60%
    ...70%
    ...80%
    ...90%

      **** DECwindows Motif application and run-time support files DETECTED ****

      **** DECwindows device support files DETECTED ****

    ...100%

    The following product has been installed:
        DEC AXPVMS DWMOTIF V1.3-0              Layered Product
    The following product has been removed:
        DEC AXPVMS DWMOTIF V1.2-6              Layered Product

    DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif

        System reboot is required.

        Installation Verification Procedure can be run after reboot.
    $ Logout <Return>

                                             (continued on next page)



    A-4

 



             POLYCENTER Software Installation Utility Sample Installation
         A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System


        Example A-1 (Cont.) Sample Installation of an Upgrade of the
                            DECwindows Motif Software on an OpenVMS Alpha
                            Version 7.3-1 System With Sufficient System
                            Resources









































                                                                      A-5

 










                                                                        B
        _________________________________________________________________

                                                      Software Components


              If you installed DECwindows Motif using the POLYCENTER
              Software Installation utility, you can obtain a list of all
              installed files and the directories and subdirectories into
              which the files were installed.

              To obtain this list, enter the following POLYCENTER
              Software Installation utility command:

              $ PRODUCT SHOW OBJECT/product=dwmotif

              Following is a sample output from this command.

        OBJECT                                              OBJECT TYPE     STATUS
        ------                                              -----------     ------
        [000000]                                            directory       OK
        [000000]DEC-AXPVMS-DWMOTIF-V0103-1.PCSI$DESCRIPTION file            OK
        [000000]DEC-AXPVMS-DWMOTIF-V0103-1.PCSI$TLB         file            OK
        [CDA$LIBRARY]                                       directory       OK
        [CDA$LIBRARY]CL_DAY.DOC_STYLE                       file            OK
        [CDA$LIBRARY]DEFSTYLE.DDIF                          file            OK
        [CDE$DEFAULTS]                                      directory       OK
        [CDE$DEFAULTS]                                      directory       OK
        [CDE$DEFAULTS.SYSTEM]                               directory       OK
        [CDE$DEFAULTS.SYSTEM]                               directory       OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS]                  directory       OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]                directory       OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DT.DAT          file            OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCALC.DAT      file            OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCREATE.DAT    file            OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTFILE.DAT      file            OK
        [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTHELLO.DAT     file            OK
        .
        .
        .


                                                                      B-1

 














     _________________________________________________________________

                                                                 Index



     A                                 Bookreader
     _______________________________     copying customized files to
     Account quotas                         another directory, 1-6

       See also Quotas                   saving customized files,  1-6
       required for installation,      Booting
         1-8                             DECwindows Motif,  3-1
     Alternative console               BYTLM parameter
       See Console                       required quota for
     ASTLM parameter                        installation, 1-8

       required quota for              C
         installation,  1-8            _______________________________
     AUTHORIZE utility                 CDE,  3-5
       using to change Quotas, 1-8     Components
     AUTOGEN utility                     DECwindows network transport
       preparing for installation,          and base-system support,
         1-13                               1-3
       rebooting the system, 1-18        DECwindows X11 Display Server
       using to change system               , 1-3
         parameters,  1-16             Console
                                         alternative,  3-4
     B______________________________     main,  3-4
     Backup                            Customize
       backing up a system disk,         system after installation,
         1-18                               4-1
     Base kit                          Customizing
       required disk space, 1-9          Bookreader files
     BIOLM parameter                        saving,  1-6

       required quota for
         installation,  1-8

     Blocks

       See Free blocks

                                                               Index-1

 








    D______________________________    G______________________________

    DECwindows X11 Display Server      Global pages
      customizing startup,  4-2         See Free global pages
      installing,  1-3                 Global sections
    Desktop                             See Free global sections
      selecting,  2-11, 3-5
    DIOLM parameter                    H
      required quota for               _______________________________
         installation, 1-8             Hardware
    Disk space                          supported by DECwindows Motif
      determining                          , 1-2
         amount,  1-9
         number of free blocks,        I______________________________
            1-9                        Installation requirements, 1-7
      required                         IVP
         by component,  1-9             running

    E                                      after starting the product
    _______________________________           , 3-2
    ENQLM parameter
      required quota for               L______________________________
         installation, 1-8             Language variants
    Euro currency support               installing,  2-14
      selecting,  2-10                 License registration, 1-2
    Example programs                   Logging out
      required disk space,  1-9         notifying users,  1-18

    F                                  Low-Bandwidth X (LBX)
    _______________________________     IVP support,  3-2
    FILLM parameter                    Low-Bandwidth X (LBX) support
      required quota for                selecting,  2-11

         installation, 1-8
    Free blocks                        M______________________________
      determining amount,  1-9         Main console, 3-4
    Free global pages                  Memory requirements, 1-3
      calculating,  1-14
      required,  1-15                  N
    Free global sections               _______________________________
      calculating,  1-14               New Desktop
      required,  1-15                   selecting,  2-11, 3-5


    Index-2

 







                                          POLYCENTER Software
        O______________________________      Installation utility

        Operating system prerequisites       (cont'd)

         using the POLYCENTER Software      responding to questions
            Installation utility,  1-3        during installation,  2-3
        Operator window, 3-4                running the installation

                                              command procedure,  2-5
        P______________________________     selecting Euro support, 2-10
        Page file size                      selecting LBX support, 2-11
         setting,  1-15                     selecting the desktop, 2-11
        Parameters                        Postinstallation
         See System parameters              determining and reporting
        PCSI installation                     problems,  4-3
         checking                           tasks
            programming environment,           customizing DECwindows
               2-9                               Motif,  4-2
         displaying                       Postinstallation tasks,  3-1
            language variants,  2-14        choosing an alternate console
         installing                           ,  3-4
            TIS support,  2-14              running the IVP, 3-2
         selecting Euro support,  2-10      starting DECwindows Motif
         selecting LBX support,  2-11         software,  3-1
         verifying                        Prerequisite software
            applications and run-time       using the POLYCENTER Software
               support files,  2-16           Installation utility,  1-3
            device support files,         Programming
               2-16                         environment
            system parameters,  2-7            disk space requirements,
        POLYCENTER Software                      1-9
          Installation utility                 saving, 2-9
         accessing DCL help,  2-2           support
         backing up the system disk,           compatibility in the
            2-2                                  XUI and OSF/Motif
         confirming your responses to            environments,  1-5
            questions,  2-3                    OSF/Motif Release 1.1.3,
         displaying                              1-5

            messages when the             Q
               installation fails,        _______________________________
               2-18                       Quotas
         extracting the release notes,      minimum required for
            2-3                               installation,  1-7
         prerequisites for                  verifying and changing, 1-8

            installation,  1-3

                                                                  Index-3

 







                                       System parameters
    R______________________________     changing (cont'd)

    Release notes                          by using the AUTOGEN
      accessing                               utility, 1-16
         POLYCENTER Software               values,  1-16
            Installation utility,       checking
            2-3                            values,  1-13
      extracting to a file              minimum required,  1-11
         POLYCENTER Software            modifying
            Installation utility,          incremental adjustments,
            2-3, 2-4                          1-16
                                        recalculating,  1-18
    S______________________________     setting WINDOW_SYSTEM,  3-1

    Selecting a desktop,  3-5          T
    Server startup                     _______________________________
      customizing,  4-2                TIS support
    Shutting down the system            installing,  2-14
      notifying users,  1-18           Tuning the system, 4-1

    Software
      required operating system        W______________________________

         version, 1-3                  WINDOW_SYSTEM system parameter
    Starting DECwindows Motif,  3-1     setting,  3-1
    SYSGEN utility
      checking system parameter
         values, 1-13
      preparing for installation,
         1-13
    System
      shutdown
         notifying users,  1-18
    System disk
      backing up,  2-2
      determining
         number of free blocks,
            1-9
      free space required for
         installation, 1-9

    System Generation utility

      See SYSGEN utility
    System parameters
      adding
         new parameters,  1-16
      changing

    Index-4
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     