[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

OpenVMS Alpha System Analysis Tools Manual


Previous Contents Index


SHOW BUGCHECK

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

Format

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


Parameters

name

Value, name, and text of the named bugcheck code.

number

Value, name, and text of the requested bugcheck code.

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 100
0100  DIRENTRY       ACP failed to find same directory entry
      

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

#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]|/NEXT_FP}


Parameter

starting-address

Expression representing the starting address of the procedure call frame to be displayed. The default starting-address is the contents of the FP register of the SDA current process.

Qualifier

/NEXT_FP

Displays the procedure call frame starting at the address stored in the FP 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_FP qualifier to the command.

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_FP qualifier, or the address contained in the SDA current process FP register (the default action).

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


%SDA-E-NOTINPHYS, 00000000.00000000 : not in physical memory
This message indicates that the saved FP in the previous call frame has a zero value.

Example


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_FP
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_FP
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 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 {[{/ADDRESS=n|/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 /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 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 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 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 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.


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