HP OpenVMS System Management Utilities Reference
Manual
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 Integrity servers, the file that contains current parameters is
SYS$SYSTEM:IA64VMSSYS.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).
!***************************************************************** !
PARAM-INSERT ! HELP on the individual parameters is taken from SYSGEN
and ! is inserted here by the build procedures. Please do not edit the
! first comment line.
!*****************************************************************
RESERVED_MEMORY ADD (Alpha and Integrity servers)
On Alpha and Integrity servers, adds an entry to the Reserved Memory
Registry data file. Changes and additions to the Reserved Memory
Registry data file do not take effect until the next reboot of the
system.
Use the RESERVED_MEMORY ADD command to reserve an amount of physical
memory that might be needed at a future time. Use the /ALLOCATE
qualifier to set aside one or more blocks of physical memory during the
boot process. Using the /ALLOCATE qualifier allows memory to be
sufficiently contiguous and aligned to be used with granularity hints.
AUTOGEN processes the Reserved Memory Registry data file in its GETDATA
phase. AUTOGEN takes the size of all entries into account when
calculating system parameters that depend on the available amount of
physical memory.
AUTOGEN uses the reservation size of all entries to calculate the
initial size of the global page table unless the entry was specified as
/NOGLOBAL_SECTION.
For more information about the Reserved Memory Registry, refer to the
HP OpenVMS System Manager's Manual and the HP OpenVMS Programming Concepts Manual.
Format
RESERVED_MEMORY ADD name
Parameter
name
Name of the memory reservation. You must specify a name.
If the reservation is for a memory resident global section, the name of
the reservation must be the same as the global section name.
Qualifiers
/ALLOCATE
/NOALLOCATE (default)
Allocates pages during the next reboot of the system. The physical
alignment of the pages is based on the maximum granularity hint factor
that can be used to map the pages without exceeding the size of the
memory reservation. (See the introduction to this section for more
information about the /ALLOCATE qualifier.)
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
If you specify /NOALLOCATE, or do not specify /ALLOCATE, memory is
reserved only by reducing the system's fluid page count, but no
specific pages are set aside.
/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.
/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 pages are allocated for the shared page table during the
next reboot of the system, 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.
/RAD=n
Specifies the preferred resource affinity domain (RAD) for the
reservation you want to make. The value of n is the number of
the RAD you specify. If you omit this qualifier, or if this RAD does
not have sufficient memory, any other RAD can satisfy the reservation
request, and the first available memory section will be used.
The /ALLOCATE qualifier is enforced implicitly when you specify a RAD.
For an example procedure that shows how to use SYSMAN RAD qualifiers
and options, see Section 24.4.
/SIZE=size of reserved memory, in MBs
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, preallocated 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,
preallocated pages are not zeroed during system initialization.
Instead, these pages are zeroed when the global section is created.
Description
The OpenVMS operating system allows you to reserve non-fluid memory for
use within a memory-resident global demand-zero section. The reserved
memory can be simply a deduction from the system's fluid memory size,
or it can be preallocated as 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 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 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 block of physical pages is also allocated and set aside for the
memory-resident global section.
|
|
/PAGE_TABLES
|
An additional 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 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.)
RESERVED_MEMORY EXTEND (Alpha and Integrity servers)
On Alpha and Integrity servers, adds sections of memory if you want to
specify more than one resource affinity domain (RAD) for a single
reservation.
EXTEND does not allow you to specify any of the /ALLOCATE, /ZERO, or
/PAGE_TABLES flags. The existing reservation determines the state of
these flags. The /ALLOCATE flag is set implicitly with EXTEND, whether
or not it was set for the initial reservation.
To add a memory section without specifying a RAD, use the /NORAD
qualifier.
Refer to Section 24.4 for an example procedure that shows how to use
SYSMAN RAD qualifiers and options.
Format
RESERVED_MEMORY EXTEND name
Parameter
name
Name of the memory reservation. You must specify a name.
If the reservation is for a memory resident global section, the name of
the reservation must be the same as the global section name.
Qualifiers
/RAD=n
/NORAD
Specifies an additional memory section if you want to specify more than
one RAD for a single reservation.
Use /NORAD to add a memory section without specifying a RAD.
/SIZE=size of reserved memory, in MBs
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.
RESERVED_MEMORY FREE (Alpha and Integrity servers)
On a running Alpha or Integrity servers, frees reserved memory. This
command does not affect the contents of the Reserved Memory Registry
data file; it affects only the running system.
Format
RESERVED_MEMORY FREE name
Parameter
name
Name of the memory reservation. You must specify a name.
Qualifiers
/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.
/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.
You cannot use the /GROUP qualifier with either /SYSGBL or
/NOGLOBAL_SECTION qualifiers.
/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.
Description
If physical pages were not preallocated during system initialization
for this global section, the reserved memory is simply added to the
system's fluid page count. Otherwise, the pages are deallocated to the
system's free or zeroed page list.
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 part of the named reservation is still used, 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.
Example
|
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 PIPERI
Name 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.
RESERVED_MEMORY LIST (Alpha and Integrity servers)
On Alpha and Integrity servers, provides a preview of this reservation
as it is currently stored in the Reserved Memory Registry data file. If
no reservation is specified, all current reservations are displayed.
Use this qualifier to ensure that a reservation will be made as
intended.
Refer to Section 24.4 for an example procedure that shows how to use
SYSMAN resource affinity domain RAD qualifiers and options.
Format
RESERVED_MEMORY LIST name
Parameter
name
Name of the reservation you want to verify in the Reserved Memory
Registry data file.
Qualifiers
/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.
/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.
You cannot use the /GROUP qualifier with either /SYSGBL or
/NOGLOBAL_SECTION qualifiers.
/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.
RESERVED_MEMORY MODIFY (Alpha and Integrity servers)
On Alpha and Integrity servers, allows you to modify an existing entry
in the Reserved Memory Registry data file.
Refer to Section 24.4 for an example procedure that shows how to use
SYSMAN RAD qualifiers and options.
Format
RESERVED_MEMORY MODIFY name
Parameter
name
Name associated with the entry being removed. You must specify a name.
Qualifiers
/ALLOCATE
/NOALLOCATE (default)
Allocates pages during the next reboot of the system as specified on
the command line. (The default is taken from the existing Reserved
Memory Registry entry.) 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
If you specify /NOALLOCATE, or if you do not specify /ALLOCATE, memory
is reserved only by reducing the system's fluid page count, but no
specific pages are set aside.
/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.
/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.
/NEW_RAD=nn
/NONEW_RAD
Use NEW_RAD to change the RAD assignment for an entry. Do this by first
specifying /RAD=n to identify the entry you want to change and
then specify /NEW_RAD=nn to identify the new RAD. Use only
/NEW_RAD=nn (without the /RAD qualifier) if the old entry did
not have a RAD assigned.
/PAGE_TABLES (default)
/NOPAGE_TABLES
Reserves additional memory for shared page tables system as specified
on the command line. (The default is taken from the existing Memory
Registry.)
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
from the system's fluid page count. If you specify /ALLOCATE,
additional pages are allocated for the shared page table during the
next reboot of the system, 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.
You cannot specify /PAGE_TABLES if the reservation has the attribute
/NOGLOBAL_SECTION.
/RAD=n
/NORAD
MODIFY/RAD=n affects only the entry for the specified resource
affinity domain (RAD). The value of n is the RAD you specify.
Usage Rules
- Do not use MODIFY/RAD=n to change the size of a
reservation for an entry without a specified number or to change the
state of the /ZERO or /PAGE_TABLES flags. (Flags are always consistent
for all entries in a given reservation.)
- To change the RAD assignment for an entry, specify /RAD=n
to identify the entry you want to change and /NEW_RAD=nn to
identify the new RAD. Use only /NEW_RAD=nn (without the /RAD
qualifier) if the old entry did not have a RAD assigned.
- Use MODIFY name /NORAD if you no longer want to tie memory
for this reservation to any specific RADs. SYSMAN compresses multiple
entries into a single entry for an unspecified RAD with the total
memory size as the sum of all RAD entries for this reservation.
/SIZE=size of reserved memory, in MBs
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. The default value for /SIZE is taken from the existing
Reserved Memory Registry.
/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, preallocated 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. The default value is taken from
existing Reserved Memory Registry entry.
/NOALLOCATE implies /NOZERO because /ZERO is incompatible with
/NOALLOCATE. If you do not specify /ZERO, or if you specify /NOZERO,
preallocated pages are not zeroed during system initialization.
Instead, these pages are zeroed when the global section is created.
Description
The Reserved Memory Registry entry to be modified is identified by the
combination of the following items:
name
/[NO]GLOBAL_SECTION
/GROUP=n
/SYSGBL
The values of these qualifiers are the same as for the RESERVED_MEMORY
ADD command.
Example
|
SYSMAN> RESERVED_MEMORY MODIFY
X234567890123456789012345678901/SIZ=2/ZERO
$ TYPE SYS$SYSTEM:VMS$RESERVED_MEMORY.DATA
! VMS$RESERVED_MEMORY.DATA
! Do NOT edit this file
! Modify with SYSMAN RESERVED_MEMORY commands
! A = /ALLOCATE, Z = /ZERO, P = /PAGE_TABLES, VERSION = 1
! SIZE (MB) RESERVATION NAME GROUP A Z P
1 X23456789012345678901234567890 1 0 0 1
2 X234567890123456789012345678901 SYSGBL 1 1 1
1 X2345678901234567890123456789012 NOGBL 0 0 0
SYSMAN> EXIT
$
|
The command in this example modifies an entry to reserve 2 MB of memory
and to allocate and zero this memory at boot time.
| 
