There are several RESERVED_MEMORY subcommands. Select the one you
want from the choices below.
1 – ADD
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 VSI OpenVMS System Manager's Manual and the VSI OpenVMS
Programming Concepts Manual.
Format
RESERVED_MEMORY ADD name
1.1 – 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.
1.2 – Qualifiers
1.2.1 /ALLOCATE
/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:
o size >= 4 MB: physically aligned on a 4 MB boundary
o 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.
1.2.2 /GLOBAL_SECTION
/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.
1.2.3 /GROUP
/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.
1.2.4 /PAGE_TABLES
/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.
1.2.5 /RAD
/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.
1.2.6 /SIZE
/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.
1.2.7 /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.
1.2.8 /ZERO
/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.
1.3 – 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.)
2 – EXTEND
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.
Format
RESERVED_MEMORY EXTEND name
2.1 – 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.
2.2 – Qualifiers
2.2.1 /RAD
/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.
2.2.2 /SIZE
/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.
3 – FREE
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
3.1 – Parameter
name
Name of the memory reservation. You must specify a name.
3.2 – Qualifiers
3.2.1 /GLOBAL_SECTION
/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.
3.2.2 /GROUP
/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.
3.2.3 /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.
4 – LIST
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.
Format
RESERVED_MEMORY LIST name
4.1 – Parameter
name
Name of the reservation you want to verify in the Reserved Memory
Registry data file.
4.2 – Qualifiers
4.2.1 /GLOBAL_SECTION
/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.
4.2.2 /GROUP
/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.
4.2.3 /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.
5 – MODIFY
On Alpha and Integrity servers, allows you to modify an existing
entry in the Reserved Memory Registry data file.
Format
RESERVED_MEMORY MODIFY name
5.1 – Parameter
name
Name associated with the entry being removed. You must specify a
name.
5.2 – Qualifiers
5.2.1 /ALLOCATE
/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:
o size >= 4 MB: physically aligned on a 4-MB boundary
o 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.
5.2.2 /GLOBAL_SECTION
/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.
5.2.3 /GROUP
/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.
5.2.4 /NEW_RAD
/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.
5.2.5 /PAGE_TABLES
/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.
5.2.6 /RAD
/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
o 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.)
o 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.
o 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.
5.2.7 /SIZE
/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.
5.2.8 /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.
5.2.9 /ZERO
/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.
5.3 – 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.
5.4 – 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.
6 – REMOVE
On Alpha and Integrity servers, removes a reserved memory
entry from the Reserved Memory Registry data file. This command
takes effect on the next reboot and does not affect the running
systems.
Format
RESERVED_MEMORY REMOVE name
6.1 – Parameter
name
Name associated with the entry being removed. You must specify a
name.
If page tables are reserved for the named memory-resident global
section, the additional reserved memory is also removed.
6.2 – Qualifiers
6.2.1 /GLOBAL_SECTION
/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.
6.2.2 /GROUP
/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 section being removed. You cannot use the /GROUP
qualifier with either /SYSGBL or /NOGLOBAL_SECTION parameters.
6.2.3 /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.
6.3 – Example
SYSMAN> RESERVED_MEMORY ADD DFW$GS1/SIZE=1
SYSMAN> RESERVED_MEMORY REMOVE DFW$GS1
The first command in this example adds DFW$GS1; the second
command removes it.
7 – SHOW
On Alpha and Integrity servers, displays the memory reservations
on the running system.
The display includes how much of the reserved memory is currently
in use by the named global section. It also includes how much
memory is reserved and currently in use for page tables, if any,
and the blocks of physical pages reserved.
Format
RESERVED_MEMORY SHOW name
7.1 – Parameter
name
Name associated with the entry being displayed within the running
system. If you do not specify a name, the system displays the
reserved memory for all registered global sections.
7.2 – Qualifiers
7.2.1 /GLOBAL_SECTION
/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.
7.2.2 /GROUP
/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 section being displayed. You can use the /GROUP
qualifier only if you specify name. You cannot use the /GROUP
qualifier with either /SYSGBL or /NOGLOBAL_SECTION parameters.
7.2.3 /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.