Document revision date: 30 March 2001

## OpenVMS VAX System Dump Analyzer Utility Manual

Previous | Contents | Index

The SHOW PROCESS/LOCKS/INDEX=0A command displays information about the locks held by process JOB_CONTROL, whose PCB is at index 0A, into the system's PCB list. This command implicitly makes JOB_CONTROL the SDA current process for subsequent commands that display process context information. It has no effect on SDA CPU context because JOB_CONTROL is not current on any processor in the multiprocessing system.

#4
    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.

>     SDA> SHOW PROCESS/RMS
>        .
>        .
>        .
>     Process index: 0032   Name: BEASSEM_MTHRTL_   Extended PID: 27200132
>     --------------------------------------------------------------------
>     IFAB Address: 7FF9C808  IFI: 0002       Organization: Sequential
>     ------------
>     PRIM_DEV:       1C4D4108        DIR,FOD,SHR,AVL,ELG,IDV,ODV,RND
>     BKPBITS:        00080020        ACCESSED,NORECLK
>     BLN:            3A      58.             BID:            0B      11.
>     EFN:            00                      MODE:           03
>     IOS:            00000001                ASBADDR:        00000000
>     IOS2:           0000                    WAIT_Q_FLINK:   00000000
>     IOS4:           00000000                ARGLST:         7FF21418
>     ATJNLBUF:       00000000                WAIT_Q_BLINK:   00000000
>     FSBPTR:         00000000                AGENT_MODE:     03
>     SHR:            02      SHRGET
>     IRAB_LNK:       7FF9C958                CHNL:           00C0
>     FAC:            02      GET
>     ORGCASE:        00              Sequential
>     LAST_FAB:       00081FD0                NWA_PTR:        00000000
>     IFI:            0002                    ECHO_ISI:       0000
>     FWA_PTR:        7FF9CC00
>     BDB_FLNK:       7FF9CBB0                DEVBUFSIZ:      00000200     512.
>     BDB_BLNK:       7FF9CB60                RTDEQ:          0000           0.
>     RFMORG:         02              VAR
>     RAT:            02              CR
>     LRL:            004C          76.       HBK_DISK:       000C0000
>     FFB:            0084         132.       EBK_DISK:       000C0000
>     FSZ:            00             0.       BKS:            00             0.
>     DEQ:            0000           0.       MRS:            0000           0.
>     HBK:            0000000C      12.       GBC:            0000           0.
>     EBK:            0000000C
>     LAST_GOOD_EBK:  00000000       0.       LAST_GOOD_FFB:  0000           0.
>     RNS_LEN:        00000000                LOCK_BDB:       00000000

>        .
>        .
>        .

> The SHOW PROCESS/RMS command displays RMS data structures for the current SDA process.

#5
    SDA> SHOW PROCESS/IMAGES

>                             Process activated images
>                             ------------------------

>     ICB       Start     End       Type            Image Name  Major ID,Minor ID
>     --------  --------  --------  --------------  -----------------------------
>     7FF83878  00000200  00000DFF  MAIN            SHOW_PROC_IMAGES  0,0
>     7FF84100  0003AC00  0003FBFF  GLOBAL PRT SHR  DECW$TRANSPORT_COMMON  12,12
>     7FF84400  00036200  0003ABFF  GLOBAL          CONVSHR  1,0
>     7FF84470  0002E400  000361FF  GLOBAL          FDLSHR  1,0
>     7FF84560  00021A00  0002E3FF  GLOBAL          SORTSHR  2,28
>     7FF845D0  00000E00  000089FF  GLOBAL          LIBRTL2  1,12
>     7FF835F8  00008A00  000219FF  GLOBAL     SHR  LIBRTL  1,14
>     7FF84800  00060C00  000767FF  MERGED     SHR  ADARTL  0,0
>     7FF84720  00076800  000A03FF  GLOBAL     SHR  MTHRTL  129,32781
>     Total images = 9                Pages allocated = 1017

> The SHOW PROCESS/IMAGES command displays the address of the image control block, the start and end addresses of the image, the activation code, the protected and shareable flags, the image name, and the major and minor IDs of the image.

#6
    SDA> SHOW PROCESS/TRANSACTIONS=(DISPLAY=THREADS,
       TID=FAC21DE2-BA88-0092-8FA6-B24B)

> The SHOW PROCESS command displays the transaction thread information for the transaction whose identifier is FAC21DE2-BA88-0092-8FA6-B24B.

## SHOW RESOURCE

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

### Format

> SHOW RESOURCE {/ALL|/LOCKID=lock-id|/NAME=resource-name}

### Parameters

> None.

### Qualifiers

> #### /ALL

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

> #### /LOCKID=lock-id

> Displays information about the resource associated with the lock with the specified lock-id.

> #### /NAME=resource-name

> Displays information about the resource whose resource name begins with the specified resource-name. For case-sensitive names, enclose resource-name in quotation marks.

### Description

> The SHOW RESOURCE command displays the information listed in Table SDA-21 for each resource in the system or for the specific resource associated with the specified lock-id.

> Table SDA-21 Resource Information in the SHOW RESOURCE Display
> Field | Contents
> --- | ---
> Address of RSB | Address of the resource block (RSB) that describes this resource.
> 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.
> Sub-RSB count | Number of RSBs of which this RSB is the parent. This field is 0 if the RSB has no sub-RSBs.
> Group grant mode | Indication of the most restrictive mode in which a lock on this resource has been granted. This field can contain the following values (shown in order from the least restrictive mode to the most restrictive): NL Null mode CR Concurrent-read mode CW Concurrent-write mode PR Protected-read mode PW Protected-write mode EX Exclusive mode For information about conflicting and incompatible lock modes, see the OpenVMS System Services Reference Manual.
> Conversion grant mode | 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.
> BLKAST count | Number of locks on this resource that have requested a blocking AST.
> Value block | Hexadecimal dump of the 16-byte block value block associated with this resource.
> Sequence # | 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.
> CSID | Cluster system identification number (CSID) 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.
> Length | Length in bytes of the resource name.
> --- | Processor mode of the name space in which this RSB resides.
> --- | 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.
> 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

#1
    SDA>  SHOW RESOURCE

>     Resource database
>     -----------------
>     Address of RSB:  807F6120  Group grant mode:       NL
>     Parent RSB:      806EA180  Conversion grant mode:  NL
>     Sub-RSB count:          0  BLKAST count:            0
>     Value block:   806CE510 00000000 00000002 00000002   Seq. #:  00000008
>     Resource:      09ED7324 42313146    F11B$sí.
>      Length   10   00000000 00000200    ........         CSID:  00020041
>      Kernel mode   00000000 00000000    ........
>      System        00000000 00000000    ........

>     Granted queue (Lock ID / Gr mode):
>          006801AE  NL

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

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

>     Address of RSB:  807EB9E0  Group grant mode:       PW
>     Parent RSB:      00000000  Conversion grant mode:  EX
>     Sub-RSB count:          0  BLKAST count:            1
>     Value block:   00000000 00000003 00000000 0000FFF2   Seq. #:  0000027F Not valid
>     Resource:      32245F24 44414853    SHAD$_$2
>      Length   16   3A31534A 44243435    54$DJS1:         CSID:  0002001A
>      Kernel mode   00000000 00000000    ........
>      System        00000000 00000000    ........
>        .
>        .
>        .

> The SHOW RESOURCE command displays information taken from the RSBs of all resources in the system. For instance, the RSB at 807EB9E016 is a parent block with no sub-RSBs. The most restrictive lock granted on this resource is in protected-write (PW) mode. There is a lock on the conversion queue waiting to be converted from PW mode to exclusive (EX) mode.

#2
    SDA>  SHOW PROCESS/LOCKS

    Process index: 001C   Name: STARTQ   Extended PID: 4800011C
    -----------------------------------------------------------
    Lock data:

    Lock id:  0117054F   PID:    0001001C   Flags:   VALBLK  SYNCSTS SYSTEM
    Par. id:  00000000   Granted at    PW            NOQUOTA
    Sublocks:        0
    LKB:      808091A0
    Resource:      45527624 42313146    F11B$vRE  Status:  NOQUOTA
     Length   18   20205241 4D323053    S02MAR
     Kernel mode   00000000 00002020      ......
     System        00000000 00000000    ........
    Process copy of lock 008209CF on system 0002001
       .
       .
       .
    SDA>  SHOW RESOURCE/LOCKID=117054F
    Resource database
    -----------------
    Address of RSB:  806BB050  Group grant mode:       NL
    Parent RSB:      00000000  Conversion grant mode:  NL
    Sub-RSB count:          4  BLKAST count:            0
    Value block:   00960102 0000330B 000735AA 5A020005   Seq. #:  00006D9F
    Resource:      45527624 42313146    F11B$vRE
     Length   18   20205241 4D323053    S02MAR           CSID:  0002001A
     Kernel mode   00000000 00002020      ......
     System        00000000 00000000    ........

    Granted queue (Lock ID / Gr mode):
         0117054F  PW       00060545  CR

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

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

> The SHOW PROCESS/LOCKS command lists all locks associated with the SDA current process, STARTQ. Its display is identical to that of the SHOW LOCK command, illustrated in Table SDA-15. The SHOW RESOURCE/LOCKID=117054F command determines that this particular lock is on the granted queue in protected-write mode for the resource at 806BB05016.

#3
    SDA>  SHOW RESOURCE/NAME=RMS$
    Resource database
    -----------------

    Address of RSB:  80EFBE40  GGMODE:       EX  Status: DIRENTR VALID
    Parent RSB:      00000000  CGMODE:       EX
    Sub-RSB count:          2  FGMODE:       EX
    Lock Count:             1  CSID:   00000000
    BLKAST count:           1  RQSEQNM:    0000

    Resource:      00030014 24534D52   RMS$....  Valblk: 00000000 00000000
     Length   26   4D565841 56020000   ...VAXVM          00000000 00000000
     Exec. mode    00202035 35305653   SV055  .
     System        00000000 00000000   ........  Seqnum: 00000000

    Granted queue (Lock ID / Gr mode / Range):
     6400004C  EX 00000000-FFFFFFFF

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

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

> This example of the SHOW RESOURCE/NAME command displays information about the resource whose name begins with RMS$.

## SHOW RMS

> 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 SDA-14.

> 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

#1
    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.

#2
    SDA>  SET RMS=(IFB,CCB,WCB)
    SDA>  SHOW RMS

    RMS Display Options:  IFB,CCB,WCB
    Display RMS structures for all IFI values.

> The SET RMS command establishes the IFB, CCB, and WCB as the structures to be displayed when you issue the SHOW PROCESS/RMS command. The SHOW RMS command verifies this selection of RMS options.

## SHOW RSPID

> Displays information about response IDs (RSPIDs) of all 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.14

### Description

> Whenever a local system application (SYSAP) requires a response from a remote SYSAP, the local system assigns a unique number, called an RSPID, to the response. 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 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

#1
    SDA>  SHOW RSPID

>     VAXcluster data structures
>     --------------------------

>         --- Summary of Response Descriptor Table(RDT) 8037A4A8 ---

>     RSPID      CDRP Address     CDT Address     Local Process Name      Remote Node
>     -----      ------------     -----------     ------------------      -----------

>     04C30000     803917B0        8037AB50       VMS$DISK_CL_DRVR        SOWHAT
>     06260001     80804FA0        8037AF10       VMS$VAXcluster          WALKIN
>     0C390002     807E0460        8037AD30       VMS$VAXcluster          OLEO
>        .
>        .
>        .

> The SHOW RSPID command shows the response IDs that are currently open for all local connections in the VAXcluster system.

#2
    SDA>  SHOW RSPID/CONNECTION=G37B7D0

>     VAXcluster data structures
>     --------------------------

>         --- Summary of Response Descriptor Table(RDT) 8037A4A8 ---

>     RSPID      CDRP Address     CDT Address     Local Process Name      Remote Node
>     -----      ------------     -----------     ------------------      -----------

>     08B8001C     807F0300        8037B7D0       VMS$VAXcluster          METEOR
>     0915001D     807F08A0        8037B7D0       VMS$VAXcluster          METEOR

> The SHOW RSPID/CONNECTION=G37B7D0 command displays only those RSPIDs in use that are associated with the SCS connection whose CDT is at address 8037B7D016.

Note ##### 14 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.

## SHOW SPINLOCKS

> Displays information taken from the data structures that provide system synchronization in a multiprocessing environment.

> The default qualifiers are /STATIC and /DYNAMIC.

### Format

> SHOW SPINLOCKS [/OWNED][/BRIEF|/FULL][/DYNAMIC|/STATIC] [name|/ADDRESS=expression|/INDEX=expression]

### Parameter

> #### name

> Name of the spin lock, fork lock, or device lock structure to be displayed. You can obtain the names of the static system spin locks and fork locks from Table SDA-22. Device lock names are of the form [node$]lock, where node optionally indicates the VAXcluster node name (allocation class) and lock indicates the device and controller identification (for example, HAETAR$DUA).

### Qualifiers

> #### /ADDRESS=expression

> Displays the lock at the address specified in expression. You can use the /ADDRESS qualifier to display a specific device lock; however, the name of the device lock is listed as "Unknown" in the display.

> #### /BRIEF

> Produces a condensed display of the lock information displayed by default by the SHOW SPINLOCKS command, including the following: address, spin lock name or device name, IPL or device IPL, rank, index, ownership depth, number of waiting CPUs, CPU ID of the owner CPU, and interlock status (depth of ownership).

> #### /DYNAMIC

> Displays information for all device locks in the system.

> #### /FULL

> Displays full descriptive and diagnostic information for each displayed spin lock, fork lock, or device lock.

> #### /INDEX=expression

> Displays the system spin lock whose index is specified in expression. You cannot use the /INDEX qualifier to display a device lock.

> #### /OWNED

> Displays information for all spin locks, fork locks, and device locks owned by the SDA current CPU. If a processor does not own any spin locks, SDA displays the following message:

>     No spinlocks currently owned by CPU xx

> The xx represents the CPU ID of the processor.

> #### /STATIC

> Displays information for all system spin locks and fork locks.

### Description

> The SHOW SPINLOCKS command displays status and diagnostic information about the multiprocessing synchronization structures known as spin locks.

> A static spin lock is a spin lock whose data structure is permanently assembled into the system. Static spin locks are accessed as indexes into a vector of longword addresses called the spin lock vector, the address of which is contained in SMP$AR_SPNLKVEC. System spin locks and fork locks are static spin locks. Table SDA-22 lists the static spin locks.

> A dynamic spin lock is a spin lock that is created based on the configuration of a particular system. One such dynamic spin lock is the device lock SYSGEN creates when configuring a particular device. This device lock synchronizes access to the device's registers and certain UCB fields. The operating system creates a dynamic spin lock by allocating space from nonpaged pool, rather than assembling the lock into the system as it does in creating a static spin lock.

> See the OpenVMS VAX Device Support Manual15 for a full discussion of the role of spin locks in maintaining synchronization of kernel mode activities in a multiprocessing environment.

> Table SDA-22 Static Spin Locks
> Name | Description
> --- | ---
> QUEUEAST | Fork lock for queuing ASTs at IPL 6
> FILSYS | Lock on file system structures
> IOLOCK8 | Fork lock for executing a driver fork process at IPL 8
> PR_LK8 | Primary CPU's private lock for IPL 8
> TIMER | Lock for adding and deleting timer queue entries and searching the timer queue
> JIB | Lock for manipulating job nonpaged pool quotas as reflected by the fields JIB$L_BYTCNT and JIB$L_BYTLM in the job information block (JIB)
> MMG | Lock on memory management, PFN database, swapper, modified page writer, and creation of per-CPU database structures
> SCHED | Lock on process control blocks (PCBs), scheduler database, and mutex acquisition and release structures
> IOLOCK9 | Fork lock for executing a driver fork process at IPL 9
> PR_LK9 | Primary CPU's private lock for IPL 9
> IOLOCK10 | Fork lock for executing a driver fork process at IPL 10
> PR_LK10 | Primary CPU's private lock for IPL 10
> IOLOCK11 | Fork lock for executing a driver fork process at IPL 11
> PR_LK11 | Primary CPU's private lock for IPL 11
> MAILBOX | Lock for sending messages to mailboxes
> POOL | Lock on nonpaged pool database
> PERFMON | Lock for I/O performance monitoring
> INVALIDATE | Lock for system space translation buffer (TB) invalidation
> VIRTCONS | Lock for ownership of the virtual console
> HWCLK | Lock on hardware clock database, including the quadword containing the due time of the first timer queue entry (EXE$GQ_1ST_TIME) and the quadword containing the system time (EXE$GQ_SYSTIME)
> MEGA | Lock for serializing access to fork-wait queue
> MCHECK | Lock for synchronizing certain machine error handling
> EMB | Lock for allocating and releasing error logging buffers

> Note ##### 15 This manual has been archived but is available on the OpenVMS Documentation CD-ROM.

> Previous | Next | Contents | Index

> | privacy and legal statement |
> 4556PRO_015.HTML