HP OpenVMS Systems Documentation

Content starts here

HP DECwindows Motif
for HP OpenVMS Alpha
Installation Guide

Previous Contents Index

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
GBLPAGES 150,000 1
MAXBUF 8,192
PQL_MBYTLM 100,000
NPAGEDYN 1,998,848
PAGEDYN 600,000
WSMAX 12,000

1If 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.


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.


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


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:


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 describes the procedures for using the AUTOGEN utility to increase these values. 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:


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:


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, 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
Not Currently Running DECwindows Motif
System Resource Value
FREE_GBLSECTS 260 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.

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:


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


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:


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
NPAGEDYN 300,000
PAGEDYN 180,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:


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:


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 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:

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:

  • Removing installed products
  • Reconfiguring installed products
  • Copying software kits to new locations
  • Retrieving product information

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


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.

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

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

For example:


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.3 Installing the DECwindows Motif Software


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 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:


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:



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

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

    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.

Previous Next Contents Index