HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

SET SCREEN

Sets the terminal to a display of up to 511 columns. This command can be used only on HP-compatible terminals.

Format

SET SCREEN= screen-width


Parameter

screen-width

Specifies the width of the screen display. Depending on terminal type, you can specify a value up to 511.

Qualifiers

None.

Description

The SET SCREEN command redefines the width of the display to the number of columns that you specify.

If you use an initialization file in noncontinuous mode and the initialization file contains a SET SCREEN command that changes the screen size, SHOW CLUSTER sets the screen to the specified size for one update interval and then resets the screen to the original size.


Example


COMMAND> SET SCREEN=132
      

This command sets the screen width to 132 columns.

WRITE

Outputs the current display to a file that can be printed on a hardcopy device.

Format

WRITE [file-spec]


Parameter

file-spec

Names the file specification of the printable output file. By default, the output file name is SHOW_CLUSTER.LIS.

Qualifiers

/ALL

Indicates that the output file should contain a display consisting of all classes and all fields. Because SHOW CLUSTER may not currently have the information necessary to display all the possible fields when you specify the /ALL qualifier, a display update occurs prior to the output of the file. As a result, the output file may differ from the display on the screen at the time the command was entered. The screen is updated along with the file output, so subsequently they are the same.

When reporting a cluster-related problem to HP, use the /ALL qualifier to produce an output or hardcopy file.


Example


Command> WRITE/ALL
      

This command creates a file, SHOW_CLUSTER.LIS, which contains all possible SHOW CLUSTER fields. SHOW_CLUSTER.LIS can be printed on a hardcopy device.


Chapter 23
System Generation Utility

23.1 SYSGEN Description

The System Generation utility (SYSGEN) is a system management tool used to tailor a system for a specific hardware and software configuration. Use SYSGEN commands to manipulate specific parts of the operating system, as follows:

  • System parameters: DISABLE, ENABLE, SET, SHOW, USE, and WRITE.
    A complete description of devices and device drivers is in the OpenVMS VAX Device Support Manual. (This manual has been archived.)
  • System files: CREATE and INSTALL.
  • Startup command procedure: SET/STARTUP and SHOW/STARTUP.
  • Multiport memory: SHARE and SHARE/INITIALIZE.

You can use a subset of the SYSGEN commands to invoke the SYSBOOT facility during bootstrap operations. For more information, see the installation instructions for your processor and the HP OpenVMS System Manager's Manual.

23.1.1 Specifying Values for SYSGEN Qualifiers and Parameters

Normally, you specify values as an integer, keyword, or file specification. For parameters, integer values must be within the defined maximum and minimum values for the parameter unless the SYSGEN command DISABLE CHECKS was specified.

You can specify values for certain SYSGEN qualifiers and parameters in hexadecimal or octal radixes and for others as an ASCII string. To specify a value in octal or hexadecimal, precede the value with %O or %X, respectively. To specify a value in ASCII, enclose the value string in quotation marks (" ").

Appendix K lists system parameters.

23.1.2 Using Active and Current Parameter Values

System parameter values can be either active or current:

  • An active parameter is one whose value is active when the system is running. Active parameters that can be changed on a running system are categorized as dynamic parameters. (See Appendix K.)
  • A current parameter is one whose value is stored on disk (SYS$SYSTEM:ALPHAVMSSYS.PAR on Alpha systems or SYS$SYSTEM:IA64VMSSYS.PAR on Integrity server systems) and used for booting the system. Current parameters become active parameters when the system boots.

Modifying active parameters with SYSGEN has no effect on the values of the stored current parameters; you change the values of these parameters only while the system is running. In a subsequent bootstrap of the system, the old values of the current parameters are established as the active parameters. To change the values of the current parameters on disk, use the SYSGEN command WRITE CURRENT. To change the values of any active parameter that is not in the dynamic category, enter the WRITE CURRENT command and reboot the system.

23.2 SYSGEN Usage Summary

The System Generation utility (SYSGEN) is a system management tool that performs certain privileged system configuration functions. With SYSGEN, you can create and modify system parameters, load device drivers, and create additional page and swap files.


Format

RUN SYS$SYSTEM:SYSGEN


Parameters

None.

Description

To invoke SYSGEN, enter RUN SYS$SYSTEM:SYSGEN at the DCL command prompt. At the SYSGEN> prompt, enter any of the SYSGEN commands described in the following section. These commands follow the standard rules of grammar as specified in the HP OpenVMS DCL Dictionary.

To exit from SYSGEN, enter the EXIT command at the SYSGEN> prompt or press Ctrl/Z. You can direct output from a SYSGEN session to an output file using the SET/OUTPUT command. By default, output is written to SYS$OUTPUT.

Note

HP recommends the use of the AUTOGEN command procedure when modifying system parameters, loading device drivers, or creating additional page and swap files.

23.3 SYSGEN Commands

This section describes and provides examples of SYSGEN commands.

CREATE

Creates a file that can be used as a page, swap, or dump file. Normally, this command is used indirectly by executing the command procedure SYS$UPDATE:SWAPFILES.

Format

CREATE file-spec


Parameter

file-spec

The name of the file to be created.

Qualifiers

/CONTIGUOUS

/NOCONTIGUOUS

Specifies that the created file is either to be contiguous (/CONTIGUOUS) or contiguous-best-try (/NOCONTIGUOUS). The Primitive File System used during OpenVMS bootstrap limits the page, swap, and dump files to one file header. Because of this restriction, OpenVMS cannot be reliably bootstrapped from a bound volume set and is not supported on a bound volume set.

/SIZE=block-count

Specifies the size in blocks of the file to be created.

Example


SYSGEN>  CREATE DISK$PAGE:[NODE1]PAGEFILE.SYS /SIZE=200000
      

This command creates a file called PAGEFILE.SYS on the disk DISK$PAGE: in directory [NODE1]. This file is created as a contiguous-best-try file, which is the default. SYSGEN creates the file with 200,000 blocks, or allocates as many blocks on the disk as it can and displays a message warning that the file does not have the full allocation specified with the CREATE command.

The file will not be used for paging or swapping until you use the SYSGEN command INSTALL specifying the file and how it is to be used.

DEINSTALL

Deinstalls a page or swap file. Requires CMKRNL privilege. Any file installed with the SYSGEN command INSTALL can be deinstalled.

If the specified file is being actively used by processes, this command simply marks the file as "deinstall pending". This prevents any new assignments or reservations to the file from occurring. When all outstanding references to the file have been removed, the deinstallation will complete.

Files in the deinstall pending state are identified in the DCL command SHOW MEMORY/FILES display.


Format

DEINSTALL file-spec

DEINSTALL/ALL

DEINSTALL/INDEX=n


Parameter

file-spec

Specifies the name of a file that is to be deinstalled as a page or swap file.

Qualifiers

/PAGEFILE

Specifies that the file to be deinstalled is a page file.

/SWAPFILE

Specifies that the file to be deinstalled is a swap file.

/ALL

Deinstalls all page and swap files currently installed on the system. This command is most useful during an orderly system shutdown procedure where all disk volumes are being dismounted.

No other parameters or qualifiers are allowed.

/INDEX=n

Deinstalls a page or swap file specified by page file index. The page file index is presented in the DCL command SHOW MEMORY/FILES/FULL display as "Page File Number."

No other parameters or qualifiers are allowed.


Example


SYSGEN>  DEINSTALL DRA1:[SYSEXE]PAGEFILE.SYS /PAGEFILE
      

DISABLE

Inhibits the checking that SYSGEN performs on parameter values. By default, range checking is enabled.

Format

DISABLE CHECKS


Parameters

None.

Qualifiers

None.

ENABLE

Requests that SYSGEN ensure that parameter values changed using the SET command remain in the allowable range. By default, the range checking is enabled.

Format

ENABLE CHECKS


Parameters

None.

Qualifiers

None.

INSTALL

Installs an additional page or swap file. Requires CMKRNL privilege.

Format

INSTALL file-spec


Parameter

file-spec

Specifies the name of a file that is to be installed as a page or swap file. This file can reside on any volume that is mounted /SYSTEM. The file should be contiguous for best performance.

Qualifiers

/PAGEFILE

Specifies that the file is to be installed as an additional page file. This page file will augment any page file installed during the boot process.

/SWAPFILE

Specifies that the file is to be installed as an additional swap file. This swap file will augment any swap file installed during the boot process.

Example


SYSGEN>  INSTALL DRA1:[SYSEXE]PAGEFILE.SYS /PAGEFILE
      

SET

Assigns a value to a system parameter in the SYSGEN work area.

This command does not modify parameter files, the current system parameter file on disk, or the active system; for information about performing these modifications, see the WRITE command.


Format

SET parameter-name value


Parameters

parameter-name

Specifies the name of a system parameter. If you enter a period (.), it is interpreted as a request for the system parameter specified in the last SET or SHOW command. See the description of the SHOW parameter-name command for an example of the use of the period in place of a parameter name.

value

Usually specifies an integer or the keyword DEFAULT. Integer values must be within the defined minimum and maximum values for the parameter unless the SYSGEN command DISABLE CHECKS was specified.

The keyword DEFAULT specifies the default value for the parameter. You can display the maximum, minimum, and default values for any parameter with the SYSGEN command SHOW parameter-name.

You can specify values for certain SYSGEN parameters in hexadecimal or octal radixes and for others as an ASCII string. To specify a value in octal or hexadecimal, precede the value with %O or %X, respectively. To specify a value in ASCII, enclose the value string in quotation marks (" ").


Qualifiers

None.

Examples

#1

SYSGEN> SET PFCDEFAULT 20
      

This command assigns a value of 20 to the PFCDEFAULT parameter.

#2

SYSGEN> SET GBLSECTIONS DEFAULT
      

This command assigns the default value (40) to the GBLSECTIONS parameter.

SET/OUTPUT

Establishes a file to be used for output during the session. By default the output is written to SYS$OUTPUT, but you can use SET/OUTPUT to designate a disk file.

At any time you can direct the output back to SYS$OUTPUT by using the SET/OUTPUT=SYS$OUTPUT command.


Format

SET/OUTPUT[=] file-spec


Parameter

file-spec

The name of the output file. The default file type is .LIS. The equal sign (=) is optional.

Example


SYSGEN>  SET/OUTPUT=PARAMS.LIS
SYSGEN>  SHOW/ALL
SYSGEN>  SHOW/SPECIAL
SYSGEN>  EXIT
      

In this example, output is directed to the file PARAMS.LIS to capture a complete list of all the system parameters (including the SPECIAL parameters reserved for HP use) and their values.

SET/STARTUP

Names the site-independent startup command procedure to be associated with a parameter file for subsequent bootstrap operations.

Format

SET/STARTUP file-spec


Parameter

file-spec

The file specification of a startup command procedure on the system disk (maximum of 31 characters). The initial site-independent startup command procedure (as named in the software distribution kit) is SYS$SYSTEM:STARTUP.COM.

Example


SYSGEN>  SET/STARTUP SYS$SYSTEM:XSTARTUP.COM
      

This command assigns SYS$SYSTEM:XSTARTUP.COM as the current site-independent startup command procedure.

SHOW

Displays the values of system parameters in the SYSGEN work area, plus the default, minimum, and maximum values of the parameters and their units of measure.

Format

SHOW parameter-name


Parameter

parameter-name

Specifies the name of a system parameter. If you enter a period (.), it is interpreted as a request for the system parameter specified in the last SET parameter-name or SHOW parameter-name command.

Beginning in OpenVMS Version 8.2, specifies OBSOLETE in the Units column for any specified parameter that is obsolete.


Qualifiers

/ACP

Specifies that all ACP parameter values are displayed.

/ALL

Specifies that all parameter values other than SPECIAL parameter values are displayed.

/BI

Specifies that device addresses that are currently mapped in the I/O space for the VAXBI bus are displayed.

/CLUSTER

Specifies that all CLUSTER parameter values are displayed.

/DYNAMIC

Specifies that all DYNAMIC parameter values are displayed.

/GEN

Specifies that all GEN parameter values are displayed.

/HEX

Specifies that the values of parameters be displayed in hexadecimal representation. Specify the /HEX system parameter name or the parameter type. If you specify the /HEX qualifier with the /NAMES qualifier, /HEX is ignored.

/JOB

Specifies that all JOB parameter values are displayed.

/LGI

Specifies that all LGI parameter values are displayed.

/MAJOR

Specifies that all MAJOR parameter values are displayed.

/MULTIPROCESSING

Specifies that all MULTIPROCESSING parameters are displayed.

/NAMES

Specifies that the names of all parameters are displayed.

/OBSOLETE

Specifies that the names of all obsolete parameters are displayed.

/PQL

Specifies that all PQL parameter values are displayed.

/RMS

Specifies that all RMS parameter values are displayed.

/SCS

Specifies that all SCS parameter values are displayed.

/SPECIAL

Specifies that all parameter values reserved for HP use are displayed.

/STARTUP

Specifies that the name of the current site-independent startup command procedure is displayed.

/SYS

Specifies that all SYS parameter values are displayed.

/TTY

Specifies that all terminal parameter values are displayed.

/XMI[=BIindex]

Specifies that device addresses that are currently mapped in the I/O space for the XMI bus are displayed. The /XMI qualifier also displays node and nexus numbers and generic names of all processors, adapters, VAXBI adapters, memory controllers, and interconnection devices such as the NI.

Use of the SHOW/XMI=BIindex command requires the CMEXEC privilege.


Description

Parameter values are displayed in decimal unless the /HEX qualifier is specified. Note that ASCII values are displayed in ASCII by default.

When parameter names are abbreviated on a VAX platform, the first parameter matching the abbreviation is selected for display. No ambiguity checks are made. On an Alpha or Integrity servers platform, all parameters whose names match the abbreviation are printed.

For example, a specification of SHOW GBL on a VAX system displays only the GBLSECTIONS parameter. To display the GBLPAGFIL parameter, you must specify SHOW GBLPAGF (to avoid further ambiguity with the GBLPAGES parameter). On an Alpha or Integrity servers, the same SHOW GBL command displays GBLSECTIONS, GBLPAGES, and GBLPAGFIL.

You can enter a period (.) to indicate that you want to work with the system parameter that was specified in the last SET parameter-name or SHOW parameter-name command.


Examples

#1

SYSGEN> SHOW GBLSECTIONS
 
 


 
  
 
  
 
Parameter Name            Current   Default   Minimum   Maximum Unit  Dynamic 
GBLSECTIONS                   100        40        20        -1 Sections 
 
SYSGEN> SET . 110 
 
SYSGEN> SHOW . 
 
Parameter Name            Current   Default   Minimum   Maximum Unit  Dynamic 
GBLSECTIONS                   110        40        20        -1 Sections 

In this example, the user first displays the values of the GBLSECTIONS parameter and then refers to the parameter with a period to set its current value to 110. The next SHOW command also uses the period notation to obtain confirmation that the change occurred.

#2

SYSGEN> SHOW/ACP
      

On a VAX system, the command in this example produces the following output:


Parameters in use: Active 
Parameter Name             Current   Default   Minimum   Maximum Unit  Dynamic 
ACP_MULTIPLE                     0         1         0         1 Boolean     D 
ACP_SHARE                        1         1         0         1 Boolean 
ACP_MAPCACHE                    52         8         1        -1 Pages       D 
ACP_HDRCACHE                   138       128         2        -1 Pages       D 
ACP_DIRCACHE                   138        80         2        -1 Pages       D 
ACP_DINDXCACHE                  37        25         2        -1 Pages       D 
ACP_WORKSET                      0         0         0        -1 Pages       D 
ACP_FIDCACHE                    64        64         0        -1 File-Ids    D 
ACP_EXTCACHE                    64        64         0        -1 Extents     D 
ACP_EXTLIMIT                   300       300         0      1000 Percent/10  D 
ACP_QUOCACHE                   130        64         0        -1 Users       D 
ACP_SYSACC                       4         8         0        -1 Directories D 
ACP_MAXREAD                     32        32         1        64 Blocks      D 
ACP_WINDOW                       7         7         1        -1 Pointers    D 
ACP_WRITEBACK                    1         1         0         1 Boolean     D 
ACP_DATACHECK                    2         2         0         3 Bit-mask    D 
ACP_BASEPRIO                     8         8         4        31 Priority    D 
ACP_SWAPFLGS                    14        15         0        15 Bit-mask    D 
ACP_XQP_RES                      1         1         0         1 Boolean 
ACP_REBLDSYSD                    0         1         0         1 Boolean  
 
 
#3

SYSGEN> SHOW/ACP/HEX
      

The command in this example produces a hexadecimal display of the values of the ACP system parameters, as follows:


Parameters in use: Active 
Parameter Name             Current   Default   Minimum   Maximum Unit  Dynamic 
ACP_MULTIPLE              00000000  00000001  00000000  00000001 Boolean     D 
ACP_SHARE                 00000001  00000001  00000000  00000001 Boolean 
ACP_MAPCACHE              00000034  00000008  00000001  FFFFFFFF Pages       D 
ACP_HDRCACHE              0000008A  00000080  00000002  FFFFFFFF Pages       D 
ACP_DIRCACHE              0000008A  00000050  00000002  FFFFFFFF Pages       D 
ACP_DNDXCACHE             00000025  00000019  00000002  FFFFFFFF Pages       D 
ACP_WORKSET               00000000  00000000  00000000  FFFFFFFF Pages       D 
ACP_FIDCACHE              00000040  00000040  00000000  FFFFFFFF File-Ids    D 
ACP_EXTCACHE              00000040  00000040  00000000  FFFFFFFF Extents     D 
ACP_EXTLIMIT              0000012C  0000012C  00000000  000003E8 Percent/10  D 
ACP_QUOCACHE              00000082  00000040  00000000  FFFFFFFF Users       D 
ACP_SYSACC                00000004  00000008  00000000  FFFFFFFF Directories D 
ACP_MAXREAD               00000020  00000020  00000001  00000040 Blocks      D 
ACP_WINDOW                00000007  00000007  00000001  FFFFFFFF Pointers    D 
ACP_WRITEBACK             00000001  00000001  00000000  00000001 Boolean     D 
ACP_DATACHECK             00000002  00000002  00000000  00000003 Bit-mask    D 
ACP_BASEPRIO              00000008  00000008  00000004  0000001F Priority    D 
ACP_SWAPFLGS              0000000E  0000000F  00000000  0000000F Bit-mask    D 
ACP_XQP_RES               00000001  00000001  00000000  00000001 Boolean 
ACP_REBLDSYSD             00000000  00000001  00000000  00000001 Boolean 
#4

SYSGEN> SHOW/PQL
      

On an Alpha or Integrity server, the command in this example produces output similar to the following:


 
Parameters in use: Active 
Parameter Name            Current    Default     Min.     Max.     Unit  Dynamic 
--------------            -------    -------    -------  -------   ----  ------- 
PQL_DASTLM                     24         24        -1        -1 Ast        D 
PQL_MASTLM                      4          4        -1        -1 Ast        D 
PQL_DBIOLM                     32         32        -1        -1 I/O        D 
PQL_MBIOLM                      4          4        -1        -1 I/O        D 
PQL_DBYTLM                  65536      65536        -1        -1 Bytes      D 
PQL_MBYTLM                   1024       1024        -1        -1 Bytes      D 
PQL_DCPULM                      0          0        -1        -1 10Ms       D 
PQL_MCPULM                      0          0        -1        -1 10Ms       D 
PQL_DDIOLM                     32         32        -1        -1 I/O        D 
PQL_MDIOLM                      4          4        -1        -1 I/O        D 
PQL_DFILLM                    128        128        -1        -1 Files      D 
PQL_MFILLM                      2          2        -1        -1 Files      D 
PQL_DPGFLQUOTA              65536      65536        -1        -1 Pagelets   D 
 internal value              4096       4096         0        -1 Pages      D 
PQL_MPGFLQUOTA               2048       2048        -1        -1 Pagelets   D 
 internal value               128        128       128        -1 Pages      D 
PQL_DPRCLM                     32         32        -1        -1 Processes  D 
PQL_MPRCLM                      0          0        -1        -1 Processes  D 
PQL_DTQELM                     16         16        -1        -1 Timers     D 
PQL_MTQELM                      0          0        -1        -1 Timers     D 
PQL_DWSDEFAULT               2000       2000        -1        -1 Pagelets 
 internal value               125        125         0        -1 Pages 
PQL_MWSDEFAULT               2000       2000        -1        -1 Pagelets 
 internal value               125        125       125        -1 Pages 
PQL_DWSQUOTA                 4000       4000        -1        -1 Pagelets   D 
 internal value               250        250         0        -1 Pages      D 
PQL_MWSQUOTA                 4000       4000        -1        -1 Pagelets   D 
 internal value               250        250       250        -1 Pages      D 
PQL_DWSEXTENT               12000      12000        -1        -1 Pagelets   D 
 internal value               750        750         0        -1 Pages      D 
PQL_MWSEXTENT                4000       4000        -1        -1 Pagelets   D 
 internal value               250        250       250        -1 Pages      D 
PQL_DENQLM                     64         64        -1        -1 Locks      D 
PQL_MENQLM                      4          4        -1        -1 Locks      D 
PQL_DJTQUOTA                 1024       1024        -1        -1 Bytes      D 
PQL_MJTQUOTA                    0          0        -1        -1 Bytes      D  
 
 


Previous Next Contents Index