[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS System Analysis Tools Manual


Previous Contents Index


SHOW ACPI (Integrity servers only)

Displays the contents of Advanced Configuration and Power Interface (ACPI) tables and namespace structures.

Format

SHOW ACPI {/NAMESPACE |/TABLE}
[/ADDRESS = address | /ALL | /CHILDREN] [ident]


Parameter

ident

The name of the table or the namespace structure to be displayed. If an ident is given, /ADDRESS cannot be specified.

Qualifier

/ADDRESS = address

The physical address of the table entry or virtual address of a namespace structure to be displayed. If /ADDRESS is used, no ident may be specified.

/ALL

Specifies that detailed information on each entity is to be displayed. By default, only a brief summary of each entity is given, except when a specific table is displayed.

/CHILDREN

Specifies that all the child namespace structures for a specified namespace entry are to be displayed. /CHILDREN cannot be used with /TABLES.

/NAMESPACE

Specifies that ACPI namespace structures are to be displayed. Either /NAMESPACE or /TABLES must be specified.

/TABLES

Specifies that ACPI tables are to be displayed. Either /NAMESPACE or /TABLES must be specified.

Description

The SHOW ACPI command displays the Advanced Configuration and Power Interface (ACPI) Tables and Namespace structures, either as a one line summary for each entity or in detail. The amount of detail varies for each structure. The structures most interesting to OpenVMS are formatted; others are output as a hexadecimal dump.


Examples

#1

SDA> SHOW ACPI /TABLES
ACPI Tables
-----------
                                                        OEM       ASL
Signature   Physical Address     Length    OEM Id   Table Id   Vendor Id   Rev
---------   -----------------   --------   ------   --------   ---------   ---
RSDP        00000000.3FB2E000   00000028   HP       -          -           02
XSDT        00000000.3FB2E02C   0000007C   HP       zx2000     HP          01
FACP        00000000.3FB373E0   000000F4   HP       zx2000     HP          03
SPCR        00000000.3FB37518   00000050   HP       zx2000     HP          01
DBGP        00000000.3FB37568   00000034   HP       zx2000     HP          01
APIC        00000000.3FB37628   00000084   HP       zx2000     HP          01
SPMI        00000000.3FB375A0   00000050   HP       zx2000     HP          04
CPEP        00000000.3FB375F0   00000034   HP       zx2000     HP          01
SSDT        00000000.3FB33870   00000A14   HP       zx2000     INTL        01
SSDT        00000000.3FB34290   000022E2   HP       zx2000     INTL        01
SSDT        00000000.3FB36580   00000342   HP       zx2000     INTL        01
SSDT        00000000.3FB368D0   00000A16   HP       zx2000     INTL        01
SSDT        00000000.3FB372F0   000000EB   HP       zx2000     INTL        01
FACS        00000000.3FB374D8   00000040   -        -          -           01
DSDT        00000000.3FB2E0E0   00005781   HP       zx2000     INTL        01
HCDP        00000000.3FB2C000   00000088   HP       zx1        HP          00
      

This example shows the default display for the ACPI tables.

#2

SDA> SHOW ACPI /TABLES RSDP
 
ACPI Tables
-----------
RSDP
 
      Physical Address:      00000000.3FB2E000   Length:                  00000028
    OEM Identification:                 "HP"   XSDT PA:        00000000.3FB2E02C
   Revision:                             02
      

This example shows the contents of the Root System Description Pointer (RSDP) table.

#3

SDA> SHOW ACPI /NAMESPACE
ACPI Namespace
--------------
      Node              ACPI      Owner   Object           Operand
     Address            Name       Id      Type            Object          Flags
----------------- ---------------- -- --------------- ----------------- -----------
FFFFFFFF.88253028 \___             00 Device          FFFFFFFF.89523158 End_Of_Peer_List Subtree_Has_Ini
FFFFFFFF.89521BD8   _GPE           00 Local_Scope     00000000.00000000
FFFFFFFF.89523F58     _L14         01 Method          FFFFFFFF.89523F98 End_Of_Peer_List
FFFFFFFF.89521C18   _PR_           00 Local_Scope     00000000.00000000
FFFFFFFF.89521C58   _SB_           00 Device          00000000.00000000 Subtree_Has_Ini
FFFFFFFF.89529098     SBA0         01 Device          00000000.00000000 Subtree_Has_Ini
FFFFFFFF.895290D8       _HID       01 Method          FFFFFFFF.89529118
FFFFFFFF.89529198       _CID       01 Integer         FFFFFFFF.8952AD18                
      

This example shows the default display for the ACPI namespace structures.

#4

SDA> SHOW ACPI/NAMESPACE/CHILDREN _GPE
ACPI Namespace
--------------
      Node              ACPI      Owner   Object           Operand
     Address            Name       Id      Type            Object          Flags
----------------- ---------------- -- --------------- ----------------- -----------
FFFFFFFF.89521BD8 \_GPE            00 Local_Scope     00000000.00000000
FFFFFFFF.89523F58 \_GPE._L14       01 Method          FFFFFFFF.89523F98 End_Of_Peer_List
      

This example shows the summary display for the _GPE (General Purpose Event) package in the ACPI namespace, plus its child node.


SHOW ADDRESS

Displays the page table related information about a memory address.

Format

SHOW ADDRESS address [/PHYSICAL]


Parameter

address

The requested address.

Qualifier

/PHYSICAL

Indicates that a physical address has been given. The SHOW ADDRESS command displays the virtual address that maps to the given physical address.

Description

The SHOW ADDRESS command displays the region of memory that contains the memory address. It also shows all the page table entries (PTEs) that map the page and can show the range of addresses mapped by the given address if it is the address of a PTE. If the virtual address is in physical memory, the corresponding physical address is displayed.

When the /PHYSICAL qualifier is given, the SHOW ADDRESS command displays the virtual address that maps to the given physical address. This provides you with a way to use SDA commands that do not have a /PHYSICAL qualifier when only the physical address of a memory location is known.


Examples

#1

SDA> SHOW ADDRESS 80000000
FFFFFFFF.80000000 is an S0/S1 address
Mapped by Level-3 PTE at: FFFFFFFD.FFE00000 
Mapped by Level-2 PTE at: FFFFFFFD.FF7FF800 
Mapped by Level-1 PTE at: FFFFFFFD.FF7FDFF8 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Also mapped in SPT window at: FFFFFFFF.FFDF0000
Mapped to physical address 00000000.00400000 
      

The SHOW ADDRESS command in this example shows where the address 80000000 is mapped at different page table entry levels.

#2

SDA> SHOW ADDRESS 0
00000000.00000000 is a P0 address
Mapped by Level-3 PTE at: FFFFFFFC.00000000 
Mapped by Level-2 PTE at: FFFFFFFD.FF000000 
Mapped by Level-1 PTE at: FFFFFFFD.FF7FC000 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Not mapped to a physical address 
      

The SHOW ADDRESS command in this example shows where the address 0 is mapped at different page table entry levels.

#3

SDA> SHOW ADDRESS FFFFFFFD.FF000000
FFFFFFFD.FF000000 is the address of a process-private Level-2 PTE
Mapped by Level-1 PTE at: FFFFFFFD.FF7FC000 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Range mapped at level 2: FFFFFFFC.00000000 to FFFFFFFC.00001FFF (1 page) 
Range mapped at level 3: 00000000.00000000 to 00000000.007FFFFF (1024 pages)
Mapped to physical address 00000000.01230000 
      

The SHOW ADDRESS command in this example shows where the address FFFFFFFD.FF7FC000 is mapped at page table entry and the range mapped by the PTE at this address.

#4

SDA> SHOW ADDRESS/PHYSICAL 0
Physical address 00000000.00000000 is mapped to system-space address FFFFFFFF.828FC000
      

The SHOW ADDRESS command in this example shows physical address 00000000.00000000 mapped to system-space address FFFFFFFF.828FC000.

#5

SDA> SHOW ADDRESS/PHYSICAL 029A6000
Physical address 00000000.029A6000 is mapped to process-space address 00000000.00030000 
(process index 0024)
      

The SHOW ADDRESS command in this example shows physical address 00000000.029A6000 mapped to process-space address 00000000.00030000 (process index 0024).


SHOW BUGCHECK

Displays the value, name, and text associated with one or all bugcheck codes.

Format

SHOW BUGCHECK {/ALL (d) | name | number}


Parameters

name

The name of the requested bugcheck code.

number

The value of the requested bugcheck code. The severity bits in the value are ignored.

The parameters name and number and the qualifier /ALL are all mutually exclusive.


Qualifier

/ALL

Displays complete list of all the bugcheck codes, giving their value, name, and text. It is the default.

Description

The SHOW BUGCHECK command displays the value, name, and text associated with bugcheck codes.

Examples

#1

SDA> SHOW BUGCHECK 104
0100  DIRENTRY       ACP failed to find same directory entry
      

The SHOW BUGCHECK command in this example shows the requested bugcheck by number, ignoring the severity (FATAL).

#2

SDA> SHOW BUGCHECK DECNET
08D0  DECNET         DECnet detected a fatal error
      

The SHOW BUGCHECK command in this example shows the requested bugcheck by name.

#3

SDA> SHOW BUGCHECK   
BUGCHECK codes and texts
------------------------
0008  ACPMBFAIL      ACP failure to read mailbox
0010  ACPVAFAIL      ACP failure to return virtual address space
0018  ALCPHD         Allocate process header error
0020  ALCSMBCLR      ACP tried to allocate space already allocated
   .
   .
   .
      

The SHOW BUGCHECK command in this example shows the requested bugcheck by displaying all codes.


SHOW CALL_FRAME

Displays the locations and contents of the quadwords representing a procedure call frame.

Format

SHOW CALL_FRAME { [starting-address]
| /EXCEPTION_FRAME = intstk-address
| /NEXT_FRAME | /SUMMARY | /ALL}


Parameter

starting-address

For Alpha, an expression representing the starting address of the procedure call frame to be displayed. If no starting-address is given, the default starting address is the contents of the frame pointer (FP) register of the SDA current process. For a process that uses pthreads, the following SDA command can be used to display the starting addresses for all pthreads:


SDA> pthread thread -o u 

For Integrity servers, the starting address is an expression representing one of the following:

  • The invocation context handle of a frame.
  • The address of an exception frame. This is equivalent to the following SDA command:


    SDA> SHOW CALL_FRAME /EXCEPTION_FRAME=intstk-address 
    
  • The address of a Thread Environment Block (TEB).
    For a list of all TEBs for the process, use the following SDA command:


    SDA> pthread thread -o u 
    

If no starting address is given, the default starting address is the invocation context handle of the current procedure in the SDA current process.


Qualifiers

/ALL

Displays details of all call frames beginning at the current frame and continuing until bottom of stack (equivalent to SHOW CALL and repeated execution of a SHOW CALL/NEXT command).

/EXCEPTION_FRAME=intstk-address

(Integrity servers only) Provides an alternate starting address for SHOW CALL_FRAME. intstk-address is the address of an exception frame from which SDA creates an initial invocation context and displays the procedure call frame.

/NEXT_FRAME

Displays the procedure call frame starting at the address stored in the frame longword of the last call frame displayed by this command. You must have issued a SHOW CALL_FRAME command previously in the current SDA session in order to use the /NEXT_FRAME qualifier to the command.

/SUMMARY

Provides a one-line summary for each call frame, including exception frames, system-service entry frames, ASTs, KPBs, and so on, until reaching the bottom of the stack.

Description

Whenever a procedure is called, information is stored on the stack of the calling routine in the form of a procedure call frame. The SHOW CALL_FRAME command displays the locations and contents of the call frame. The starting address of the call frame is determined from the specified starting address, the /NEXT_FRAME qualifier, or the address contained in the SDA current process frame register (the default action).

When using the SHOW CALL_FRAME/NEXT_FRAME command to follow a chain of call frames, SDA signals the end of the chain by the following message:


Cannot display further call frames (bottom of stack) 
This message indicates that the saved frame in the previous call frame has a zero value (for Alpha) or that the current frame is marked Bottom of Stack (for Integrity servers).

Examples

#1

SDA> SHOW CALL_FRAME
Call Frame Information
----------------------
        Stack Frame Procedure Descriptor
Flags:  Base Register = FP, No Jacket, Native
        Procedure Entry: FFFFFFFF.837E9F10              EXCEPTION_PRO+01F10
        Return address on stack = FFFFFFFF.837E8A1C     EXE$CONTSIGNAL_C+0019C
Registers saved on stack
------------------------
7FF95F98  FFFFFFFF.FFFFFFFB  Saved R2
7FF95FA0  FFFFFFFF.8042AEA0  Saved R3     EXCEPTION_NPRW+040A0
7FF95FA8  00000000.00000002  Saved R5
7FF95FB0  FFFFFFFF.804344A0  Saved R13    SCH$CLREF+00188
7FF95FB8  00000000.7FF9FC00  Saved R29
.
.
.
SDA> SHOW CALL_FRAME/NEXT_FRAME
Call Frame Information
----------------------
        Stack Frame Procedure Descriptor
Flags:  Base Register = FP, No Jacket, Native
        Procedure Entry: FFFFFFFF.800FA388              RMS_NPRO+04388
        Return address on stack = FFFFFFFF.80040BFC     EXCEPTION_NPRO+00BFC
Registers saved on stack
------------------------
7FF99F60  FFFFFFFF.FFFFFFFD  Saved R2     
7FF99F68  FFFFFFFF.80425BA0  Saved R3     EXCEPTION_NPRW+03DA0
7FF99F70  FFFFFFFF.80422020  Saved R4     EXCEPTION_NPRW+00220
7FF99F78  00000000.00000000  Saved R5     
7FF99F80  FFFFFFFF.835C24A8  Saved R6     RMS_PRO+004A8
7FF99F88  00000000.7FF99FC0  Saved R7     
7FF99F90  00000000.7FF9FDE8  Saved R8     
7FF99F98  00000000.7FF9FDF0  Saved R9     
7FF99FA0  00000000.7FF9FE78  Saved R10    
7FF99FA8  00000000.7FF9FEBC  Saved R11    
7FF99FB0  FFFFFFFF.837626E0  Saved R13    EXE$OPEN_MESSAGE+00088
7FF99FB8  00000000.7FF9FD70  Saved R29    
.
.
.
SDA> SHOW CALL_FRAME/NEXT_FRAME
Call Frame Information
----------------------
        Stack Frame Procedure Descriptor
Flags:  Base Register = FP, No Jacket, Native
        Procedure Entry: FFFFFFFF.835C2438              RMS_PRO+00438
        Return address on stack = FFFFFFFF.83766020     EXE$OPEN_MESSAGE_C+00740
Registers saved on stack
------------------------
7FF9FD88  00000000.7FF9FDA4  Saved R2     
7FF9FD90  00000000.7FF9FF00  Saved R3     
7FF9FD98  00000000.7FFA0050  Saved R29    
 
      

The SHOW CALL_FRAME commands in this SDA session follow a chain of call frames from that specified in the frame of the SDA current process.

#2

SDA> SHOW CALL/SUMMARY
Call Frame Summary
------------------ 
 
     Frame Type           Handle           Current PC 
-------------------- -----------------  ----------------- 
Exception Dispatcher 00000000.7FF43EB0  FFFFFFFF.8049E160  EXCEPTION_MON+5E360 
Register Stack Frame 00000000.7FF12180  00000000.000122C0  KP_SAMPLE+122C0 
Memory Stack Frame   00000000.7FF43ED0  FFFFFFFF.8066B440  EXE$CMKRNL_C+00330 
Memory Stack Frame   00000000.7FF43F20  FFFFFFFF.80194890  EXE$SS_DISP_C+00400 
SS Dispatcher        00000000.3FFFDFC0  FFFFFFFF.8018D240  SWIS$ENTER_KERNEL_SERVICE_C+003E0 
Register Stack Frame 000007FD.BFF58000  00000000.000124C0  KP_SAMPLE+124C0 
KP Start Frame       00000000.7AC95A20  FFFFFFFF.80161670  EXE$KP_START_C+003C0 
Memory Stack Frame   00000000.7AC95B50  00000000.00012CE0  KP_SAMPLE+12CE0 
Memory Stack Frame   00000000.7AC95BC0  00000000.000126F0  KP_SAMPLE+126F0 
Base Frame           00000000.7AC95BE0  00000000.7ADE0BB0  DCL+82BB0 
Bottom of stack 
 
      

This example of SHOW CALL/SUMMARY on an Integrity server system shows the call frame summary of a process that has triggered an exception. The exception occurred while running a program called KP_SAMPLE which has invoked the $CMKRNL system service.


SHOW CBB

Displays contents of a Common Bitmask Block.


Format

SHOW CBB address


Parameters

address

The address of the Common Bitmask Block. This is required.

Qualifiers

None.

Description

The contents of the specified common bitmask block are displayed: the number of valid bits, the interlock state, the unit size and count, and the current settings for the bits in the bitmask.

Example


SDA>  SHOW CBB SMP$GS_CBB_ACTIVE_SET
Common Bitmask Block at FFFFFFFF.8180CA00 
----------------------------------------- 
 
  Valid bits:                     00000040   State:          00000000.00000000 
  Unit count:                         0001   Unit size:               QUADWORD 
 
  Unit bitmask: 
       ........ ........ 00000000 00000001   00000000
 
 
      

This example shows the active-CPU common bitmask block for a single-CPU system.


SHOW CEB

Displays information about Common Event flag Blocks, also known as Common Event flag clusters.


Format

SHOW CEB [address | /ALL]


Parameters

address

The address of a common event flag block. Detailed information is displayed for the specified common event flag block.

Qualifiers

/ALL

Specifies that detailed information is to be displayed for each common event flag block. By default, a one-line summary is output for each common event flag block.

Description

The contents of one or all common event flag blocks is displayed. In one-line summary format, the address, name, creator process, reference count, current settings for the 32 event flags in the cluster, and the UIC of the cluster are displayed. In detailed format, the address of the cluster's Object Rights Block (ORB) and the count of waiting threads are also displayed, with lists of all associated processes and waiting threads.

You cannot specify both an address and /ALL; they are mutually exclusive.

SHOW COMMON_EVENT_BLOCK is a synonym for SHOW CEB.


Examples


 
1. SDA> SHOW CEB 
Common Event Flags 
------------------ 
 
Address       Name              Creator       RefCount  EvtFlags       UIC        Flags 
-------- -------------- --------------------- --------  --------  --------------  ----- 
81E1D340 clus6          0000009B Test1        00000001  00000000     [11,1]       Permanent 
81E294C0 clus5          0000009B Test2        00000001  00000000     [11,1]       Permanent 
8213A280 IPCACP_FLAGS   00000086 IPCACP       00000001  00000000      [1,*] 
 

This example shows the one-line summary of all common event flag blocks.


2. SDA> SHOW CEB 81E294C0 
Common Event Flags 
------------------ 
 
CEB Address:                      81E294C0   Name:                       clus5 
Creator process EPID:             0000009B   Name:                       Test2 
Event flag vector:                00000000   Reference count:         00000001 
ORB address:                      829F75B0   Wait count:              00000001 
UIC:                                [11,1]   Flags:                   00000002  Permanent 
 
              Associated Processes               Waiting Threads 
       -----------------------------------   ------------------------ 
         PCB       EPID         Name           KTB     Indx  WaitMask 
       --------  --------  ---------------   --------  ----  -------- 
       81E1C740  000000A4  BISHOP_47         81E1C740  0000  FFFFFF84 
 

This example shows the details for the CEB at the given address.


SHOW CLASS

Displays information about scheduling classes that are active in the system or dump being analyzed.

Format

SHOW CLASS [class-name | /ALL]


Parameters

class-name

Name of the class to be displayed.

Qualifiers

/ALL

Indicates that details of all active classes are to be displayed.

Description

SDA displays information about active scheduling classes in the system. By default, a summary of the classes is displayed.

Examples

#1

SDA> SHOW CLASS
Scheduling Classes 
------------------ 
 
                  Original  Current     Time    Process 
   Class Name     Quantum   Quantum   Restrict   Count 
----------------  --------  --------  --------  -------- 
BISH              000000C6  000000C6  00FE0000  00000001 
      

This example shows the summary display of the SHOW CLASS command.

#2

SDA> SHOW CLASS bish
Class name:                       "BISH" 
Original quantum:                 000000C6 (99%) 
Current quantum:                  000000C6 (99%) 
Time restrictions:                00FE0000 (until 23:59) 
 
Processes currently in class: 
 
            PCB         EPID           Name 
          --------    --------    --------------- 
          83617D40    00000225    Milord_RTA1: 
      

This example shows the detailed display of the SHOW CLASS command.


SHOW CLUSTER

Displays connection manager and system communications services (SCS) information for all nodes in a cluster.

Format

SHOW CLUSTER { [{/ADDRESS=n | /CIRCUIT=pb-addr | /CSID=csid | /NODE=name}] | /SCS }


Parameters

None.

Qualifiers

/ADDRESS=n

Displays only the OpenVMS Cluster system information for a specific OpenVMS Cluster member node, given the address of the cluster system block (CSB) for the node. This is mutually exclusive with the /CIRCUIT=pb-addr, /CSID=csid, and /NODE=name qualifiers.

/CIRCUIT=pb-addr

Displays only the OpenVMS Cluster system information for a specific path, where pb-addr is the address of its path block. This qualifier is mutually exclusive with the /ADDRESS=n, /CSID=csid, and /NODE=name qualifiers.

/CSID=csid

Displays only the OpenVMS Cluster system information for a specific OpenVMS Cluster member node. The value csid is the cluster system identification number (CSID) of the node to be displayed. You can find the CSID for a specific node in a cluster by examining the CSB list display of the SHOW CLUSTER command. Other SDA displays refer to a system's CSID. For instance, the SHOW LOCKS command indicates where a lock is mastered or held by CSID. This is mutually exclusive with the /ADDRESS=n, /CIRCUIT=pb-addr, and /NODE=name qualifiers.

/NODE=name

Displays only the OpenVMS Cluster system information for a specific OpenVMS Cluster member node, given its SCS node name. This is mutually exclusive with the /ADDRESS=n, /CIRCUIT=pb-addr, and /CSID=csid qualifiers.

/SCS

Displays a view of the cluster as seen by SCS.

Description

The SHOW CLUSTER command provides a view of the OpenVMS Cluster system from either the perspective of the connection manager (the default behavior), or from the perspective of the port driver or drivers (if the /SCS qualifier is used).

OpenVMS Cluster as Seen by the Connection Manager

The SHOW CLUSTER command provides a series of displays.

The OpenVMS Cluster summary display supplies the following information:

  • Number of votes required for a quorum
  • Number of votes currently available
  • Number of votes allocated to the quorum disk
  • Status summary indicating whether or not a quorum is present

The CSB list displays information about the OpenVMS Cluster system blocks (CSBs) currently in operation; one CSB is assigned to each node of the cluster. For each CSB, the CSB list displays the following information:

  • Address of the CSB
  • Name of the OpenVMS Cluster node it describes
  • CSID associated with the node
  • Number of votes (if any) provided by the node
  • State of the CSB
  • Status of the CSB

For information about the state and status of nodes, see the description of the ADD CLUSTER command of the SHOW CLUSTER utility in the HP OpenVMS System Management Utilities Reference Manual.

The cluster block display includes information recorded in the cluster block (CLUB), including a list of activated flags, a summary of quorum and vote information, and other data that applies to the cluster from the perspective of the node for which the SDA is being run.

The cluster failover control block display provides detailed information concerning the cluster failover control block (CLUFCB). The cluster quorum disk control block display provides detailed information from the cluster quorum disk control block (CLUDCB).

Subsequent displays provide information for each CSB listed previously in the CSB list display. Each display shows the state and flags of a CSB, as well as other specific node information. (See the ADD MEMBER command of the SHOW CLUSTER utility in the HP OpenVMS System Management Utilities Reference Manual for information about the flags for OpenVMS Cluster nodes.)

If any of the qualifiers /ADDRESS=n, /CSID=csid, or /NODE=name are specified, then the SHOW CLUSTER command displays only the information from the CSB of the specified node.

OpenVMS Cluster as Seen by the Port Driver

The SHOW CLUSTER/SCS command provides a series of displays.

The SCS listening process directory lists those processes that are listening for incoming SCS connect requests. For each of these processes, this display records the following information:

  • Address of its directory entry
  • Connection ID
  • Name
  • Explanatory information, if available

The SCS systems summary display provides the system block (SB) address, node name, system type, system ID, and the number of connection paths for each SCS system. An SCS system can be a OpenVMS Cluster member, storage controller, or other such device.

Subsequent displays provide detailed information for each of the system blocks and the associated path blocks. The system block displays include the maximum message and datagram sizes, local hardware and software data, and SCS poller information. Path block displays include information that describes the connection, including remote functions and other path-related data.

If the qualifier /CIRCUIT=pb-addr is specified, the SHOW CLUSTER command displays only the information from the specified path block.


Examples

#1

SDA> SHOW CLUSTER
OpenVMS Cluster data structures
               --- OpenVMS Cluster Summary ---
     Quorum   Votes   Quorum Disk Votes   Status Summary
     ------   -----   -----------------   --------------
        2       2            1            qf_dynvote,qf_vote,quorum
                    --- CSB list ---
Address   Node    CSID      Votes   State     Status
-------   ----    ----      -----   -----     ------
805FA780  FLAM5   00010006    0     local   member,qf_same,qf_noaccess
8062C400  ROMRDR  000100ED    1     open    member,qf_same,qf_watcher,qf_active
8062C780  VANDQ1  000100EF    0     open    member,qf_same,qf_noaccess
             --- Cluster Block (CLUB) 805FA380 ---
Flags: 16080005 cluster,qf_dynvote,init,qf_vote,qf_newvote,quorum
Quorum/Votes                  2/2    Last transaction code          02
Quorum Disk Votes               1    Last trans. number            596
Nodes                           3    Last coordinator CSID    000100EF
Quorum Disk               $1$DIA0    Last time stamp       31-DEC-1992
Found Node SYSID     00000000FC03                             17:26:35
Founding Time          3-JAN-1993    Largest trans. id        00000254
                         21:04:21    Resource Alloc. retry           0
Index of next CSID           0007    Figure of Merit          00000000
Quorum Disk Cntrl Block  805FADC0    Member State Seq. Num        0203
Timer Entry Address      00000000    Foreign Cluster          00000000
CSP Queue                   empty                                     
     --- Cluster Failover Control Block (CLUFCB) 805FA4C0 ---
Flags: 00000000 
Failover Step Index      00000037    CSB of Synchr. System    8062C780    
Failover Instance ID     00000254                                         
     --- Cluster Quorum Disk Control Block (CLUDCB) 805FADC0 ---
State     : 0002 qs_rem_act
Flags     : 0100 qf_noaccess
CSP Flags : 0000 
Iteration Counter               0             UCB address     00000000
Activity Counter                0             TQE address     805FAE00
Quorum file LBN          00000000             IRP address     00000000
                                              Watcher CSID    000100ED
     --- FLAM5 Cluster System Block (CSB) 805FA780 ---
State:  0B local
Flags:  070260AA member,qf_same,qf_noaccess,selected,local,status_rcvd,send_status
Cpblty: 00000000 
SWVers: 7.0
HWName: DEC 3000 Model 400
Quorum/Votes       1/0    Next seq. number    0000    Send queue      00000000
Quor. Disk Vote      1    Last seq num rcvd   0000    Resend queue    00000000
CSID          00010006    Last ack. seq num   0000    Block xfer Q.   805FA7D8
Eco/Version       0/23    Unacked messages       0    CDT address     00000000
Reconn. time  00000000    Ack limit              0    PDT address     00000000
Ref. count           2    Incarnation   1-JAN-1993    TQE address     00000000
Ref. time  31-AUG-1992                    00:00:00    SB address      80421580
              17:26:35    Lock mgr dir wgt       0    Current CDRP    00000001
     --- ROMRDR Cluster System Block (CSB) 8062C400 ---
State:  01 open
Flags:  0202039A member,qf_same,cluster,qf_active,selected,status_rcvd
Cpblty: 00000000 
SWVers: 7.0
HWName: DEC 3000 Model 400
 
Quorum/Votes       2/1    Next seq. number    B350    Send queue      00000000
Quor. Disk Vote      1    Last seq num rcvd   E786    Resend queue    00000000
CSID          000100ED    Last ack. seq num   B350    Block xfer Q.   8062C458
Eco/Version       0/22    Unacked messages       1    CDT address     805E8870
Reconn. time  00000000    Ack limit              3    PDT address     80618400
Ref. count           2    Incarnation  19-AUG-1992    TQE address     00000000
Ref. time  19-AUG-1992                    16:15:00    SB address      8062C140
              16:17:08    Lock mgr dir wgt       0    Current CDRP    00000000
     --- VANDQ1 Cluster System Block (CSB) 8062C780 ---
State:  01 open
Flags:  020261AA member,qf_same,qf_noaccess,cluster,selected,status_rcvd
Cpblty: 00000000 
SWVers: 7.0
HWName: DEC 3000 Model 400
Quorum/Votes       1/0    Next seq. number    32B6    Send queue      00000000
Quor. Disk Vote      1    Last seq num rcvd   A908    Resend queue    00000000
CSID          000100EF    Last ack. seq num   32B6    Block xfer Q.   8062C7D8
Eco/Version       0/23    Unacked messages       1    CDT address     805E8710
Reconn. time  00000000    Ack limit              3    PDT address     80618400
Ref. count           2    Incarnation  17-AUG-1992    TQE address     00000000
Ref. time  19-AUG-1992                    15:37:06    SB address      8062BCC0
              16:21:22    Lock mgr dir wgt       0    Current CDRP    00000000
         --- SWPCTX Cluster System Block (CSB) 80D3B1C0 ---
State:  0B local
Flags:  030A60AA member,qf_same,qf_noaccess,selected,send_ext_status,local,status_rcvd
Cpblty: 00000037 rm8sec,vcc,dts,cwcreprc,threads
SWVers: V7.0
HWName: DEC 3000 Model 400
Quorum/Votes       1/1    Next seq. number    0000    Send queue      00000000
Quor. Disk Vote      1    Last seq num rcvd   0000    Resend queue    00000000
CSID          00010001    Last ack. seq num   0000    Block xfer Q.   80D3B218
Eco/Version       0/26    Unacked messages       0    CDT address     00000000
Reconn. time  00000000    Ack limit              0    PDT address     00000000
Ref. count           2    Incarnation  12-JUL-1996    TQE address     00000000
Ref. time  16-JUL-1996                    15:36:17    SB address      80C50800
              16:15:48    Lock mgr dir wgt       0    Current CDRP    00000001
      

This example illustrates the default output of the SHOW CLUSTER command.

#2

SDA> SHOW CLUSTER/SCS
OpenVMS Cluster data structures 
-------------------------- 
 
                --- SCS Listening Process Directory --- 
 
Entry Address     Connection ID     Process Name           Information 
-------------     -------------     ------------           ----------- 
 
  80C71EC0          74D20000        SCS$DIRECTORY          Directory Server 
  80C72100          74D20001        MSCP$TAPE              NOT PRESENT HERE 
  80E16940          74D20002        MSCP$DISK              MSCP$DISK 
  80E23B40          74D20003        VMS$SDA_AXP            Remote SDA 
  80E23B40          74D20003        VMS$SDA_AXP            Remote SDA 
  80E25540          74D20004        VMS$VAXcluster         ................ 
  80E29E80          74D20005        SCA$TRANSPORT 
  813020C0          74D20053        PATHWORKScluster       .....TurboServer 
 
                   --- SCS Systems Summary --- 
 
  SB Address     Node      Type       System ID         Paths 
  ----------     ----      ----       ---------         ----- 
 
  8493BC00      ARUSHA     VMS       000000004CA1         2 
  80E23800      HSJ201     HSJ       4200101A1B20         1 
  80E3FF40      ORNOT      VMS       000000004CA7         2 
  80E43F40      LOADQ      VMS       000000004C31         2 
  80E473C0      HSJ300     HSJ       420010051D20         1 
  80E47CC0      HSJ101     HSJ       420010081720         1 
  80E47D40      HSJ100     HSJ       4200100B1520         1 
  80E478C0      HSJ600     HSJ       420010070920         1 
  80E49180      HSJ401     HSJ       4200100D0320         1 
  80E47DC0      HSJ301     HSJ       420010091F20         1 
  80E47E40      HSJ601     HSJ       4200100A0B20         1 
  80E49500      HSJ400     HSJ       4200100C0120         1 
  80E5BF80      CHOBE      VMS       000000004CD6         2 
  80E5F080      ETOSHA     VMS       000000004CF3         2 
  80E5FC00      VMS        VMS       000000004C7A         2 
  80E4FF80      HSJ501     HSJ       4200101C0720         1 
  80E5FD80      HSJ200     HSJ       420010191920         1 
  80E5FE80      HSJ500     HSJ       4200101B0520         1 
  80E5FE00      IPL31      VMS       000000004F52         2 
  80E59F80      ZAPNOT     VMS       000000004CBB         2 
  80E61F80      ALTOS      VMS       000000004D0F         2 
  80E72000      TSAVO      VMS       000000004CFE         2 
  80ED5D00      SLYTHE     VMS       000000004DD1         1 
  80EDDD00      AZSUN      VMS       000000004D56         1 
  80EDDE00      CALSUN     VMS       000000004EA4         1 
  80EDFC00      4X4TRK     VMS       00000000FF26         1 
  80EE93C0      GNRS       VMS       00000000FC2B         1 
  80EE94C0      IXIVIV     VMS       000000004E56         1 
  80EF1A80      CLAIR      VMS       000000004CDF         1 
  80EF1C00      INT4       VMS       00000000FD70         1 
  80EFDF80      SCOP       VMS       00000000FC87         1 
  80EFFAC0      MOCKUP     VMS       00000000FCD5         1 
 
                    --- ARUSHA System Block (SB) 8493BC00 --- 
 
System ID            000000004CA1    Local software type          VMS 
Max message size              216    Local software vers.         V7.2 
Max datagram size             576    Local software incarn.   DF4AC300 
Local hardware type          ALPH                             009F7570 
Local hardware vers. 000000000003    SCS poller timeout           5AD3 
                     040400000000    SCS poller enable mask         27 
Status:  00000000 
 
                    --- Path Block (PB) 80E55F80 --- 
 
                Status:  0020  credit 
 
Remote sta. addr.    000000000016    Remote port type          00000010 
Remote state                 ENAB    Number of data paths             2 
Remote hardware rev.     00000008    Cables state            A-OK B-OK 
Remote func. mask        ABFF0D00    Local state                   OPEN 
Reseting port                  16    Port dev. name               PNA0 
Handshake retry cnt.            2    SCS MSGBUF address        80E4C528 
Msg. buf. wait queue     80E55FB8    PDT address               80E2A180 
 
                    --- Path Block (PB) 80ED0900 --- 
 
                Status:  0020  credit 
 
Remote sta. addr.    0000000000DF    Remote port type                NI 
Remote state                 ENAB    Number of data paths             2 
Remote hardware rev.     00000104    Cables state            A-OK B-OK 
Remote func. mask        83FF0180    Local state                   OPEN 
Reseting port                  00    Port dev. name               PEA0 
Handshake retry cnt.            3    SCS MSGBUF address        80ED19A0 
Msg. buf. wait queue     80ED0938    PDT address               80EC3C70 
 
   .
   .
   .
      

This example illustrates the output of the SHOW CLUSTER /SCS command.


SHOW CONNECTIONS

Displays information about all active connections between System Communications Services (SCS) processes or a single connection.

Format

SHOW CONNECTIONS [ {/ADDRESS=cdt-address | /NODE=name | /SYSAP=name } ]


Parameters

None.

Qualifiers

/ADDRESS=cdt-address

Displays information contained in the connection descriptor table (CDT) for a specific connection. You can find the cdt-address for any active connection on the system in the CDT summary page display of the SHOW CONNECTIONS command. In addition, CDT addresses are 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.

/NODE=name

Displays all CDTs associated with the specified remote SCS node name.

/SYSAP=name

Displays all CDTs associated with the specified local SYSAP.

Description

The SHOW CONNECTIONS command provides a series of displays.

The CDT summary page lists information regarding each connection on the local system, including the following:

  • CDT address
  • Name of the local process with which the CDT is associated
  • Connection ID
  • Current state
  • Name of the remote node (if any) to which it is currently connected

The CDT summary page concludes with a count of CDTs that are free and available to the system.

SHOW CONNECTIONS next displays a page of detailed information for each active CDT listed previously.


Example


SDA> SHOW CONNECTIONS
              --- CDT Summary Page ---
CDT Address   Local Process     Connection ID     State       Remote Node
-----------   -------------     -------------     -----       -----------
 805E7ED0     SCS$DIRECTORY       FF120000        listen       
 805E8030     MSCP$TAPE           FF120001        listen       
 805E8190     VMS$VMScluster      FF120002        listen       
 805E82F0     MSCP$DISK           FF120003        listen       
 805E8450     SCA$TRANSPORT       FF120004        listen       
 805E85B0     MSCP$DISK           FF150005        open         VANDQ1
 805E8710     VMS$VMScluster      FF120006        open         VANDQ1
 805E8870     VMS$VMScluster      FF120007        open         ROMRDR
 805E89D0     MSCP$DISK           FF120008        open         ROMRDR
 805E8C90     VMS$DISK_CL_DRVR    FF12000A        open         ROMRDR
 805E8DF0     VMS$DISK_CL_DRVR    FF12000B        open         VANDQ1
 805E8F50     VMS$TAPE_CL_DRVR    FF12000C        open         VANDQ1
Number of free CDT's:  188
          --- Connection Descriptor Table (CDT) 80C44850 ---
State:  0001 listen               Local Process:        MSCP$TAPE
Blocked State:  0000
Local Con. ID   899F0003    Datagrams sent         0    Message queue   80C4488C
Remote Con. ID  00000000    Datagrams rcvd         0    Send Credit Q.  80C44894
Receive Credit         0    Datagram discard       0    PB address      00000000
Send Credit            0    Message Sends          0    PDT address     00000000
Min. Rec. Credit       0    Message Recvs          0    Error Notify    822FFCC0
Pend Rec. Credit       0    Mess Sends NoFP        0    Receive Buffer  00000000
Initial Rec. Credit    0    Mess Recvs NoFP        0    Connect Data    00000000
Rem. Sta.   000000000000    Send Data Init.        0    Aux. Structure  00000000
Rej/Disconn Reason     0    Req Data Init.         0    Fast Recvmsg Rq 00000000
Queued for BDLT        0    Bytes Sent             0    Fast Recvmsg PM 00000000
Queued Send Credit     0    Bytes rcvd             0    Change Affinity 00000000
                            Total bytes map        0
      --- Connection Descriptor Table (CDT) 805E8030 ---
State:  0001 listen           Local Process:        MSCP$TAPE       
Blocked State:  0000 
Local Con. ID   FF120001    Datagrams sent         0    Message queue   805E8060
Remote Con. ID  00000000    Datagrams rcvd         0    Send Credit Q.  805E8068
Receive Credit         0    Datagram discard       0    PB address      00000000
Send Credit            0    Messages Sent          0    PDT address     00000000
Min. Rec. Credit       0    Messages Rcvd.         0    Error Notify    804540D0
Pend Rec. Credit       0    Send Data Init.        0    Receive Buffer  00000000
Initial Rec. Credit    0    Req Data Init.         0    Connect Data    00000000
Rem. Sta.   000000000000    Bytes Sent             0    Aux. Structure  00000000
Rej/Disconn Reason     0    Bytes rcvd             0                            
Queued for BDLT        0    Total bytes map        0                            
Queued Send Credit     0                                                        
   .
   .
   .
      

This example shows the default output of the SHOW CONNECTIONS command.


Previous Next Contents Index