# Compaq DECwindows Motif
for OpenVMS
Installation Guide

Previous | Contents | Index

### 1.8.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, use ADD_. The following example increases the global pages value by 30,000:

    ADD_GBLPAGES = 30000

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

Table 1-6 Recommended System Parameter Values to Use with the ADD_ Option
System Parameter | Alpha Increment | VAX Increment
--- | --- | ---
SYSMWCNT | --- | 235
GBLSECTIONS | 280 | 140
GBLPAGES | 92,000 | 30,000
GBLPAGFIL | 768 | 5,000
NPAGEDYN | 300,000 | 500,000
PAGEDYN | 180,000 | 100,000

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.8.5 Backing Up Your System Disk

Compaq 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.8.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, Version 1.2--6 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.

# Chapter 2
Using the POLYCENTER Software Installation Utility

This chapter describes how to install and configure Compaq DECwindows Motif for OpenVMS software using the POLYCENTER Software Installation utility on Alpha and VAX systems. The Compaq DECwindows Motif for OpenVMS product supports POLYCENTER Software installations using the Digital Command Language (DCL) interface.

This chapter presents information about the following topics:

- Section 2.1, Accessing Help Information
- Section 2.2, Extracting and Printing the Product Release Notes
- Section 2.3, Installing the Software
- Section 2.4, Recovering from Errors

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:

- Removing installed products
- Reconfiguring installed products
- Copying software kits to new locations
- Retrieving product information
- Discussing differences between the POLYCENTER Software Installation utility and the VMSINSTAL procedure

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

Note You must use the VMSINSTAL Software Installation utility to install DECwindows Motif software on VMS Version 5.5--2 systems.

Caution If you do not have a satisfactory backup copy of your system disk, do not attempt to install Compaq DECwindows Motif for OpenVMS software. Back up the system disk (as described in the OpenVMS upgrade and installation supplement for your Alpha or VAX processor) before you install Compaq DECwindows Motif for OpenVMS 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.

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

- OpenVMS System Manager's Manual
- OpenVMS System Management Utilities Reference Manual
- OpenVMS DCL Dictionary

# 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 Compaq DECwindows Motif for OpenVMS 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.

For example:

    $ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF126]
    $ 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 Compaq DECwindows Motif for OpenVMS Release Notes are also available in HTML and ASCII (.TXT) formats in the documentation directory on the Compaq DECwindows Motif for OpenVMS CD-ROM. Refer to the Guide to the Compaq DECwindows Motif for OpenVMS CD--ROM for information about accessing the release notes and other DECwindows Motif documentation.

# 2.3 Installing the Software

Important If you are installing Compaq DECwindows Motif for OpenVMS software on an OpenVMS Version 7.1 or Version 6.2 system, you must install an ECO for the POLYCENTER Software Installation utility before installing the DECwindows Motif software. See the Guide to the Compaq DECwindows Motif for OpenVMS CD--ROM for details about this ECO. See Section 1.5 for more information.

The sections that follow take you through the stages of installing your Compaq DECwindows Motif for OpenVMS software using the POLYCENTER Software Installation utility. The installation procedure is nearly identical on Alpha and VAX systems.

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

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:

- Enter a value and press the Return key to select options.
- Press the Return key to accept default values.
- 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.
- Stop the installation by pressing Ctrl/Y.
  Note that this option is not recommended.

## 2.3.1 Starting the Installation

To start the POLYCENTER Software Installation utility, enter one of the following commands at the DCL prompt:

    $ DEFINE PCSI$SOURCE device:[PCSI_ALPHA_DWMOTIF126]

or

    $ DEFINE PCSI$SOURCE device:[PCSI_VAX_DWMOTIF126]

where device is the name of the device on which the distribution CD-ROM is mounted.

Next, invoke the POLYCENTER Software Installation utility:

    $ PRODUCT INSTALL DWMOTIF

## 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 wish 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.2-6              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.2-6: DECwindows Motif

        Compaq DECwindows Motif for OpenVMS Alpha, Version 1.2-6 is based on
        Release 5 (R5) of the MIT X11 Window System and OSF/Motif
        Version 1.2.3.

        DECwindows Motif V1.2-6 provides both runtime support and development
        support for the X Window system. Runtime and development support is
        provided for MIT X11 Release 5 and OSF/Motif Version 1.2.3. Runtime
        only support is provided for OSF/Motif Version 1.1.3.

        Copyright 2000 Compaq Computer Corporation

        COMPAQ and the Compaq logo Registered in U.S. Patent and Trademark
        Office.

        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

        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

Note If you are simultaneously installing or upgrading the OpenVMS operating system with DECwindows from the CD-ROM, the installation procedure will continue without checking your system values. It will check after the installation is complete (see Section 2.5).

The installation command procedure checks to ensure that adequate values are allocated for GBLPAGES, CLISYMTBL, and NPAGEDYN system parameters:

- On OpenVMS Alpha systems, the minimum value for the GBLPAGES system parameter is 150,000; on OpenVMS VAX systems, the minimum value is 62,000.
- On OpenVMS Alpha systems, the minimum value for the CLISYMTBL system parameter is 512; on OpenVMS VAX systems, the minimum value is 256.
- On OpenVMS Alpha systems, the minimum value for the NPAGEDYN system parameter is 1,998,848; on OpenVMS VAX systems, the minimum value is 999,936.

If your system values are sufficient, the installation procedure continues. If 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 a message similar to the following:

    Checking values of system parameters...

    %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.2-6 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 V1.2-6.

            @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

A similar message is displayed on OpenVMS VAX systems.

### 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.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
    1.2-6. The XUI programming environment is also not included in
    DECwindows Motif Version 1.2-6.

    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.6 for information about accessing files related to the OSF/Motif Release 1.1.3 programming environment.

Note that this portion of the installation does not occur if you are simultaneously installing or upgrading the OpenVMS operating system with DECwindows.

### 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.

    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 Asking About Selecting a Desktop (Alpha Only)

On OpenVMS Alpha systems, the installation procedure displays information about the New Desktop and asks you whether the New Desktop should be the default desktop.

        Install New 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.

            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]

            Install Manual (reference) pages for the New Desktop

            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]

            Make the New Desktop the default desktop [YES]

        Install traditional DECwindows Desktop

        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 4.4 for instructions about how to change the choice of desktop after the installation has completed.

### 2.3.2.6 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.

On OpenVMS Alpha systems, the installation procedure uses the following dialog:

    Programming Support for the C Language

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

    Programming Support for the C Language [YES]

    Programming Support for the Pascal Language

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

    Programming Support for the Pascal Language [YES]

    Programming Support for the FORTRAN Language

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

    Programming Support for the FORTRAN Language [YES]

    Programming Support for the New Desktop

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

    Programming Support for the New Desktop [YES]

    Programming examples

    Examples of programming to use the various libraries.

    Programming examples [YES]

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

        Sound example files

        Sample sound files that can be used with DECsound.

        Sound example files [YES]

        Programming examples for DECwindows

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

        Programming examples for DECwindows [YES]

        Programming examples for the New Desktop

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

        Programming examples for the New Desktop [YES]

On OpenVMS VAX systems, the installation procedure uses the following dialog:

    DECwindows Motif runtime support files [YES]

    Programming Support for the C Language

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

    Programming Support for the C Language [YES]

    Programming Support for the Pascal Language

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

    Programming Support for the Pascal Language [YES]

    Programming Support for the FORTRAN Language

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

    Programming Support for the FORTRAN Language [YES]

    Programming examples [YES]

Previous | Next | Contents | Index