HP OpenVMS Systems Documentation

Table 1-5 lists the minimum required system parameter values for the installation. The DECwindows Motif installation process now checks for these minimums automatically. If the minimums need adjusting, the installation process creates a NEWPARAMS.DAT file which AUTOGEN uses as input for its CLU$PARAMS.DAT file. The CLU$PARAMS.DAT file captures system parameter requirements from layered products that use the NEWPARAMS.DAT method of supplying their system parameter requirements to AUTOGEN. In most cases, this process eliminates the need to modify the MODPARAMS.DAT file.

If you are installing DECwindows Motif and OpenVMS simultaneously, the installation process delays requirements checking until the installation completes. In this case, AUTOGEN is run automatically (see Section 2.5). Otherwise, the check occurs within the installation procedure and you are instructed to run AUTOGEN before proceeding with the installation (see Section 2.3.2.1).

Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. If you need higher settings, you should modify the MODPARAMS.DAT file before doing an AUTOGEN.

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.

To check the value of a system parameter, invoke the SYSGEN utility by entering the following command at the DCL prompt:

$ RUN SYS$SYSTEM:SYSGEN
SYSGEN> USE CURRENT
SYSGEN>

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

SYSGEN> SHOW CLISYMTBL

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

Remember, you only need to modify system parameters if the values given in Table 1-5 are inadequate for your particular installation.

1.7.4.2 Calculating the Number of Free Global Pages and Global Sections

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. Table 1-6 gives the number of free global pages and global sections required by DECwindows Motif when the system is already running a copy of DECwindows Motif and on a system where DECwindows Motif is not running.

DECwindows Motif attempts to guarantee that sufficient resources are available by placing both MIN_ and ADD_ parameters for global pages and global sections in its NEWPARAMS.DAT file. In addition, the DECwindows Motif startup command procedure checks these values and automatically invokes AUTOGEN if the current resources are insufficient. However, under certain system loads you may find it necessary to increase these resources by placing your own ADD_ entries in MODPARAMS.DAT. Any ADD_ values you place in MODPARAMS.DAT are in addition to the values DECwindows Motif places in its NEWPARAMS.DAT file.

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.

To determine the number of contiguous free global pages and the number of free global sections, enter the WRITE command with the F$GETSYI lexical function. If possible, use this command at a time of peak load for these two resources. The following example shows how to obtain this information at your terminal, which is the default for SYS$OUTPUT:

$ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") [Return]
15848
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") [Return]
24

To determine the number of global pages required for SYS$LIBRARY:DCLTABLES.EXE, enter the following DCL command:

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

Compare your result to the values in Table 1-6 to determine whether the number of contiguous free global pages and the number of free global sections is sufficient. If your 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.

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

$ @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

If you find it necessary to adjust system parameters, use the AUTOGEN utility. 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 make incremental adjustments to parameters, such as global pages and global sections, add a line to the file and include both the name of the parameter (with the prefix ADD_) and its value. The following example increases the global pages value by 30,000:

ADD_GBLPAGES = 30000

The following list contains the system parameters that you may need to adjust incrementally.

• SYSMWCNT
• GBLSECTIONS
• GBLPAGES
• GBLPAGFIL
• NPAGEDYN
• PAGEDYN

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 - _$ HP DECwindows Motif for OpenVMS Alpha, Version 1.3-1 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.

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:

• Section 2.1, Accessing Help Information
• Section 2.2, Extracting and Printing the Product Release Notes
• Section 2.3, Installing the DECwindows Motif 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

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

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

Before you begin the installation procedure, you should read the product's release notes. To extract a copy of the HP DECwindows Motif for 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:

$ DEFINE PCSI$SOURCE DKA400:[PCSI_ALPHA_DWMOTIF131]
$ 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 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 OpenVMS Alpha CD--ROM for information about accessing the release notes and other DECwindows Motif documentation.

2.3 Installing the DECwindows Motif Software

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_DWMOTIF131]

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

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-1              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-1: DECwindows Motif

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

DECwindows Motif V1.3-1 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.5. For OSF/Motif Version 1.1.3,
only runtime support is provided.

Copyright 2003 Hewlett-Packard Development Company, L.P.

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


Hewlett-Packard Company.

This software product is sold by Hewlett-Packard Company.

This product uses the PAK: DW-MOTIF

This software is furnished under the licensing provisions of
Hewlett-Packard Company's Standard Terms and Conditions.
For more information about HP's licensing terms and policies,
contact your local HP office.