Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

## PARAMETERS SHOW

> Displays the value of a parameter or a group of parameters in the work area. In addition, the command shows the minimum, maximum, and default values of a parameter and its unit of measure.

### Format

> PARAMETERS SHOW [parameter-name]

### Parameter

> #### parameter-name

> Specifies the name of a parameter or a period (.). A period is interpreted as a request for the parameter specified in the last PARAMETERS SET or PARAMETERS SHOW command. The parameter name can be abbreviated, but the abbreviation must be unique because SYSMAN selects the first parameter that matches.

### Qualifiers

> #### /ACP

> Displays all Files--11 ACP parameters.

> #### /ALL

> Displays the values of all active parameters.

> #### /CLUSTER

> Displays all parameters specific to clusters.

> #### /DYNAMIC

> Displays all parameters that would be in effect immediately after you enter a PARAMETERS WRITE ACTIVE command.

> #### /GEN

> Displays all general parameters.

> #### /HEX

> Displays numeric parameters in hexadecimal rather than decimal radix. Specify the /HEX system parameter name or the parameter type. If you specify the /HEX qualifier with the /NAMES qualifier, /HEX is ignored.

> #### /JOB

> Displays all job controller parameters.

> #### /LGI

> Displays all LOGIN security control parameters.

> #### /MAJOR

> Displays the most important parameters.

> #### /MULTIPROCESSING

> Displays parameters specific to multiprocessing.

> #### /NAMES

> Displays only parameter names. You can combine other qualifiers with this one.

> #### /OUTPUT

> Directs output to the specified file rather than SYS$OUTPUT. Without a file specification, the output goes to SYSMAN.LIS in the current directory.

> #### /PAUSE

> Controls the rate at which the system displays information about parameters.

> #### /PQL

> Displays the parameters for all default process quotas.

> #### /RMS

> Displays all parameters specific to OpenVMS Record Management Services (RMS).

> #### /SCS

> Displays all parameters specific to OpenVMS Cluster System Communications Services.

> #### /SPECIAL

> Displays all special control parameters.

> #### /STARTUP

> Displays the name of the site-independent startup procedure.

> #### /SYS

> Displays all active system parameters.

> #### /TTY

> Displays all parameters for terminal drivers.

### Description

> SYSMAN displays parameters in decimal unless you specify the /HEX qualifier. ASCII values are always displayed in ASCII.

> Abbreviations for parameter names must be unique because SYSMAN displays the first parameter matching the abbreviation. Ambiguity checks do not occur. For example, a specification of PARAMETERS SHOW GBL displays the GBLSECTIONS parameter. To display the GBLPAGFIL parameter, you must specify PARAMETERS SHOW GBLPAGF to avoid displaying the GBLPAGES parameter.

> You can use a period (.) to indicate that you want to work with the system parameter that you specified in the last PARAMETERS SET or PARAMETERS SHOW command.

### Examples

#1
    SYSMAN> PARAMETERS SHOW GBLSECTIONS
    Parameter Name    Current   Default   Minimum     Maximum Unit  Dynamic
    GBLSECTIONS           100        40        20     -1  Sections

    SYSMAN> PARAMETERS SET . 110
    SYSMAN> PARAMETERS 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 PARAMETERS SHOW command also uses the period notation to obtain confirmation that the change occurred.

#2
    SYSMAN> PARAMETERS SHOW/ACP

> This command produces output similar to the following example:

>     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_REBLDSYS                0         1         0         1 Boolean

#3
    SYSMAN> PARAMETERS SHOW/ACP/HEX

> This command produces a hexadecimal display of the values of the ACP system parameters.

>     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_REBLDSYS         00000000  00000001  00000000  00000001 Boolean

#4
    SYSMAN> PARAMETERS SHOW/STARTUP
    Startup command file = SYS$SYSTEM:STARTUP.COM

> This command displays the name of the site-independent startup command procedure.

    SYSMAN> PARAMETERS SHOW/PAUSE MAXPROCESSCNT

    Node EXPERT:   Parameters in use: ACTIVE

    Parameter Name         Current    Default    Minimum    Maximum Unit  Dynamic
    --------------         -------    -------    -------    ------- ----  -------
    MAXPROCESSCNT              160         32         12       8192 Processes

    Press return to continue [Return]

    Node MODERN:   Parameters in use: ACTIVE

    Parameter Name         Current    Default    Minimum    Maximum Unit  Dynamic
    --------------         -------    -------    -------    ------- ----  -------
    MAXPROCESSCNT              157         32         12       8192 Processes

    Press return to continue [Return]

    Node IMPOSE:   Parameters in use: ACTIVE

    Parameter Name         Current    Default    Minimum    Maximum Unit  Dynamic
    --------------         -------    -------    -------    ------- ----  -------
    MAXPROCESSCNT               50         32         12       8192 Processes

    Press return to continue [Return]

.
.
.

The command in this example allows you to control the rate at which the information is displayed.

## PARAMETERS USE

> Reads a set of system parameters into the work area for display or modification.

### Format

> PARAMETERS USE source

### Parameter

> #### source

> The source of a system parameter file for data to be read into the work area. The source can be any of the following items:

ACTIVE | Read parameters from memory. When you invoke SYSMAN, active values are in effect.
CURRENT | Read parameters from the default system parameter file, which is the source for parameters when you boot the system. Using the current parameters requires read (R) access to the system parameters file. On Alpha systems, the file that contains current parameters is SYS$SYSTEM:ALPHAVMSSYS.PAR. On VAX systems, the file that contains current parameters is SYS$SYSTEM:VAXVMSSYS.PAR.
filespec | Read parameters from a previously created system parameter file. The default file type is .PAR. You need read access to the file.
DEFAULT | Read a parameter set containing the default values for all parameters. These values are supplied with the operating system.

### Qualifiers

> None.

### Description

> Depending on the source you enter with the command, PARAMETERS USE activates the parameter values:
> - Stored in memory (ACTIVE)
> - Stored in the default boot parameter file (CURRENT)
> - From another file (filespec)
> - From the system default values (DEFAULT)

### Example

    SYSMAN> PARAMETERS USE DEFAULT
    SYSMAN> SET STARTUP_P1 "MIN"

> The first command activates the default parameter values that are supplied with the operating system. The second command sets the STARTUP_P1 system parameter to "minimum." This avoids starting all layered products on a system that is not tuned for them, which might cause the system to hang.

## PARAMETERS WRITE

> Writes the contents of the work area to memory, to disk, or to a file, depending on the destination that you specify.

### Format

> PARAMETERS WRITE destination

### Parameter

> #### destination

> The destination of a new parameter file can be any of the following ones:

ACTIVE | Write parameters to memory. Using the ACTIVE parameter requires CMKRNL privilege.
CURRENT | Write parameters to the system parameters file, which contains the current parameters on disk. Using the current parameter requires write (W) access to the system parameters file. On Alpha systems, the file that contains current parameters is SYS$SYSTEM:ALPHAVMSSYS.PAR. On VAX systems, the file that contains current parameters is SYS$SYSTEM:VAXVMSSYS.PAR.
filespec | Write parameters to a file. The default file type is .PAR and you need write access to the file.

### Qualifiers

> None.

### Description

> The PARAMETERS WRITE command writes the system parameter values and the name of the site-independent startup command procedure from the work area to the active system in memory, the current system parameter file on disk, or your choice of a parameter file. You can write only dynamic parameter values to the active system.

> Both the PARAMETERS WRITE ACTIVE and PARAMETERS WRITE CURRENT commands send a message to OPCOM to record the event.

### Examples

#1
    SYSMAN> PARAMETERS WRITE SYS$SYSTEM:SPECIAL

> This command creates a new parameter specification file.

#2
    SYSMAN> PARAMETERS WRITE CURRENT

> This command modifies the current system parameter file on disk (SYS$SYSTEM:ALPHAVMSSYS.PAR).

## RESERVED_MEMORY ADD (Alpha Only)

> On Alpha systems, adds an entry to the Reserved Memory Registry data file. (However, changes and additions to this file do not take effect until the next reboot of the system.) You can also use RESERVED_MEMORY ADD qualifiers to reserve a block of contiguous page frame numbers (PFNs).

> For information about the Reserved Memory Registry, refer to the OpenVMS Alpha Guide to 64-Bit Addressing and VLM Features.

### Format

> RESERVED_MEMORY ADD gs_name

### Parameter

> #### gs_name

> Name of the memory-resident global section associated with this reserved memory. You must specify a name.

### Qualifiers

> #### /ALLOCATE

> #### /NOALLOCATE (default)

> Allocates contiguous, aligned pages during the next reboot of the system. The allocated memory is deducted from the system's fluid page count, and the creation of the memory-resident global section results in the use of the allocate option. The physical alignment of the pages is based on the maximum granularity hint factor that can be used to map the pages depending on the size of the reserved memory.

> Possible granularity hint factors are 512 pages (or 4 MB) and 64 pages (or 512 KB). Therefore, assuming an 8 KB system page size, reserved memory is physically aligned as follows:

> - size >= 4 MB: physically aligned on a 4 MB boundary
> - size < 4 MB: physically aligned on a 512 KB boundary

> /NOALLOCATE implies /NOZERO because /ZERO is incompatible with /NOALLOCATE. If you specify /NOALLOCATE, or do not specify /ALLOCATE, reserved memory is not allocated during the next reboot of the system. Reserved memory is deducted only from the system's fluid page count, and the creation of the memory-resident global section results in the use of the fault option.

> #### /GLOBAL_SECTION (default)

> #### /NOGLOBAL_SECTION

> /NOGLOBAL_SECTION indicates that the memory qualifier is for a privileged application instead of a group or system global section. (/GLOBAL_SECTION indicates that the memory qualifier is for a group or system global section.) You cannot use /NOGLOBAL_SECTION with the qualifiers /GROUP, /SYSGBL, or /PAGE_TABLES.

> AUTOGEN processes the Reserved Memory Registry data file in its GETDATA phase. The size of all entries is taken into account when calculating system parameters that depend on the available amount of physical memory.

> The reservation size is also used to calculate the initial size of the global page table unless the entry was specified as /NOGLOBAL_SECTION.

> #### /GROUP=n

> Establishes that the reserved memory is for a group global section. The value n specifies the UIC group number (in octal) of the process that creates the group global section. Only processes within the creator's UIC group number are allowed access to the global section. For example, if a process with the UIC of [6,100] is the creator of the group global section, the group number for the /GROUP qualifier is 6.

> You cannot use the /GROUP qualifier with either /SYSGBL or /NOGLOBAL_SECTION qualifiers.

> #### /PAGE_TABLES (default)

> #### /NOPAGE_TABLES

> Reserves additional memory for shared page tables. When the memory-resident global section is created, shared page tables are created for the global section. If you do not specify /ALLOCATE (or if you specify /NOALLOCATE), the additional reserved memory is deducted only from the system's fluid page count. If you specify /ALLOCATE, additional contiguous, during the next reboot of the system, aligned pages are allocated for the shared page table, and the additional reserved memory is deducted from the system's fluid page count.

> If you do not specify /PAGE_TABLES, or if you specify /NOPAGE_TABLES, additional memory is not reserved for shared page tables. When the memory-resident global section is created, shared page tables are not created for the global section.

> #### /SIZE=[size of reserved memory, unit: MB]

> Specifies the number of megabytes to be deducted from the system's fluid page count for this memory-resident global section when the VMS$RESERVED_MEMORY.DATA data file is read during system initialization.

> #### /SYSGBL

> Indicates that a reservation is for a system global memory-resident section.

> You cannot combine this qualifier with the /GROUP or /NOGLOBAL_SECTION qualifier. This qualifier is the default unless you specify /GROUP or /NOGLOBAL_SECTION.

> #### /ZERO

> #### /NOZERO (default)

> /ZERO implies /ALLOCATE. If you specify /ZERO, pre-allocated pages are zeroed during system initialization. Zeroed pages are required for memory-resident global sections; however, the pages do not need to be zeroed during system initialization.

> /NOALLOCATE implies /NOZERO because /ZERO is incompatible with /NOALLOCATE. If you do not specify /ZERO, or if you specify /NOZERO, pre-allocated pages are not zeroed during system initialization. Instead, these pages are zeroed when the global section is created.

### Description

> OpenVMS allows you to reserve non-fluid memory for use within a memory-resident global demand-zero section. The reserved memory can either be simply a deduction for the system's non-fluid memory size or be pre-allocated as contiguous, aligned physical pages.

> Using the Reserved Memory Registry ensures that AUTOGEN tunes the system properly not to include memory-resident section pages in its calculation of the system's fluid page count. AUTOGEN sizes the system page file, the number of process, and the working set maximum size based on the system's fluid page count. A system can experience severe performance problems if AUTOGEN adjusts parameters based on a fluid page count that does not account for the physical memory that is permanently reserved for some other purpose.

> Using the Reserved Memory Registry also ensures that contiguous, aligned memory is available for memory-resident sections when the allocate option is used.

> Users of reserved, non-fluid memory enter the characteristics of the memory into a data file that is read during the system initialization (boot-time). The file is called SYS$SYSTEM:VMS$RESERVED_MEMORY.DATA, and you use the SYSMAN utility to maintain it.

> Note Do not, however, edit the data file SYS$SYSTEM:VMS$RESERVED_MEMORY.DATA.

> VMS$RESERVED_MEMORY.DATA is read during system initialization. For each entry in this data file, the number of megabytes is deducted from the system's fluid page count for this memory-resident global section as specified by the /SIZE qualifier on the RESERVED_MEMORY ADD command. If /PAGE_TABLES was specified, the amount of memory required for the shared page tables mapping the memory-resident global section is deducted from the system's fluid page count as well.

> The following table summarizes the effects of qualifiers on the RESERVED_MEMORY ADD command:

> Qualifier | Effect
> --- | ---
> /ALLOCATE | A contiguous block of physical pages is also allocated and set aside for the memory-resident global section.
> /PAGE_TABLES | An additional contiguous block of physical pages is allocated and set aside for the shared page tables. The pages have a physical alignment appropriate to use the largest granularity hint factor for the block.
> /ZERO | The pages are zeroed during system initialization or when the system is idle.
> /NOZERO | The pages are zeroed when the memory-resident global section is created.

> If you set the system parameter STARTUP_P1 to "MIN", entries in the Reserved Memory Registry are ignored, and memory is not reserved.

> During system initialization while processing the Reserved Memory Registry data file, if the system encounters errors reserving fluid pages or allocating contiguous, aligned physical pages, it issues a warning to the console, and the system continues to boot; the request, however, is not granted.

### Example

    SYSMAN> RESERVED_MEMORY ADD DFW$GS_1 /NOPAGE /GROUP=100 /SIZE=1
    SYSMAN> RESERVED_MEMORY ADD DFW$GS_2 /PAGE /SIZE=2 /ALLOC /ZERO
    SYSMAN> RESERVED_MEMORY ADD DFW$GS_3 /PAGE /SIZE=3

> The commands in this example add entries to the Reserved Memory Registry data file. (The example for the RESERVED_MEMORY SHOW command displays the values for these entries.)

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_070.HTML