SYSMANHELP.HLB  —  RESERVED_MEMORY, 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  –  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  –  Qualifiers

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.

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.

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.

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.

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.

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.

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.

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.

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.)
Close Help