![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
Validates all parameter values to ensure that they fall within the defined minimum and maximum values.Because range checks are enabled by default, use PARAMETERS ENABLE CHECKS after entering a PARAMETERS DISABLE CHECKS command.
PARAMETERS ENABLE CHECKS
None.
None.
SYSMAN> PARAMETERS DISABLE CHECKS SYSMAN> PARAMETERS SET WSMAX 20 SYSMAN> PARAMETERS ENABLE CHECKS SYSMAN> PARAMETERS SET WSMAX 30 %SMI-E-OUTRANGE, parameter is out of range SYSMAN> PARAMETERS SHOW WSMAX Parameter Name Current Default Minimum Maximum Unit Dynamic WSMAX 2000 1024 60 6400 pages
The PARAMETERS ENABLE CHECKS command in this example shows that when range checking is disabled, the system accepts a working set value (WSMAX) of 20. However, once range checking is enabled with the PARAMETERS ENABLE CHECKS command, the system does not accept a WSMAX below the minimum, which is 60.
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 on performing these modifications, see the PARAMETERS WRITE command.
PARAMETERS SET parameter-name [value]
/STARTUP filespec
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 on 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.
/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
SYSMAN> PARAMETERS SET GBLSECTIONS DEFAULT
SYSMAN> PARAMETERS SET/STARTUP SYS$SYSTEM:XSTARTUP.COM
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.
PARAMETERS SHOW [parameter-name]
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.
/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.
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
SYSMAN> PARAMETERS SHOW/ACP
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
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
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]
Reads a set of system parameters into the work area for display or modification.
PARAMETERS USE source
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:
None.
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)
SYSMAN> PARAMETERS USE DEFAULT
This command activates the default parameter values that are supplied with the operating system.
Writes the contents of the work area to memory, to disk, or to a file, depending on the destination that you specify.
PARAMETERS WRITE destination
destination
The destination of a new parameter file can be any of the following:
None.
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
SYSMAN> PARAMETERS WRITE CURRENT
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.)For information on Reserved Memory Registry, see OpenVMS Alpha Guide to 64-Bit Addressing and VLM Features.
RESERVED_MEMORY ADD gs_name
gs_name
Name of the memory-resident global section associated with this reserved memory. You must specify a name.
/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 4MB) and 64 pages (or 512KB). Therefore, assuming an 8KB system page size, reserved memory is physically aligned as follows:
- size >= 4BM: physically aligned on a 4MB boundary
- size < 4BM: physically aligned on a 512KB boundary
If you specify /NOALLOCATE, or do not specify /ALLOCATE, the reserved memory is not allocated during the next reboot of the system. The 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.
/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.
/PAGE_TABLES
/NOPAGE_TABLES (default)
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./ZERO
/NOZERO (default)
Must be specified with the /ALLOCATE qualifier. 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.If you do not specify /ZERO, or if you specify /NOZERO, pre-allocated pages are not zeroed during system initialization. Rather, these pages are zeroed when the global section is created.
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 SYS$SYSTEM:VMS$RESERVED_MEMORY.DATA data file.
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.
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.)
On a running Alpha system, frees reserved memory. This command does not affect the contents of the Reserved Memory Registry data file; it affects only the memory with the running system.For information on Reserved Memory Registry, see OpenVMS Alpha Guide to 64-Bit Addressing and VLM Features.
RESERVED_MEMORY FREE gs_name
gs_name
Name of the memory-resident global section associated with this reserved memory. You must specify a name.
/GROUP=n
You must specify /GROUP if the memory-resident global section is a group global section. Do not specify /GROUP if the memory-resident global section is a system global section. The value n is the UIC group number (in octal) associated with the memory-resident being freed.
If contiguous, aligned physical pages were not pre-allocated during system initialization for this global section, the served memory is simply added to the systems fluid page count. Otherwise, the physical pages are deallocated only the system's free or zeroed page list. The system's fluid page count is adjusted to include the deallocated pages.If page tables are also reserved for the named memory-resident global section, the reserved memory for the shared page tables is also freed.
If the named memory-resident global section is using the reserved memory, the amount of reserved memory not currently in use is freed. The system displays an informational message that indicates if the named global section is using some portion of the reserved memory.
SYSMAN> RESERVED_MEMORY FREE DFW$GS_2 %SMI-S-RMRFREPAG, pages successfully freed from reservation SYSMAN> RESERVED_MEMORY SHOW %SYSMAN-I-OUTPUT, command execution on node PIPERIName Pages In Use Group PTs Alloced Zeroed DFW$GS_3 384 0 SYSGBL No No No DFW$GS_1 128 0 00000100 No No No DFW$GS_3 1 0 SYSGBL Yes No No
In this example, the first command frees reserved memory in DFW$GS_2. The second command displays reserved memory in the running system for DFW$GS_3 and DFW$GS_1, but not for DFW$GS_2, which has no reserved memory.
6048P056.HTM OSSG Documentation 26-NOV-1996 12:43:45.40
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.