HP OpenVMS Systems Documentation

Displays the settings and explanations of the RAD_SUPPORT system parameter fields, and the assignment of CPUs and memory to the Resource Affinity Domains (RADs). This command is only useful on platforms that support RADs. By default, the SHOW RAD command displays the settings of the RAD_SUPPORT system parameter fields.

Format

SHOW RAD [number|/ALL]

Parameter

number

Displays information on CPUs and memory for the specified RAD.

Qualifier

/ALL

Displays settings of the RAD_SUPPORT parameter fields and the CPU and memory assignments for all RADs.

Examples

SDA> SHOW RAD
Resource Affinity Domains
-------------------------

    RAD information header address: FFFFFFFF.81032340
    Maximum RAD count:                       00000008
    RAD containing SYS$BASE_IMAGE:           00000000
    RAD support flags:                       0000004F

     3         2 2         1 1
     1         4 3         6 5         8 7         0
    +-----------+-----------+-----------+-----------+
    |..|..| skip|ss|gg|ww|pp|..|..|..|..|.p|fs|cr|ae|
    +-----------+-----------+-----------+-----------+
    |..|..|    0| 0| 0| 0| 0|..|..|..|..|.1|00|11|11|
    +-----------+-----------+-----------+-----------+

    Bit 0 = 1:          RAD support is enabled

    Bit 1 = 1:          Soft RAD affinity support is enabled
                        (Default scheduler skip count of 16 attempts)

    Bit 2 = 1:          System-space replication support is enabled

    Bit 3 = 1:          Copy on soft fault is enabled

    Bit 4 = 0:          Default RAD-based page allocation in use

                        Allocation Type               RAD choice
                        ---------------               ----------
                        Process-private pagefault     Home
                        Process creation or inswap    Random
                        Global pagefault              Random
                        System-space page allocation  Current

    Bit 5 = 0:          RAD debug feature is disabled

    Bit 6 = 1:          Per-RAD non-paged pool is enabled
      

This example shows the settings of the RAD_SUPPORT system parameter fields.

SDA> SHOW RAD 2
    Resource Affinity Domain 0002
    -----------------------------

    CPU sets:

      Active      08 09 10 11
      Configure   08 09 10 11
      Potential   08 09 10 11


    PFN ranges:

      Start PFN   End PFN     PFN count   Flags
      ---------   --------    ---------   -----
      01000000    0101FFFF    00020000    000A  OpenVMS Base

      01020000    0103FFFF    00020000    0010  Galaxy_Shared

    SYSPTBR:      01003C00
      

This example shows information on the CPUs and memory for RAD 2.

Displays information about all resources in the system, or about a resource associated with a specific lock.

Format

SHOW RESOURCES {/ADDRESS=n|/ALL (d)|
/BRIEF|/CACHED|/CONTENTION [=ALL]| /LOCKID=lock-id|/NAME=resource-name|
/OWNED|/STATUS=(keyword [keyword,])}

Parameters

None.

Qualifiers

/ADDRESS=n

Displays information from the resource block at the specified address.

/ALL

Displays information from all resource blocks (RSBs) in the system. This is the default behavior of the SHOW RESOURCES command.

/BRIEF

Displays a single line of information for each resource.

/CACHED

Displays resource blocks that are no longer valid. The memory for these resources is saved so that later requests for resources can use them.

/CONTENTION [=ALL]

Displays only resources that have at least one lock on either the waiting or conversion queue. Unless you specify the ALL keyword, resources with locks on the waiting or conversion queues that are not participating in deadlock searches are ignored. (Locks not participating in deadlock searches are requested with either the LCK$M_NODLCKWT or LCK$M_NODLCKBLK flags.)

/LOCKID=lock-id

Displays information on the resource associated with the lock with the specified lock-id.

/NAME=resource-name

Displays information about a specific resource.

/OWNED

Causes SDA to display only owned resources.

/STATUS=(keyword [keyword,])

Displays only resources that have the specified status bits set in the RSB$L_STATUS field. Status keywords are as follows:

Keyword	Meaning
2PC_IP	Indicates a two-phase convert operation in progress
BRL	Indicates byte range resource
CHK_BTR	Checks for better master
CVTFULRNG	Indicates full-range requests in convert queue
CVTSUBRNG	Indicates sub-range requests in convert queue
DIRENTRY	Indicates entered in directory during failover
DIR_IP	Creates directory entry
DIR_RQD	Indicates directory entry required
INVPEND	Checks for value block invalidation
RBLD_ACT	Indicates lock rebuild active for this tree
RBLD_IP	Indicates rebuild operation in progress
RBLD_RQD	Indicates rebuild required for this resource tree
RM_ACCEPT	Accepts new master
RM_DEFLECT	Deflects remote interest
RM_IP	Indicates resource remaster in progress
RM_PEND	Indicates a pending resource remaster operation
RM_RBLD	Indicates to always rebuild resource tree
RM_WAIT	Blocks local activity
VALCUR	Indicates value block is current
VALINVLD	Indicates value block invalid
WTFULRNG	Indicates full-range requests in wait queue
WTSUBRNG	Indicates a full-range requests in wait queue

Description

The SHOW RESOURCES command displays the information listed in Table 4-21 either for each resource in the system or for the specific resource associated with the specified lock-id, address or name.

Table 4-21 Resource Information in the SHOW RESOURCES Display

Field	Contents
Address of RSB	Address of the resource block (RSB) that describes this resource.
GGMODE	Indication of the most restrictive mode in which a lock on this resource has been granted. Table 4-22 shows the fields and values and their meanings. They are shown in order from the least restrictive mode to the most restrictive. For information on conflicting and incompatible lock modes, see the OpenVMS System Services Reference Manual.
Status	The contents of the resource block status field.
Parent RSB	Address of the RSB that is the parent of this RSB. This field is 00000000 if the RSB itself is a parent block.
CGMODE	Indication of the most restrictive lock mode to which a lock on this resource is waiting to be converted. This does not include the mode for which the lock at the head of the conversion queue is waiting. See Table 4-22.
Sub-RSB count	Number of RSBs of which this RSB is the parent. This field is 0 if the RSB has no sub-RSBs.
FGMODE	Indication of the full-range grant mode. See Table 4-22.
Lock Count	The total count of all locks on the resource.
RQSEQNM	Sequence number of the request.
BLKAST count	Number of locks on this resource that have requested a blocking AST.
CSID	Cluster system identification number (CSID) and name of the node that owns the resource.
Resource	Dump of the name of this resource, as stored at the end of the RSB. The first two columns are the hexadecimal representation of the name, with the least significant byte represented by the rightmost two digits in the rightmost column. The third column contains the ASCII representation of the name, the least significant byte being represented by the leftmost character in the column. Periods in this column represent values that correspond to nonprinting ASCII characters.
Valblk	Hexadecimal dump of the 16-byte block value block associated with this resource.
Length	Length in bytes of the resource name.
Mode	Processor mode of the namespace in which this RSB resides.
Owner	Owner of the resource. Certain resources, owned by the operating system, list "System" as the owner. Locks owned by a group have the number (in octal) of the owning group in this field.
Seqnum	Sequence number associated with the resource's value block. If the number indicates that the value block is not valid, the words "Not valid" appear to the right of the number.
Granted queue	List of locks on this resource that have been granted. For each lock in the list, SDA displays the number of the lock and the lock mode in which the lock was granted.
Conversion queue	List of locks waiting to be converted from one mode to another. For each lock in the list, SDA displays the number of the lock, the mode in which the lock was granted, and the mode to which the lock is to be converted.
Waiting queue	List of locks waiting to be granted. For each lock in the list, SDA displays the number of the lock and the mode requested for that lock.

Examples

SDA>  SHOW RESOURCES
Resource database
-----------------
RSB:         FFFFFFFF.7FD47950  GGMODE:     PR  Status: VALID
Parent RSB:  00000000.00000000  CGMODE:     PR
Sub-RSB count:      0           FGMODE:     PR
Lock Count:         1           RQSEQNM:  0000
BLKAST count:       1           CSID: 00000000  (SWORKS)

Resource:          6D632445 48434143  CACHE$cm  Valblk: 00000000 00000000
 Length   24       525F534B 524F5753  SWORKS_R          00000000 00000000
 Kernel mode       000027DA 4E455641  AVENÚ'..
 System            00000000 00000000  ........  Seqnum: 00000000

Granted queue (Lock ID / Gr mode / Range):
 0100042F  PR 00000000-FFFFFFFF

Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range):
     *** EMPTY QUEUE ***

Waiting queue (Lock ID / Rq mode / Range):
     *** EMPTY QUEUE ***



Resource Database
-----------------
RSB:         FFFFFFFF.7FA66A50  GGMODE:     NL  Status: VALID
Parent RSB:  FFFFFFFF.7FD88350  CGMODE:     NL
Sub-RSB count:      0           FGMODE:     NL
Lock Count:         2           RQSEQNM:  004D
BLKAST count:       0           CSID: 00000000  (SWORKS)

Resource:          001E7324 42313146  F11B$s..  Valblk: 00000001 0000033A
 Length   10       00000000 00000000  ........          00000000 00000000
 Kernel mode       00000000 00000000  ........
 System            00000000 00000000  ........  Seqnum: 00000672

Granted queue (Lock ID / Gr mode / Range):
 69000F80  NL 00000000-FFFFFFFF         01001810  NL 00000000-FFFFFFFF

Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range):
     *** EMPTY QUEUE ***

Waiting queue (Lock ID / Rq mode / Range):
     *** EMPTY QUEUE ***

   .
   .
   .
      

The SHOW RESOURCES command displays information taken from the RSBs of all resources in the system. For instance, the RSB at FFFFFFFF.7FA66A50₁₆ is a parent block with no sub-RSBs.

This example of the SHOW RESOURCES/CONTENTION commands shows all the resources for which there is contention, and which are not to be included in dead lock searches.

Displays information contained in the reserved memory descriptors. Reserved memory is used within the system by memory-resident global sections.

Format

SHOW RMD [/QUALIFIERS]

Parameters

None.

Qualifiers

/ADDRESS=n

Displays a specific reserved memory descriptor entry, given its address.

/ALL

Displays information in all the reserved memory descriptors. This qualifier is the default.

Description

The SHOW RMD displays information that resides in the reserved memory descriptors. Table 4-23 shows the fields and their meaning.

Table 4-23 RMD Fields

Field	Meaning
ADDRESS	Gives the address of the reserved memory descriptor.
NAME	Gives the name of the reserved memory descriptor.
GROUP	Gives the UIC group that owns the reserved memory. This is given as -S- for system global reserved memory.
RAD	Gives the required RAD for the reserved memory. Displays "Any" if no RAD specified.
PFN	Gives starting page number of the reserved memory.
COUNT	Gives the number of pages reserved.
IN_USE /ERROR	Gives the number of pages in use. If an error occured when the reserved memory was being allocated, the error condition code is displayed in parentheses. A second line, giving the text of the error, is also displayed in this case.
ZERO_PFN	Gives the next page number to be zeroed.
FLAGS	Gives the settings of flags for specified reserved memory descriptor, as a hexadecimal number, then key flag bits are also displayed by name. The names may use multiple lines in the display.

Example

SDA> SHOW RMD

Reserved Memory Descriptor List
-------------------------------
                                                            In_Use
Address  Name                Group RAD    PFN     Count     (Error)  Zero_PFN  Flags
-------- ------------------- ----- ---- -------- --------  --------  -------- ------------------------------
814199C0 LARGE               00022 Any  00000000 000004E2  00000000  00000000 000000E0 Group Page_Tables
                                                                                       GBLSec
81419940 LARGE               00022 Any  00000000 00138800 (0000244C) 00000000 000001A0 Error Group GBLSec
         Error = %SYSTEM-F-INSFLPGS, insufficient Fluid Pages available
81419AC0 SMALL               00011 0001 00000180 00000001  00000000  00000180 000000E1 Alloc Group
                                                                                       Page_Tables GBLSec
81419A40 SMALL               00011 0001 00000E00 00000080  00000000  00000E00 000000A1 Alloc Group GBLSec

Displays the RMS data structures selected by the SET RMS command to be included in the default display of the SHOW PROCESS/RMS command.

Format

SHOW RMS

Parameters

None.

Qualifiers

None.

Description

The SHOW RMS command lists the names of the data structures selected for the default display of the SHOW PROCESS/RMS command.

For a description of the significance of the options listed in the SHOW RMS display, see the description of the SET RMS command and Table 4-2.

For an illustration of the information displayed by the SHOW PROCESS/RMS command, see the examples included in the description of the SHOW PROCESS command.

Examples

SDA>  SHOW RMS

RMS Display Options:  IFB,IRB,IDX,BDB,BDBSUM,ASB,CCB,WCB,FCB,FAB,RAB,NAM,
XAB,RLB,BLB,BLBSUM,GBD,GBH,FWA,GBDSUM,JFB,NWA,RU,DRC,SFSB,GBSB
Display RMS structures for all IFI values.
      

The SHOW RMS command displays the full set of options available for display by the SHOW PROCESS/RMS command. SDA, by default, selects the full set of RMS options at the beginning of an analysis.

SDA>  SET RMS=(IFAB=1,CCB,WCB)
SDA>  SHOW RMS

RMS Display Options:  IFB,CCB,WCB
Display RMS structures only for IFI =0001
      

The SET RMS command establishes the IFB, CCB, and WCB as the structures to be displayed, and only for the file whose internal File Identifer has the value 1, when the SHOW PROCESS/RMS command is issued. The SHOW RMS command verifies this selection of RMS options.

Displays information about response IDs (RSPIDs) of all System Communications Services (SCS) connections or, optionally, a specific SCS connection.

Format

SHOW RSPID [/CONNECTION=cdt-address]

Parameters

None.

Qualifier

/CONNECTION=cdt-address

Displays RSPID information for the specific SCS connection whose connection descriptor table (CDT) address is provided in cdt-address. You can find the cdt-address for any active connection on the system in the CDT summary page display of the SHOW CONNECTIONS command. CDT addresses are also stored in many individual data structures related to SCS connections. These data structures include class driver request packets (CDRPs) and unit control blocks (UCBs) for class drivers that use SCS and cluster system blocks (CSBs) for the connection manager.

Description

Whenever a local system application (SYSAP) requires a response from a remote SYSAP, a unique number, called an RSPID, is assigned to the response by the local system. The RSPID is transmitted in the original request (as a means of identification), and the remote SYSAP returns the same RSPID in its response to the original request.

The SHOW RSPID command displays information taken from the response descriptor table (RDT), which lists the currently open local requests that require responses from SYSAPs at a remote node. For each RSPID, SDA displays the following information:

• RSPID value
• Address of the class driver request packet (CDRP), which generally represents the original request
• Address of the CDT that is using the RSPID
• Name of the local process using the RSPID
• Remote node from which a response is required (and has not yet been received)

Examples

SDA> SHOW RSPID
    --- Summary of Response Descriptor Table (RDT) 805E6F18 ---
RSPID      CDRP Address     CDT Address     Local Process Name      Remote Node
-----      ------------     -----------     ------------------      -----------
39D00000     8062CC80        805E8710       VMS$VMScluster          VANDQ1
EE210001     80637260        805E8C90       VMS$DISK_CL_DRVR        ROMRDR
EE240002     806382E0        805E8DF0       VMS$DISK_CL_DRVR        VANDQ1
EE440003     806393E0        805E8F50       VMS$TAPE_CL_DRVR        VANDQ1
5DB90004     80636BC0        805E8870       VMS$VMScluster          ROMRDR
5C260005     80664040        805E8870       VMS$VMScluster          ROMRDR
38F80006     80664A80        805E8710       VMS$VMScluster          VANDQ1

      

This example shows the default output for the SHOW RSPID command.

SDA>  SHOW RSPID/CONNECTION=805E8F50
    --- Summary of Response Descriptor Table (RDT) 805E6F18 ---
RSPID      CDRP Address     CDT Address     Local Process Name      Remote Node
-----      ------------     -----------     ------------------      -----------
EE440003     806393E0        805E8F50       VMS$TAPE_CL_DRVR        VANDQ1
      

This example shows the output for a SHOW RSPID/CONNECTION command.