![Content starts here](http://welcome.hp-ww.com/img/s.gif) |
OpenVMS System Management Utilities Reference
Manual
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.)
|