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

OpenVMS Alpha System Analysis Tools Manual


Previous Contents Index


SHOW BUGCHECK

Displays the following bugcheck codes: value, name and text.

Format

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


Parameters

name

Displays the named bugcheck code.

number

Displays 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 and texts of number and name. It is the default.

Description

The SHOW BUGCHECK command displays the bugcheck codes that consist of value, name, and text.


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 longwords 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 longword contained in 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 by default. The default starting address is contained in the SDA current process FP register.

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


%SDA-E-NOTINPHYS, 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 and /NODE 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 LOCK command indicates where a lock is mastered or held by CSID. This is mutually exclusive with the /ADDRESS=n and /NODE 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 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(s) (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:

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

For information about the state and status of nodes, see the description of the ADD command 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), 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 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:

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


Example


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.


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:

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.


SHOW CPU

Displays information about the state of a processor at the time of the system failure.

Note

SHOW CPU is only valid when analyzing a crash dump. It is not a valid command when analyzing the running system, because all the CPU-specific information may not be available.

Format

SHOW CPU [cpu-id]


Parameter

cpu-id

Numeric value from 00 to 1F16 indicating the identity of the processor for which context information is to be displayed. If you specify a value outside this range, or you specify the cpu-id of a processor that was not active at the time of the system failure, SDA displays the following message:


%SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range 

If you use the cpu-id parameter, the SHOW CPU command performs an implicit SET CPU command, making the processor indicated by cpu-id the current CPU for subsequent SDA commands. (See the description of the SET CPU command and Chapter 2, Section 2.5 for information on how this can affect the CPU context---and process context---in which SDA commands execute.)


Qualifiers

None.

Description

The SHOW CPU command displays system failure information about the processor specified by cpu-id or, by default, the SDA current CPU, as defined in Chapter 2, Section 2.5. You cannot use the SHOW CPU command when examining the running system with SDA.

The SHOW CPU command produces several displays. First, there is a brief description of the system failure and its environment that includes the following:

Next, the general registers display shows the contents of the processor's integer registers (R0 to R30), and the AI, RA, PV, FP, PC, and PS at the time of the system failure.

The processor registers display consists of the following parts:

The first part of the processor registers display includes registers common to all Alpha processors, which are used by the operating system to maintain the current process virtual address space, system space, or other system functions. This part of the display includes the following registers:

The last part of the display includes the four stack pointers: the pointers of the kernel, executive, supervisor, and user stacks (KSP, ESP, SSP, and USP, respectively).

The SHOW CPU command concludes with a listing of the spin locks, if any, owned by the processor at the time of the system failure, reproducing some of the information given by the SHOW SPINLOCKS command. The spinlock display includes the following information:


Example


SDA> SHOW CPU
CPU 00 Processor crash information
CPU 00 reason for Bugcheck: UNXINTEXC, Unexpected interrupt or exception
Process currently executing on this CPU: UETCLIG00master
Current image file: $1$DKB400:[SYS64.SYSCOMMON.][SYSTEST]UETCLIG00.EXE;1
Current IPL: 13  (decimal)
CPU database address:  805AE000
General registers:
R0  = 00000000.00000001 R1  = 00000000.0000003B R2  = FFFFFFFF.8004FF88
R3  = FFFFFFFF.80428070 R4  = 00000000.00000001 R5  = 00000000.00000D04
R6  = 00000000.7FF78BE6 R7  = 00000000.00000064 R8  = FFFFFFFF.806CEA96
R9  = 00000000.00000030 R10 = 00000000.00002270 R11 = 00000000.0C040087
R12 = 00000000.00000001 R13 = FFFFFFFF.80435270 R14 = FFFFFFFF.80434AE0
R15 = FFFFFFFF.80403200 R16 = 00000000.00000410 R17 = 00000000.00000001
R18 = 00000000.000005D0 R19 = 00000000.000000EA R20 = FFFFFFFF.80403200
R21 = FFFFFFFF.8040C810 R22 = 00000000.000000FA R23 = FFFFFFFF.8040C7F0
R24 = FFFFFFFF.8040C7E0 AI  = 00000000.00000000 RA  = 00000000.00000014
PV  = 00000000.0000003B R28 = 00000000.0000003B FP  = 00000000.7FF95D00
PC  = FFFFFFFF.80050020 PS  = 00000000.00000D04
Processor Internal Registers:
ASN  = 00000000.00000000                     ASTSR/ASTEN =          00000000
IPL  =          00000008  PCBB = 00000000.0140C080  PRBR = FFFFFFFF.80C0C000
PTBR = 00000000.000000B8  SCBB = 00000000.00000250  SISR = 00000000.00000000
VPTB = FFFFFFFC.00000000  FPCR = 00000000.00000000  MCES = 00000000.00000000
        KSP     = 00000000.7FF95A00
        ESP     = 00000000.7FF9A000
        SSP     = 00000000.7FFA04C0
        USP     = 00000000.7EE719F0
                 Spinlocks currently owned by CPU 00
SCHED                              ADDRESS   80427880
Ownership Depth    00000001        Rank      00000012
CPUs Waiting       00000000        Index     00000032
 
 
      


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
6549PRO_009.HTML