[OpenVMS documentation]
[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
Updated: 11 December 1998

OpenVMS VAX System Dump Analyzer Utility Manual


Previous Contents Index

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

SHOW CLUSTER

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

Format

SHOW CLUSTER {/CSID=csid|/NODE=name|/SCS}


Parameters

None.

Qualifiers

/CSID=csid

Displays VAXcluster system information for a specific VAXcluster member node. The value csid is the cluster system identification number (CSID) of the node to be displayed.7

/NODE=name

Displays VAXcluster system information for a specific VAXcluster member node. The value name is the name of the node to be displayed.

/SCS

Displays a view of the cluster as seen by SCS.

Description

By default, the SHOW CLUSTER command provides a view of the VAXcluster system from the perspective of the connection manager. When you use the /SCS qualifier, however, SHOW CLUSTER provides a view of the cluster from the perspective of the port driver or drivers.

VAXcluster as Seen by the Connection Manager

The SHOW CLUSTER command provides a series of displays.

The VAXcluster summary display supplies the following information:

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

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 SDA is being run.

The cluster failover control block display provides detailed information concerning the cluster failover control block (CLUFCB), and 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 Show Cluster utility section of the OpenVMS System Management Utilities Reference Manual for information about the flags for VAXcluster nodes.)

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

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 VAXcluster member, HSC, UDA, 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.


Examples

#1

SDA> SHOW CLUSTER
VAXcluster data structures 
-------------------------- 
                   --- VAXcluster Summary --- 
 
         Quorum   Votes   Quorum Disk Votes   Status Summary 
         ------   -----   -----------------   -------------- 
            2       3            1            quorum 
 
 
                        --- CSB list --- 
 
Address   Node    CSID      Votes   State     Status 
-------   ----    ----      -----   -----     ------ 
 
 
803686F0  SOLLY   000100C8    1     open    member,qf_active 
80368550  GUS     000100C9    1     open    member,qf_active 
80367B90  DORIS   000100C5    1     open    member,qf_active 
 
 
                 --- Cluster Block (CLUB) 801C3F70 --- 
 
Flags: 10080001 cluster,init,quorum 
 
 
Quorum/Votes                  2/3    Last transaction code          02 
Quorum Disk Votes               1    Last trans. number           1126 
Nodes                           3    Last coordinator CSID    00000000 
Quorum Disk             $255$DUA2    Last time stamp       26-MAR-1993 
Found Node SYSID     0000000008A0                             18:52:32 
Founding Time          3-DEC-1992    Largest trans. id        00000466 
                         00:01:44    Resource Alloc. retry           0 
Index of next CSID           00D2    Figure of Merit          00000000 
Quorum Disk Cntrl Block  80334E00    Member State Seq. Num        0190 
Timer Entry Address      00000000    Foreign Cluster          00000000 
CSP Queue                   empty 
 
 
         --- Cluster Failover Control Block (CLUFCB) 801C407C --- 
 
Flags: 00000000 
 
Failover Step Index      00000028    CSB of Synchr. System    803686F0 
Failover Instance ID     00000466 
 
 
         --- Cluster Quorum Disk Control Block (CLUDCB) 80334E00 --- 
 
State: 0001 qs_not_ready 
Flags: 0000 
 
Iteration Counter               0              UCB address    00000000 
Activity Counter                0              TQE address    80419F40 
Quorum file LBN          00000000              IRP address    803665A0 
 
 
         --- SOLLY Cluster System Block (CSB) 803686F0 --- 
 
State: 01 open 
Flags: 02020302 member,cluster,qf_active,selected,status_rcvd 
 
 
Quorum/Votes       2/1    Next seq. number    0247    Send queue      00000000 
Quor. Disk Vote      1    Last seq num rcvd   0314    Resend queue    00000000 
CSID          000100C8    Last ack. seq num   0247    Block xfer Q.      empty 
Eco/Version       0/12    Unacked messages       1    CDT address     801C28F0 
Reconn. time  00000059    Ack limit              4    PDT address     801CEA20 
Ref. count           2    Incarnation  18-DEC-1993    TQE address     00000000 
Ref. time  18-DEC-1993                    08:52:20    SB address      8041B6E0 
              08:53:58    Lock mgr dir wgt       1    Current CDRP    00000000 
 
      

This example shows the screen displays for the SHOW CLUSTER command. (Displays for nodes GUS and DORIS, similar to that for node SOLLY, are also included in the SHOW CLUSTER output but have been omitted from this example.)

#2

SDA> SHOW CLUSTER /CSID=000100C8
VAXcluster data structures 
-------------------------- 
         --- SOLLY Cluster System Block (CSB) 803686F0 --- 
 
State: 01 open 
Flags: 02020302 member,cluster,qf_active,selected,status_rcvd 
 
Quorum/Votes       2/1    Next seq. number    0247    Send queue      00000000 
Quor. Disk Vote      1    Last seq num rcvd   0314    Resend queue    00000000 
CSID          000100C8    Last ack. seq num   0247    Block xfer Q.      empty 
Eco/Version       0/12    Unacked messages       1    CDT address     801C28F0 
Reconn. time  00000059    Ack limit              4    PDT address     801CEA20 
Ref. count           2    Incarnation  18-DEC-1993    TQE address     00000000 
Ref. time  18-DEC-1993                    08:52:20    SB address      8041B6E0 
              08:53:58    Lock mgr dir wgt       1    Current CDRP    00000000 
 
      

This example shows the use of the /CSID qualifier to obtain information about a specific node (in this instance, node SOLLY).

#3

SDA> SHOW CLUSTER /NODE=LEON01
VAXcluster data structures 
-------------------------- 
 
      --- LEON01 Cluster System Block (CSB) 9863BC00 --- 
 
State: 01 open 
Status 0206E1A2 member,qf_noaccess,cluster,selected,status_rcvd 
                cwps,rangelock,dyn_remaster,dts,vcc 
Cpblty 00000001 rm8sec 
 
Quorum/Votes       4/1    Next seq. number    5D8B    Send queue      987C3F80 
Quor. Disk Vote     10    Last seq num rcvd   3302    Resend queue    00000000 
CSID          00200093    Last ack. seq num   5D8A    Block xfer Q.      empty 
Eco/Version       0/24    Unacked messages       0    CDT address     9830C600 
Reconn. time  00000000    Ack limit              3    PDT address     98388590 
Ref. count           2    Incarnation  26-JAN-1993    TQE address     00000000 
Ref. time  26-JAN-1993                    15:14:37    SB address      98638140 
              15:28:43    Lock mgr dir wgt       1    Current CDRP    00000000 
 
 
      

This example shows the use of the /NODE qualifier to obtain information about a specific node (in this instance, node LEON01).

#4

SDA> SHOW CLUSTER /SCS
VAXcluster data structures 
-------------------------- 
 
                 --- SCS Listening Process Directory --- 
 
Entry Address     Connection ID     Process Name           Information 
-------------     -------------     ------------           ----------- 
 
  80419D60          08EE0000        SCS$DIRECTORY 
  80419E20          08EE0001        VMS$VAXcluster 
 
 
                   --- SCS Systems Summary --- 
 
  SB Address     Node      Type       System ID         Paths 
  ----------     ----      ----       ---------         ----- 
 
  8041A120      PINTO      HSC       00000000F10E         1 
  8041AA20      DORIS      VMS       0000000008A9         1 
  8041AB40      GUS        VMS       0000000008A1         1 
  8041B6E0      SOLLY      VMS       0000000008A0         1 
  8041D420      DODGER     HSC       00000000F00F         1 
 
 
                    --- PINTO System Block (SB) 8041A120 --- 
 
System ID            00000000F10E    Local software type           HSC 
Max message size               66    Local software vers.         X301 
Max datagram size              62    Local software incarn.   8355FE00 
Local hardware type          HS50                             008DA59A 
Local hardware vers. 022702220222    SCS poller timeout           000F 
                     022202220222    SCS poller enable mask         01 
 
 
                    --- Path Block (PB) 8041C400 --- 
 
                 Status:  0000 
 
Remote sta. addr.    00000000000E    Remote port type              HSC 
Remote state         00000000000E    Number of data paths            2 
Remote hardware rev.     00000225    Cables state            A-OK B-OK 
Remote func. mask        4F710200    Local state                  OPEN 
Resetting port                 0E    Port dev. name               PAB0 
Handshake retry cnt.            1    SCS MSGBUF address       80390270 
Msg. buf. wait queue        empty    PDT address              801CEA20 
 
 
                    --- DORIS System Block (SB) 8041AA20 --- 
 
System ID            0000000008A9    Local software type           VMS 
Max message size              112    Local software vers.         V5.0 
Max datagram size             576    Local software incarn.   A9D31760 
Local hardware type          V780                             008DA59B 
Local hardware vers. 010E0138207A    SCS poller timeout           000C 
                     000030030E10    SCS poller enable mask         00 
 
 
                    --- Path Block (PB) 80437E80 --- 
 
                Status:  0000 
 
Remote sta. addr.    000000000002    Remote port type            CI780 
Remote state                 ENAB    Number of data paths            2 
Remote hardware rev.     00040003    Cables state            A-OK B-OK 
Remote func. mask        FFFFFF00    Local state                  OPEN 
Resetting port                 02    Port dev. name               PAB0 
Handshake retry cnt.            1    SCS MSGBUF address       8036F0B0 
Msg. buf. wait queue        empty    PDT address              801CEA20 
 
      

This example shows a subset of a typical output for the SHOW CLUSTER/SCS command. In this system, there are three nodes (DORIS, GUS, and SOLLY), and there are two HSCs (PINTO and DODGER). After the summary information in the first two screen displays, specific information for each system block and its associated path block is shown.

Note

7 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 LOCK command indicates where a lock is mastered or held by CSID.
8 For information about the state and status of nodes, see the description of the ADD command in the Show Cluster utility section of the OpenVMS System Management Utilities Reference Manual.

SHOW CONNECTIONS

Displays information about all active connections between systems communications services (SCS) processes or a single connection. This command displays information that is in the connection descriptor table (CDT).

Format

SHOW CONNECTIONS {/ADDR or /ADDRESS=cdt-address| /NODE=name| /SYSAP=name}


Parameters

None.

Qualifiers

/ADDR or /ADDRESS=cdt-address

Displays information contained in the connection descriptor table (CDT) for a specific connection.9

/NODE=name

Displays information contained in the connection descriptor table (CDT) for a specific node.

/SYSAP=name

Displays information contained in the connection descriptor table (CDT) for a specific system application (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:

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.


Examples

#1

SDA> SHOW CONNECTIONS
VAXcluster data structures
--------------------------
   
                     --- CDT Summary Page ---
CDT Address   Local Process     Connection ID     State       Remote Node
-----------   -------------     -------------     -----       -----------
 801C2670     SCS$DIRECTORY       08EE0000        listen       
 801C2710     VMS$VAXcluster      08EE0001        listen       
 801C27B0     VMS$VAXcluster      08FF0002        open         DORIS
 801C2850     VMS$DISK_CL_DRVR    08FD0003        open         PINTO
 801C28F0     VMS$VAXcluster      08EF0004        open         SOLLY
 801C2990     VMS$VAXcluster      08F00005        open         GUS
Number of free CDTs:  32
   
            --- Connection Descriptor Table (CDT) 801C2670 ---
State:  0001 listen          Local Process:        SCS$DIRECTORY   
Blocked State:  0000 
Local Con. ID   08EE0000   Datagrams sent    0   Message queue      empty
Remote Con. ID  78A30017   Datagrams rcvd    0   Send Credit Q.     empty
Receive Credit         0   Datagram discard  0   PB address      80438300
Send Credit            1   Messages Sent     0   PDT address     801CEA20
Min. Rec. Credit       0   Messages Rcvd.    0   Error Notify    8022B816
Pend Rec. Credit       0   Send Data Init.   0   Receive Buffer  00000000
Initial Rec. Credit    0   Req Data Init.    0   Connect Data    00000000
Rem. Sta.   00000000000C   Bytes Sent        0   Aux. Structure  00000000
Rej/Disconn Reason     0   Bytes rcvd        0                            
Queued for BDT         0   Total bytes map   0                            
Queued Send Credit     0                                                  
 
      

This example shows the CDT summary page and the first page of the detailed displays for each CDT.

#2

SDA> SHOW CONNECTIONS /ADDRESS=801C27B0
VAXcluster data structures
--------------------------
   
            --- Connection Descriptor Table (CDT) 801C27B0 ---
State:  0002 open        Local Process:          VMS$VAXcluster  
Blocked State:  0000     Remote Node::Process:   DORIS::VMS$VAXcluster  
Local Con. ID   08FF0002  Datagrams sent     0   Message queue      empty
Remote Con. ID  33440003  Datagrams rcvd     0   Send Credit Q.     empty
Receive Credit         4  Datagram discard   0   PB address      80437E80
   .
   .
   .
 
      

This example shows the use of the /ADDRESS qualifier to obtain information about a specific connection.

#3

SDA> SHOW CONNECTIONS/NODE=MOON
      


VAXcluster data structures 
-------------------------- 
 
   --- Connection Descriptor Table (CDT) 98310EE0 --- 
 
State:  0002 open    Local Process:        MSCP$DISK       
Blocked State:  0000              Remote Node::Process: MOON::VMS$DISK_CL_DRVR 
 
Local Con. ID   7C79004E    Datagrams sent         0    Message queue      empty 
Remote Con. ID  009F0069    Datagrams rcvd         0    Send Credit Q.     empty 
Receive Credit        16    Datagram discard       0    PB address      98348200 
Send Credit           10    Messages Sent        964    PDT address     98336590 
Min. Rec. Credit       1    Messages Rcvd.       808    Error Notify    98B6158D 
Pend Rec. Credit       0    Send Data Init.        0    Receive Buffer  986791E8 
Initial Rec. Credit   10    Req Data Init.         0    Connect Data    98B60079 
Rem. Sta.   000000000009    Bytes Sent             0    Aux. Structure  98679A80 
Rej/Disconn Reason     0    Bytes rcvd             0                            
Queued for BDT         0    Total bytes map        0                            
Queued Send Credit     0                                                        
 
   --- Connection Descriptor Table (CDT) 98310540 --- 
 
State:  0002 open    Local Process:        SCA$TRANSPORT   
Blocked State:  0000              Remote Node::Process: MOON::SCA$TRANSPORT   
 
Local Con. ID   7CCD0047    Datagrams sent         0    Message queue      empty 
Remote Con. ID  817F005D    Datagrams rcvd         0    Send Credit Q.     empty 
   .
   .
   .
 
   --- Connection Descriptor Table (CDT) 9830F0A0 --- 
 
State:  0002 open    Local Process:        VMS$DISK_CL_DRVR 
Blocked State:  0000              Remote Node::Process: MOON::MSCP$DISK       
 
Local Con. ID   7C790038    Datagrams sent         0    Message queue      empty 
Remote Con. ID  4B51005B    Datagrams rcvd         0    Send Credit Q.     empty 
   .
   .
   .
 
   --- Connection Descriptor Table (CDT) 9830EF40 --- 
 
State:  0002 open    Local Process:        VMS$TAPE_CL_DRVR 
Blocked State:  0000              Remote Node::Process: MOON::MSCP$TAPE       
 
Local Con. ID   7C790037    Datagrams sent         0    Message queue      empty 
Remote Con. ID  23B20068    Datagrams rcvd         0    Send Credit Q.     empty 
   .
   .
   .

The command in this example displays information in the CDT about the node MOON.

#4

SDA> SHOW CONNECTIONS/SYSAP=SCA$TRANSPORT 
      


    --- CDT Summary Page --- 
 
CDT Address   Local Process     Connection ID     State       Remote Node 
-----------   -------------     -------------     -----       ----------- 
 
 9830A7C0     SCA$TRANSPORT       7C790003        listen       
 98310540     SCA$TRANSPORT       7CCD0047        open         METEOR 
 98310800     SCA$TRANSPORT       7CD50049        open         OCALA 
 
Number of free CDT's:  158 
 
 
   --- Connection Descriptor Table (CDT) 9830A7C0 --- 
 
State:  0001 listen    Local Process:        SCA$TRANSPORT   
Blocked State:  0000 
 
Local Con. ID   7C790003    Datagrams sent         0    Message queue      empty 
Remote Con. ID  00000000    Datagrams rcvd         0    Send Credit Q.     empty 
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    968D9E8B 
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 BDT         0    Total bytes map        0                            
Queued Send Credit     0                                                        
 
 
   --- Connection Descriptor Table (CDT) 98310540 --- 
 
State:  0002 open    Local Process:        SCA$TRANSPORT   
Blocked State:  0000              Remote Node::Process: METEOR::SCA$TRANSPORT   
 
Local Con. ID   7CCD0047    Datagrams sent         0    Message queue      empty 
Remote Con. ID  817F005D    Datagrams rcvd         0    Send Credit Q.     empty 
   .
   .
   .
 
   --- Connection Descriptor Table (CDT) 98310800 --- 
 
State:  0002 open    Local Process:        SCA$TRANSPORT   
Blocked State:  0000              Remote Node::Process: OCALA::SCA$TRANSPORT   
 
Local Con. ID   7CD50049    Datagrams sent         0    Message queue      empty 
Remote Con. ID  EFB80009    Datagrams rcvd         0    Send Credit Q.     empty 
   .
   .
   .

This example shows the use of the /SYSAP qualifier to show which nodes in the cluster are connected to SCA$TRANSPORT.

Note

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


Previous Next Contents Index

[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
[OpenVMS documentation]

Copyright © Compaq Computer Corporation 1998. All rights reserved.

Legal
4556PRO_009.HTML