Updated: 11 December 1998

OpenVMS System Management Utilities Reference Manual

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

Parameter

gs_name

Name of the memory-resident global section associated with this reserved memory. 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.

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=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 contiguous, aligned physical pages were not pre-allocated during system initialization for this global section, the served memory is simply added to the systems fluid page count. Otherwise, the physical pages are deallocated only the system's free or zeroed page list. The system's fluid page count is adjusted to include the deallocated pages.

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 the named memory-resident global section is using the reserved memory, 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.

On Alpha systems, allows you to modify an existing entry in the Reserved Memory Registry data file.

Format

RESERVED_MEMORY MODIFY gs_name

Parameter

gs_name

Name of the memory-resident global section associated with the entry being removed. You must specify a name.

Qualifiers

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

• size >= 4 MB: physically aligned on a 4-MB boundary
• 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 (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=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 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 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

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

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.

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.

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

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.

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.

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

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.

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

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.

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.

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

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.

Defines the nodes or cluster to which subsequent commands apply.

Requires OPER or SETPRV privilege on all nodes in the target environment.

Format

SET ENVIRONMENT

Parameters

None.

Qualifiers

/CLUSTER

Specifies that all subsequent commands apply to all nodes in the cluster. By default, the management environment is the local cluster. Specify a nonlocal cluster by naming one cluster member with the /NODE qualifier.

/NODE=(node1,node2,...)

Specifies that SYSMAN execute subsequent commands on the given DECnet nodes. If accompanied by the /CLUSTER qualifier, the environment becomes the cluster where the given DECnet node is a member. A node name can be a system name, cluster alias, or logical name. However, before you can use logical names to define the command environment, you must set up the logical name table SYSMAN$NODE_TABLE. For more information about defining the SYSMAN logical name table, refer to the OpenVMS System Manager's Manual.

/USERNAME=username

Specifies that this user name should be used for access control purposes on another node. You can use this qualifier only in conjunction with the /CLUSTER or /NODE qualifiers. SYSMAN uses the current user name if none is supplied. SYSMAN prompts for a password whenever you specify a new user name.

Note The account specified must have only a primary password. Accounts with secondary passwords are not supported.

Description

The SET ENVIRONMENT command defines the target nodes or cluster for subsequent commands. When invoked, the system management environment is the local node where you are running SYSMAN. You can change the environment to any other nodes in the cluster, the entire cluster, or any nodes or cluster available through DECnet.

Designate an OpenVMS Cluster environment with the /CLUSTER qualifier. When specifying a nonlocal cluster, also include the /NODE qualifier to identify the cluster.

If your environment consists of VAX and Alpha nodes, see the DO command for information about creating logicals to manage each platform as an environment.

You can display the current environment with the command SHOW ENVIRONMENT. To adjust privileges and defaults for the current environment, use the SET PROFILE command.

An environment exists until you exit from SYSMAN or establish another command context with the SET ENVIRONMENT command.

Examples

SYSMAN> SET ENVIRONMENT/CLUSTER 
%SYSMAN-I-ENV, Current command environment:
        Clusterwide on local cluster 
        Username ALEXIS    will be used on nonlocal nodes
 
      

This command defines the command environment as the local cluster. SYSMAN confirms the new environment.

SYSMAN> SET ENVIRONMENT/NODE=NODE21/CLUSTER 
Remote Password: 
 
%SYSMAN-I-ENV, Current command environment:
        Clusterwide on remote node NODE21 
        Username ALEXIS    will be used on nonlocal nodes
 
      

This command establishes a management environment on the cluster where NODE21 is a member. SYSMAN prompts for a password because it is a nonlocal environment.

SYSMAN> SET ENVIRONMENT/NODE=(NODE21,NODE22,NODE23) 
%SYSMAN-I-ENV, Current command environment:
        Individual nodes: NODE21,NODE22,NODE23 
        Username ALEXIS   will be used on nonlocal nodes
 
      

This command defines the management environment to be three individual nodes.

$ CREATE/NAME_TABLE/PARENT=LNM$SYSTEM_DIRECTORY -
_$ SYSMAN$NODE_TABLE
$ DEFINE LAVCS SYS1,SYS2,SYS3,SYS4/TABLE=SYSMAN$NODE_TABLE
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> SET ENVIRONMENT/NODE=(LAVCS)
%SYSMAN-I-ENV, Current command environment:
        Individual nodes: SYS1,SYS2,SYS3,SYS4
        Username ALEXIS   will be used on nonlocal nodes
 
      

The commands in this example set up the logical name table SYSMAN$NODE_TABLE, define a logical name (LAVCS), and use the logical name to define the command environment.

SET PROFILE

Temporarily modifies a user's current privileges and default device and directory.

Format

SET PROFILE

Parameters

None.

Qualifiers

/DEFAULT=device:[directory]

Specifies the default disk device and directory name that the system should use in this environment to locate and catalog files.

/PRIVILEGES=(priv1,priv2...)

Specifies the privileges to add to the current privileges. Any enhanced privileges must be authorized.

/VERIFY

/NOVERIFY (default)

Specifies whether you want DCL verification (both procedure and image) for future DO commands.

Description

The SET PROFILE command modifies process attributes for the current management environment. After considering the privilege requirements of commands that you intend to use in an environment, you can add or delete current privileges, if they are authorized. You can also set a new default device and directory, as well as use the SET PROFILE/[NO]VERIFY command to control DCL command verification in SYSMAN. Other attributes of your process remain constant. The profile is in effect until you change it, reset the environment, or exit from SYSMAN. The OpenVMS System Manager's Manual discusses profile changes in more detail.

Examples

SYSMAN> SET PROFILE/DEFAULT=WORK1:[ALEXIS] 
      

This command changes the default device and directory in the user account to directory ALEXIS on device WORK1.

SYSMAN> SET PROFILE/PRIVILEGES=(SYSPRV,CMKRNL)/VERIFY 
      

This command makes the authorized privileges, SYSPRV and CMKRNL, part of the current privileges, and turns on DCL verification. The privileges remain in effect until the environment changes, you enter another SET PROFILE command, or you exit.

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

6048PRO_070.HTML