Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

This command connects the device named LPA0 to the driver named LP2DRIVER and loads the driver if it is not already loaded.

#2
    SYSGEN> CONNECT NET/NOADAPTER/DRIVER=NETDRIVER

> This command connects the device named NET to the driver NETDRIVER and loads the driver if it is not already loaded.

## 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). You must specify /NOCONTIGUOUS, which is the default, if you are creating a secondary page or swap file that spans volumes in a 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

## LOAD (VAX Only)

> On VAX systems, loads an I/O driver. On Alpha systems, use the SYSMAN command IO LOAD.

> Use of the LOAD command requires the CMKRNL privilege.

> Note Be very careful when issuing a LOAD command because the system does little error-checking.

### Format

> LOAD file-spec

### Parameter

> #### file-spec

> Specifies the file specification of the driver image to be loaded. This parameter is required.

> If the entire file specification is the same as that of a driver already loaded, no load takes place. If only the file name is the same as that of a driver already loaded (but the file specification is different), the driver specified replaces the driver previously specified; that is, the existing driver.

> The default file type is .EXE.

### Description

> Refer to the OpenVMS VAX Device Support Manual for a complete description of the LOAD command. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)

### Example

    SYSGEN>  LOAD SYS$SYSTEM:RTTDRIVER

> This command loads the standard driver for a remote terminal.

## RELOAD (VAX Only)

> On VAX systems, replaces a loaded device driver with a new version.

> Use of the RELOAD command requires the CMKRNL privilege.

### Format

> RELOAD file-spec

### Parameter

> #### file-spec

> The file specification of the new driver image. The default file type is .EXE. The specified image is loaded and replaces any existing driver with the same file specification.

### Qualifiers

> None.

### Description

> Refer to the OpenVMS VAX Device Support Manual for a complete description of the RELOAD command. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)

### Example

    SYSGEN>  RELOAD SYS$SYSTEM:RTTDRIVER

> This command reloads the remote terminal driver.

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

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

## SHARE (VAX Only)

> On VAX systems, connects a processor to a multiport memory unit already initialized by this or another processor. The number and name of the specified multiport memory unit must be those of an initialized unit, or an error condition results.

> Use of the SHARE command requires the CMKRNL privilege.

### Format

> SHARE MPMn MPM-name

### Parameters

> #### MPMn

> Specifies the number on the front panel of the multiport memory unit being connected.

> #### MPM-name

> Specifies the name of the multiport memory unit as indicated in a previous SHARE/INITIALIZE command.

### Qualifiers

> #### /MAXCEFCLUSTERS=max-cef

> Specifies the maximum number of common event flag clusters that the processor can create in the multiport memory unit. The default is no limit.

> #### /MAXGBLSECTIONS=max-gbl

> Specifies the maximum number of global sections that the processor can create in the multiport memory unit. The default is no limit.

> #### /MAXMAILBOXES=max-mail

> Specifies the maximum number of mailboxes the processor can create in the multiport memory unit. The default is no limit.

### Example

    SYSGEN>  SHARE MPM1 SHR_MEM_1

> This command connects a multiport memory unit. Because no qualifiers are specified, defaults apply to all the parameters.

> The unit with a 1 on the front panel must be initialized with the name SHR_MEM_1 for the command to work.

## SHARE/INITIALIZE (VAX Only)

> On VAX systems, initializes a multiport memory unit and connects it to the processor on which SYSGEN is running.

> Use of the SHARE/INITIALIZE command requires the CMKRNL privilege.

### Format

> SHARE/INITIALIZE MPMn MPM-name

### Parameters

> #### MPMn

> Specifies the number on the front panel of the multiport memory unit being connected.

> #### MPM-name

> Specifies the name by which the multiport memory unit is to be known to systems using it. The MPM-name is a 1 to 15 alphanumeric character string that may contain dollar signs ($) and underscores (_).

### Qualifiers

> #### /CEFCLUSTERS=cef

> Specifies the total number of common event flag clusters permitted in the multiport memory unit. The cef value is an integer with a default of 32.

> #### /GBLSECTIONS=gbl

> Specifies the total number of global sections permitted in the multiport memory unit. The gbl value is an integer with a default of 32.

> #### /MAILBOXES=mail

> Specifies the total number of mailboxes permitted in the multiport memory unit. The mail value is an integer with a default of 32.

> #### /MAXCEFCLUSTERS=max-cef

> Specifies the maximum number of common event flag clusters that the processor can create in the multiport memory unit. The default is no limit.

> #### /MAXGBLSECTIONS=max-gbl

> Specifies the maximum number of global sections that the processor can create in the multiport memory unit. The default is no limit.

> #### /MAXMAILBOXES=max-mail

> Specifies the maximum number of mailboxes the processor can create in the multiport memory unit. The default is no limit.

> #### /POOLBCOUNT=block-cnt

> Specifies the number of blocks allocated to the multiport memory unit's dynamic pool. The block-cnt value is an integer with a default of 128.

> #### /POOLBSIZE=block-size

> Specifies the size of each block in the dynamic pool. The block-size value is an integer with a default of 128 bytes.

> #### /PRQCOUNT=prq-cnt

> Specifies the number of interprocessor request blocks (PRQs) allocated. The prq-cnt value is an integer with a default of 64.

### Description

> If the specified multiport memory unit is already initialized and connected to other active processors, the gbl, mail, cef, block-cnt, block-size, and prq-cnt parameter values are ignored, and the unit is simply connected to the processor.

### Example

    SYSGEN>  SHARE MPM1 SHR_MEM_1/INITIALIZE -
    SYSGEN>  /GBLSECTIONS=128/MAILBOXES=64/CEFCLUSTERS=0

> This command initializes a multiport memory unit with defaults on all but the gbl, mail, and cef parameters. In this example, assume that the number of the multiport memory unit as it appears on the front panel is 1, and the unit name is SHR_MEM_1.

## SHOW [parameter]

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

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

> #### /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 Compaq 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 platform, all parameters whose names match the abbreviation will be printed.

> For example, a specification of SHOW GBL on a VAX 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, the same SHOW GBL command will display 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] command.

###

#### Examples

#1

    SYSGEN> SHOW GBLSECTIONS

    GBLSECTIONS           100        40        20        -1  Sections
    SYSGEN> SET . 110
    SYSGEN> SHOW .
    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 system, the command in this example produces the following output:

>     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

| privacy and legal statement |
6048PRO_062.HTML