SYSMANHELP.HLB  —  RESERVED_MEMORY, MODIFY  Qualifiers

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.

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.

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.

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    /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.

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.

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.

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.

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