Document revision date: 19 July 1999

Changes the value of a specific parameter in the work area.

The PARAMETERS SET 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 PARAMETERS WRITE command.

Format

PARAMETERS SET parameter-name [value]

/STARTUP filespec

Parameters

parameter-name

Specifies the name of the parameter to modify. Instead of a name, you can enter a period (.) to change the value of the most recently displayed or the most recently modified parameter. See the PARAMETERS SHOW command for an example of using the period in place of a parameter name.

For a list of system parameters and further information about them, use the command HELP PARAMETERS.

value

Specifies the new value for the parameter. Enclose values for ASCII parameters in quotation marks if they contain embedded spaces or other special characters.

Typically the value is an integer or the keyword DEFAULT. The keyword DEFAULT sets the parameter to its default value. The PARAMETERS SHOW command displays the defined minimum, maximum, and default values for the parameter, which are required unless range checking is disabled with the command PARAMETERS DISABLE CHECKS.

Qualifiers

/STARTUP filespec

Sets the name of the site-independent startup procedure to the given file specification. A file specification has a maximum length of 31 characters. The initial startup command procedure is SYS$SYSTEM:STARTUP.COM.

Examples

SYSMAN> PARAMETERS SET PFCDEFAULT 20
      

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

SYSMAN> PARAMETERS SET GBLSECTIONS DEFAULT
      

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

SYSMAN> PARAMETERS SET/STARTUP SYS$SYSTEM:XSTARTUP.COM
      

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

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

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.

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

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

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:

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:

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

SYSMAN> PARAMETERS WRITE SYS$SYSTEM:SPECIAL
      

This command creates a new parameter specification file.

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

	privacy and legal statement
6048PRO_069.HTML