Document revision date: 30 March 2001
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS Alpha System Analysis Tools Manual


Previous Contents Index

This SHOW PROCESS command shows the current process to be ERRFMT, and displays information from its PCB and job information block (JIB).

See the description of the REPEAT command for an example of the use of the SET PROCESS/NEXT command.


SET RMS

Changes the options shown by the SHOW PROCESS/RMS command.

Format

SET RMS =(option[,...])


Parameter

option

Data structure or other information to be displayed by the SHOW PROCESS/RMS command. Table 4-2 lists those keywords that may be used as options.

Table 4-2 SET RMS Command Keywords for Displaying Process RMS Information
Keyword Meaning
[NO]ALL[: ifi] 1 All control blocks (default)
[NO]ASB Asynchronous save block
[NO]BDB Buffer descriptor block
[NO]BDBSUM BDB summary page
[NO]BLB Buffer lock block
[NO]BLBSUM Buffer lock summary page
[NO]CCB Channel control block
[NO]DRC Directory cache
[NO]FAB File access block
[NO]FCB File control block
NO]FSB File statistics block
[NO]FWA File work area
[NO]GBD Global buffer descriptor
[NO]GBDSUM GBD summary page
[NO]GBH Global buffer header
[NO]GBHSH Global buffer hash table
[NO]GBSB Global buffer synchronization block
[NO]IDX Index descriptor
[NO]IFAB[: ifi] 1 Internal FAB
[NO]IFB[: ifi] 1 Internal FAB
[NO]IRAB Internal RAB
[NO]IRB Internal RAB
[NO]JFB Journaling file block
[NO]KLTB Key-less-than block
[NO]NAM Name block
[NO]NWA Network work area
[NO]PIO Process-permanent I/O data structures used instead of process image data structures
[NO]RAB Record access block
[NO]RLB Record lock block
[NO]RU Recovery unit structures, including the recovery unit block (RUB), recovery unit stream block (RUSB), and recovery unit file block (RUFB)
[NO]SFSB Shared file synchronization block
[NO]WCB Window control block
[NO]XAB Extended attribute block
[NO]* Current list of options displayed by the SHOW RMS command


1The optional parameter ifi is an internal file identifier. The default ifi (ALL) is all the files the current process has opened.

The default option is option=(ALL,NOPIO), designating for display by the SHOW PROCESS/RMS command all structures for all files related to the process image I/O.

To list more than one option, enclose the list in parentheses and separate options by commas. You can add a given data structure to those displayed by ensuring that the list of keywords begins with the asterisk (*) symbol. You can delete a given data structure from the current display by preceding its keyword with "NO."


Qualifiers

None.

Description

The SET RMS command determines the data structures to be displayed by the SHOW PROCESS/RMS command. (See the examples included in the discussion of the SHOW PROCESS command for information provided by various displays.) You can examine the options that are currently selected by issuing a SHOW RMS command.


Examples

#1

SDA>  SHOW RMS
RMS Display Options:  IFB,IRB,IDX,BDB,BDBSUM,ASB,CCB,WCB,FCB,FAB,RAB,NAM,XAB,RLB,
BLB,BLBSUM,GBD,GBH,FWA,GBDSUM,JFB,NWA,RU,DRC,SFSB,GBSB
 
Display RMS structures for all IFI values.
   
SDA>  SET RMS=IFB
SDA>  SHOW RMS
   
RMS Display Options:  IFB
 
Display RMS structures for all IFI values.
 
      

The first SHOW RMS command shows the default selection of data structures that are displayed in response to a SHOW PROCESS/RMS command. The SET RMS command selects only the IFB to be displayed by subsequent SET/PROCESS commands.

#2

SDA>  SET RMS=(*,BLB,BLBSUM,RLB)
SDA>  SHOW RMS
   
RMS Display Options:  IFB,RLB,BLB,BLBSUM
 
Display RMS structures for all IFI values.
      

The SET RMS command adds the BLB, BLBSUM, and RLB to the list of data structures currently displayed by the SHOW PROCESS/RMS command.

#3

SDA>  SET RMS=(*,NORLB,IFB:05)
SDA>  SHOW RMS
   
RMS Display Options:  IFB,BLB,BLBSUM
Display RMS structures only for IFI=5.
      

The SET RMS command removes the RLB from those data structures displayed by the SHOW PROCESS/RMS command and causes only information about the file with the ifi of 5 to be displayed.

#4

SDA> SET RMS=(*,PIO)
      

The SET RMS command indicates that the data structures designated for display by SHOW PROCESS/RMS be associated with process-permanent I/O instead of image I/O.


SET SIGN_EXTEND

Enables or disables the sign extension of 32-bit addresses.

Format

SET SIGN_EXTEND {ON|OFF}


Parameters

on

Enables automatic sign extension of 32-bit addresses with bit 31 set. This is the default.

off

Disables automatic sign extension of 32-bit addresses with bit 31 set.

Qualifiers

None.

Description

The 32-bit S0/S1 addresses need to be sign-extended to access 64-bit S0/S1 space. To do this, specify explicitly sign-extended addresses, or set the sign-extend command to on, which is the default.

However, to access addresses in P2 space, addresses must not be sign-extended. To do this, specify a zero in front of the address, or set the sign-extend command to off.


Examples

#1

SDA> set sign_extend on
SDA>  examine 80400000
FFFFFFFF.80400000: 23DEFF90.4A607621
      

This shows the SET SIGN_EXTEND command as ON.

#2

SDA> set sign_extend off
SDA>  examine 80400000
%SDA-E-NOTINPHYS, 00000000.80400000: virtual data not in physical memory
      

This shows the SET SIGN_EXTEND command as OFF.


SET SYMBOLIZE

Enables or disables symbolization of addresses in the display from an EXAMINE command.

Format

SET SYMBOLIZE {ON|OFF}


Parameters

ON

Enables symbolization of addresses.

OFF

Disables symbolization of addresses.

Qualifiers

None.
Examples


1.      SDA> SET SYMBOLIZE ON 
        SDA> examine g1234 
        SYS$PUBLIC_VECTORS+01234:  47DF041C   "..ßG" 


2.      SDA> SET SYMBOLIZE OFF 
        SDA> examine g1234 
        FFFFFFFF.80001234:  47DF041C   "..ßG" 

This example shows the effect of enabling (default) or disabling symbolization of addresses.


SHOW ADDRESS

Displays the page table related information about a memory address.

Format

SHOW ADDRESS address [/PHYSICAL]


Parameter

address

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

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.FF7FDFF0 
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Also mapped in SPT window at: FFFFFFFF.FFDF0000
      

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
      

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)
      

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

Displays the value, name, and text of the named bugcheck code.

number

Displays the 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 this 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 LOCK 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(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 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:

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
      


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6549PRO_009.HTML