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.

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.

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

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

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.

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

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]