|
HP OpenVMS Systems Documentation |
|
HP DECwindows Motif for OpenVMS
|
| Previous | Contents | Index |
This section explains how to use the System Generation utility (SYSGEN) and the AUTOGEN utility to adjust your system for DECwindows Motif. The AUTOGEN utility uses system configuration data to automatically set system parameters.
The DECwindows Motif startup procedure automatically checks for required system parameter values and passes the appropriate values to AUTOGEN via NEWPARAMS.DAT. Therefore, in most cases you do not have to check and modify these values manually as described in the following sections. These sections provide procedures to use if you find it necessary to increase a system resource beyond the values normally specified by DECwindows Motif. |
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 parameters with the SHOW command, enter the EXIT command
at the SYSGEN prompt to return to DCL level.
3.5.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.
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.
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
|
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 workload.
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
HP OpenVMS System Manager's Manual and the AUTOGEN section in HP OpenVMS System Management Utilities Reference Manual. For more
information about performance tuning in general, see the OpenVMS
Performance Management manual.
3.5.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 |
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 HP OpenVMS System Manager's Manual and the AUTOGEN section in HP OpenVMS System Management Utilities Reference Manual.
After you install the DECwindows Motif 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 HP DECwindows Motif for OpenVMS Management Guide and HP DECwindows Motif for OpenVMS New Features for additional system management information.
The following topics are discussed in this chapter:
The DECwindows X display server manages the graphics devices on your workstation, such as the screen, keyboard, and mouse. The initial startup command procedures determine most of the configuration parameters for the DECwindows X11 Display Server automatically. However, the command procedures cannot determine some items, such as the layout of the keyboard, appropriate network transport, or which X server extensions to enable (such as, XINERAMA, SECURITY, or XKB).
You can specify additional display server settings by modifying the server startup file as follows:
$ @SYS$MANAGER:DECW$STARTUP RESTART |
If you previously chose not to install or if you removed the DECwindows
base-support software, use the PRODUCT RECONFIGURE command to
reconfigure the operating system and specifying that you want
DECwindows Motif support.
4.3 Determining and Reporting Problems
If you encounter a problem while using DECwindows Motif, report it to HP. Review the related 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:
This appendix contains sample DECwindows Motif installation procedures for the OpenVMS I64 Version 8.2 and OpenVMS Alpha Version 8.2 operating systems.
Refer to Chapter 2 for details about using the POLYCENTER Software Installation utility to install DECwindows Motif software.
These sample procedures assume that you have set the default directory
to the device name and directory containing the DECwindows Motif PCSI kit
as well as any necessary ECOs.
A.1 Sample PCSI Installation on an OpenVMS I64 System
Example A-1 contains a sample of the DECwindows Motif software installation on an OpenVMS I64 operating system.
| Example A-1 Sample Installation of the DECwindows Motif Software on an OpenVMS I64 Version 8.2 System |
|---|
$ PRODUCT INSTALL DWMOTIF [Return]
The following product has been selected:
HP I64VMS DWMOTIF V1.5 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.
HP I64VMS DWMOTIF V1.5: DECwindows Motif
(c) Copyright 2004 Hewlett-Packard Development Company, L.P.
Hewlett-Packard Company.
This software product is sold by Hewlett-Packard Company.
DECwindows Motif is license-managed using the License Management Facility.
Do you want the defaults for all options? [YES] [Return]
If a 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]
HP I64VMS DWMOTIF V1.5: DECwindows Motif
HP I64VMS VMS V8.2 [Installed]
Install Low Bandwidth X (LBX) Support: YES
Install the DECwindows Motif Version 1.5 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
Are you satisfied with these options? [YES] [Return]
Execution phase starting ...
The following product will be installed to destination:
HP I64VMS DWMOTIF V1.5 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:
HP I64VMS DWMOTIF V1.5 Layered Product
HP I64VMS DWMOTIF V1.5: DECwindows Motif
System reboot is required.
Installation Verification Procedure can be run after reboot.
$ Logout [Return]
|
Example A-2 contains a sample of the DECwindows Motif software installation on an OpenVMS Alpha operating system.
| Example A-2 Sample Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 8.2 System |
|---|
$ PRODUCT INSTALL DWMOTIF [Return]
The following product has been selected:
DEC AXPVMS DWMOTIF V1.5 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.5: DECwindows Motif
(c) Copyright 2004 Hewlett-Packard Development Company, L.P.
Hewlett-Packard Company
This product uses the PAK: DW-MOTIF
Do you want the defaults for all options? [YES] [Return]
If a 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.5: DECwindows Motif
DEC AXPVMS VMS V8.2 [Installed]
Install Low Bandwidth X (LBX) Support: YES
Install the DECwindows Motif Version 1.5 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]
Execution phase starting ...
The following product will be installed to destination:
DEC AXPVMS DWMOTIF V1.5 DISK$2:[VMS$COMMON.]
The following product will be removed from destination:
DEC AXPVMS DWMOTIF V1.3-1 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.5 Layered Product
The following product has been removed:
DEC AXPVMS DWMOTIF V1.3-1 Layered Product
DEC AXPVMS DWMOTIF V1.5: DECwindows Motif
System reboot is required.
Installation Verification Procedure can be run after reboot.
$ Logout [Return]
|
Once you have installed DECwindows Motif, 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 sample output from this command.
OBJECT OBJECT TYPE STATUS ------ ----------- ------ [000000] directory OK [000000]DEC-AXPVMS-DWMOTIF-V0105.PCSI$DESCRIPTION file OK [000000]DEC-AXPVMS-DWMOTIF-V0105.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 . . . |
At times you may need to verify the combination of software components and versions that are installed on a particular system. Use one or more of the following command procedures (available from the SYS$UPDATE directory) to check the versions of layered product images currently installed on your system:
To display the versions of DECwindows images currently installed, enter the following command:
$ @SYS$UPDATE:DECW$VERSIONS * |
The output from the command shows the image ident (DW), the version number, and the date the image was created. For example, the following result:
DW V1.5-040312 |
shows the DECwindows Motif client (DW) image is at version 1.5 and was created on March 12, 2004.
| Index | Contents |