1 RESERVED_MEMORY There are several RESERVED_MEMORY subcommands. Select the one you want from the choices below. 2 ADD 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 3 Parameter gs_name Name of the memory-resident global section associated with this reserved memory. You must specify a name. 3 Qualifiers /ALLOCATE /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: o size >= 4 MB: physically aligned on a 4 MB boundary o 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 /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 /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 /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=[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 /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. 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 FREE 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. You can also use RESERVED_MEMORY FREE qualifiers to free 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 FREE gs_name 3 Parameter gs_name Name of the memory-resident global section associated with this reserved memory. You must specify a name. 3 Qualifiers /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. AUTOGEN processes the Reserved Memory Registry 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 /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. 3 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. 2 MODIFY On Alpha systems, allows you to modify an existing entry in the Reserved Memory Registry data file. Format RESERVED_MEMORY MODIFY gs_name 3 Parameter gs_name Name of the memory-resident global section associated with the entry being removed. You must specify a name. 3 Qualifiers /ALLOCATE /ALLOCATE /NOALLOCATE (default) Allocates contiguous, aligned 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 allocated memory is deducted from the system's fluid pagecount, 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: o size >= 4 MB: physically aligned on a 4-MB boundary o size < 4 MB: physically aligned on a 512-KB boundary /NOALLOCATE implies /NOZERO. (/ZERO is incompatible with /NOALLOCATE.) 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. /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. AUTOGEN processes the Reserved Memory Registry 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 /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 /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 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. You cannot specify /PAGE_TABLES if the reservation has the attribute /NOGLOBAL_SECTION. /SIZE /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. 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 /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. 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, pre-allocated pages are not zeroed during system initialization. Instead, these pages are zeroed when the global section is created. 3 Description The Reserved Memory Registry entry to be modified is identified by the combination of the following items: gs_name /[NO]GLOBAL_SECTION /GROUP=n /SYSGBL The values of these qualifiers are the same as for the RESERVED_ MEMORY ADD command. 3 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. 2 REMOVE On Alpha systems, removes a reserved memory entry from the Reserved Memory Registry data file. The command does not affect memory within the memory allocation for running systems. You can also use RESERVED_MEMORY REMOVE qualifiers to remove a block of contiguous page frame numbers (PFNs) from the Reserved Memory Registry data file. For information about the Reserved Memory Registry, refer to the OpenVMS Alpha Guide to 64-Bit Addressing and VLM Features. Format RESERVED_MEMORY REMOVE gs_name 3 Parameter gs_name Name of the memory-resident global section 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. 3 Qualifiers /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. 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 /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. /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. 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. 2 SHOW On Alpha systems, 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 contiguous page frame numbers (PFNs) reserved. For information about Reserved Memory Registry, refer to OpenVMS Alpha Guide to 64-Bit Addressing and VLM Features. Format RESERVED_MEMORY SHOW gs_name 3 Parameter gs_name Name of the memory-resident global section associated with the entry being displayed within the running system. If you do not specify gs_system, the system displays the reserved memory for all registered global sections. 3 Qualifiers /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. 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 /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 gs_name. You cannot use the /GROUP qualifier with either /SYSGBL or /NOGLOBAL_SECTION parameters. /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. 3 Example SYSMAN> RESERVED_MEMORY SHOW %SYSMAN-I-OUTPUT, command execution on node PIPER Name Pages In Use Group PTs Alloced Zeroed DFW$GS_3 384 0 SYSGBL No No No DFW$GS_2 256 0 SYSGBL No Yes Yes DFW$GS_1 128 0 00000100 No No No DFW$GS_3 1 0 SYSGBL Yes No No DFW$GS_2 1 0 SYSGBL Yes Yes No The command in this example displays the memory reservations on a running system.