Updated: 11 December 1998

OpenVMS VAX System Dump Analyzer Utility Manual

The SHOW PORTS/VC=VC_id command displays the virtual circuit data for the specified remote node and a channel summary. In this display, the upper center of the display contains the virtual circuit status. The lower right-hand corner contains the virtual circuit open and close times.

The ReXmt field indicates a problem sending messages to the remote system. The error rate per hour should be less than the Pipe Quota field.

The ReRcv field indicates a problem receiving messages from the remote system. The error rate per hour should be less than the Pipe Quota field.

#4
SDA> SHOW PORTS/MESSAGE/VC=address

This SHOW PORTS command displays the virtual circuit data for the specified remote node, followed by the message data for the remote node. The virtual circuit message display shows the counters for the following items:

• Sequenced message delivery
• Any messages in the process of being transmitted or in the receive cache

The following is an example of part of a display resulting from the SHOW PORTS/MESSAGE/VC=vc-address command:

VAXcluster data structures -------------------------- --- Sequenced Message Counters Virtual Circuit (VC) 806CD6E0 --- NSU: 4457 HAA: 4456 LAR: 4455 HSR: B3AA Cache Mask: 00000000 Messages Waiting for ACKs VCRP adr Len Flgs Seq Ack Message Data -------- ---- ---- ---- ---- ----------------------------------------------- 806CD2E0 137 0B 4456 B3AA 02 7D 00 04 00 0A 00 00 00 09 00 D 75 05 00 67

SDA> SHOW PORTS/CHANNEL=CH_BREE
      

This SHOW PORTS command displays the data for the specified channel. The normal state is OPEN, with a status of PATH, OPEN, and RMT_HWA_VALID.

In the following example display resulting from this command, the top of the display shows the remote device name, the remote device type, and the channel open and close times.

VAXcluster data structures -------------------------- : PEDRIVER Channel (CH:80704320) for Virtual Circuit (VC:806CD6E0) BREE -- State: 0004 open Status: 0B path,open,rmt_hwa_valid BUS: 80B008B0 (XQA) Lcl Device: XQ_DELQA Lcl LAN Address: 08-00-2B-0A-6A-6B Rmt Name: XQB Rmt Device: XQ_DEQTA Rmt LAN Address: 08-00-2B-13-70-88 Rmt Seq #: 0002 Open:22-MAR-1993 18:14:07.01 Closed:17-NOV-1858 00:00:00.00 ------- Transmit ------ ------- Receive ------- ----- Channel Selection ---- Lcl CH Seq # 0001 Msg Rcv 139205 Average Xmt Time FB879740 Msg Xmt 66707 Mcast Msgs 103906 Remote Buffer Size 1424 Ctrl Msgs 1 Mcast Bytes 10182788 Max Buffer Size 1424 Ctrl Bytes 98 Ctrl Msgs 2 Best Channel 615 Bytes Xmt 9130385 Ctrl Bytes 196 Preferred Channel 810 Rmt Ring Size 31 Bytes Rcv 22654333 Retransmit Penalty 2 --------------- Channel Errors --------------- Xmt Error Penalty 12 Handshake TMO 0 Short CC Msgs 0 ------- Channel Timer ------ Listen TMO 0 Incompat Chan 0 Timer Entry Flink 8079FA3C Bad Authorize 0 No MSCP Srvr 0 Blink 80705010 Bad ECO 0 Disk Not Srvd 0 Last Ring Index 08 Bad Multicast 0 Old TR Msgs 0 Protocol 1.3.0 Topology Change 0 Supported Services 00000000

SDA> SHOW PORTS/DEVICE/CHANNEL/VC=vc-address
      

This SHOW PORTS command displays the following information:

• Virtual circuit data for the specified remote node
• Channel data
• The network path description for each channel to the remote node

The following is an example of a display resulting from the SHOW PORTS/DEVICE/CHANNEL/VC=vc-address command:

VAXcluster data structures -------------------------- : Network Component List (CLST:80D36440) for Channel (CH:806DC420) -- COMP adr COMP Type Description -------- --------- --------------------------------------------------------- 80D30010 NODE SGRPOP:VAXstation 3300; RDO3-4/U10 80CC9300 ADAPTER ESA; SGRPOP:VAXstation 3300; RDO3-4/U10 (08-00-2B-12-AE-A1) 80D3CDB0 COMPONENT RD34C4, I-Cluster Segment DAMPR 80D40380 COMPONENT RD34C4, I-Cluster Segment SELNI 80D36AD0 COMPONENT I-Cluster Segment 80D2D4C0 P COMPONENT RDO3-4 Lab, DIVER: I-Cluster Segment SELNI . . . 80D323F0 NODE PELLNM:rack mounted MicroVAX II; RDO3-4 Lab

This display is useful after the local area VAXcluster network failure analysis data has been loaded. After a network failure analysis, this display indicates primary and secondary failed component suspects in the following ways:

• P: Primary suspect
• S: Secondary suspect
• ?: Component that cannot be proved to be working

SDA> SHOW PORTS /DEVICE /CHANNEL=address
      

This SHOW PORTS command displays the channel data and the network path description if it was provided by the network failure analysis.

SDA> SHOW PORTS/BUS/CHANNEL/DEVICE/MESSAGE/VC/ADDRESS=PE_PDT 
      

This command displays all of the bus structures, all of the virtual circuits and their message counters, and channels, including network path descriptions when available.

SDA> SHOW PORTS/ADDR=862C8D80/NAME=DAVID3
 
VAXcluster data structures 
-------------------------- 
 
 
   --- Virtual Circuit (VC) 862C8D80 --- 
Remote System Name:  DAVID3 (0:VAX)     Remote SCSSYSTEMID:  64588              
Local System ID:  213 (D5)              Status: 0005 open,path                  
------ Transmit -------  ------ VC Closures ----  ---- Congestion Control ---- 
Msg Xmt              19  SeqMsg TMO            0  Pipe Quota/Slo/Max   1/31/31 
  Unsequence         16  CC DFQ Empty          0  Pipe Quota Reached         0 
  Sequence            3  Topology Change       0  Xmt C/T                  0/1 
  ReXmt             0/0  NPAGEDYN Low          0  RndTrp uS          3000000+0 
  Lone ACK            0                           UnAcked Msgs               0 
Bytes Xmt          1058                           CMD Queue Len/Max        0/0 
------- Receive -------  - Messages  Discarded -  ----- Channel Selection ---- 
Msg Rcv              10  No Xmt Chan           0  Preferred Channel   00000000 
  Unsequence         16  Rcv Short Msg         0  Delay Time          003266DB 
  Sequence            0  Illegal Seq Msg       0  Buffer Size             1424 
  ReRcv               0  Bad Checksum          0  Channel Count              2 
  Lone ACK            0  TR DFQ Empty          0  Channel Selections         9 
  Cache               0  TR MFQ Empty          0  Protocol               1.3.0 
  Ill ACK             0  CC MFQ Empty          0  Open  8-FEB-1993 11:30:43.60 
Bytes Rcv           440  Cache Miss            0  Cls   8-FEB-1993 11:28:30.69 
 
 
 -- Channel Summary for Virtual Circuit (DAVID3) 862C8D80 -- 
 
Address     Type    Xmt Time Size Preferred    Best       Last State Change 
--------  --------- -------- ---- ---------  --------  ---------------------- 
862CB600  Active    000927BF 1424         3         4  8-FEB-1993 11:30:53.69 
862C8F00  Active    000927BF 1424         6         2  8-FEB-1993 11:30:43.60 
 
      

The command in this example displays virtual connect information associated with the DAVID3 node, which is associated with the port descriptor table whose address is 862C8D80.

Displays the software and hardware context of any process in the balance set.

Format

SHOW PROCESS [/qualifier[,...]][ALL|process-name|/INDEX=nn| /SYSTEM]

Parameters

ALL

Shows information about all processes that exist in the system.

process-name

Name of the process for which information is to be displayed.¹¹

You can determine the names of the processes in the system by issuing a SHOW SUMMARY command.

The process-name can contain up to 15 letters and numerals, including the underscore (_) and dollar sign ($) characters. If it contains any other characters, you must enclose the process-name in quotation marks (" ").

Qualifiers

/ALL

Displays all information shown by the following qualifiers: /CHANNEL, /PAGE_TABLES, /PCB, /PHD, /PROCESS_SECTION_TABLE, /REGISTERS, and /WORKING_SET.

/CHANNEL

Displays information about the I/O channels assigned to the process.

/IMAGES

Displays the address of the image control block, the start and end addresses of the image, the activation code, the protected and shareable flags, the image name, and the major and minor IDs of the image.

/INDEX=nn or /ID=nn

Specifies the process for which information is to be displayed by its index into the system's list of software process control blocks (PCBs). You can supply either of the following values for nn:

• The process index itself
• The process identification (PID) or extended PID longword, from which SDA extracts the correct index

To obtain these values for any given process, issue the SDA command SHOW SUMMARY.

/LOCKS

Displays the lock management locks owned by the current process.

The /LOCKS qualifier produces a display similar in format to that produced by the SHOW LOCKS command. See Table SDA-15 for additional information.

/P0

Displays the page tables for P0 space. See the description of the /PAGE_TABLES qualifier.

/P1

Displays the page tables for P1 space. See the description of the /PAGE_TABLES qualifier.

/PAGE_TABLESor /PPT [range|/P0|/P1]

Displays the page tables P0 and P1 spaces, or, optionally, either the page table or the page table entries for a range of addresses.

You can express a range using the following format:

m:n	Displays the page table entries that correspond to the range of virtual addresses from m to n
m;n	Displays the page table entries that correspond to a range of n pages, starting with page m

/PARTICIPANTS[=DISPLAY=(item [,...])]

Displays information about all transactions for the process. The argument to DISPLAY can be either a single item or a list. The following items can be specified.

Item	Description
ALL	All transaction control structures for the transactions. This is the default behavior.
BRANCHES	Control structures for branches of the transactions.
PARTICIPANTS	Control structures for resource managers participating in the transactions.
THREADS	Control structures for threads of the transactions.
TRANSACTIONS	Transaction control structures for the transactions.

/PCB

Displays the information contained in the software process control block (PCB). This is the default behavior of the SHOW PROCESS command.

/PHD

Lists information included in the process header (PHD).

/PROCESS_SECTION_TABLE or /PST

Lists the information contained in the process section table (PST).

/REGISTERS

Lists the hardware context of the process, as reflected in the registers of the process stored in the hardware PCB and---if the process is current on a processor in the system---the registers of the processor.

/RMS[=option[,...]]

Displays certain specified RMS data structures for each image I/O or process-permanent I/O file the process has open. To display RMS data structures for process-permanent files, specify the PIO option to this qualifier.

SDA determines the structures to be displayed according to either of the following methods:

• If you provide the name of a structure or structures in the option parameter, SHOW PROCESS/RMS displays information from only the specified structures. (See Table SDA-14 for a list of keywords that you can supply as options.)
• If you do not specify an option, SHOW PROCESS/RMS displays the current list of options as shown by the SHOW RMS command and set by the SET RMS command.

/SYSTEM

Displays the system process control block.¹² The system PCB and process header (PHD) are dummy structures that are located in system space. These structures contain the system working set, global section table, global page table, and other systemwide data.

/TRANSACTIONS=(option[,...])

Displays information about all transactions, or the specified transaction, for the process. The following two options can be specified either together or separately:

• DISPLAY=(item [,...])
  Specifies the type of information to be displayed. The argument to DISPLAY can be either a single item or a list. The following items can be specified.

  Item	Description
  ALL	All transaction control structures for the specified transaction. This is the default behavior.
  BRANCHES	Control structures for branches of the specified transaction.
  PARTICIPANTS	Control structures for resource managers participating in the specified transaction.
  THREADS	Control structures for threads of the specified transaction.
  TRANSACTIONS	Transaction control structures for the specified transaction.

• TID=tid
  Specifies the transaction for which information is to be displayed. If you omit the TID option, the SHOW PROCESS/TRANSACTIONS command displays information about all transactions for the process.

If you omit these options, the SHOW PROCESS/TRANSACTIONS command displays all information about all transactions for the process.

Note that the SHOW PROCESS/TRANSACTIONS and SHOW PROCESS/PARTICIPANTS commands display the same information about transactions, but in different orders. The SHOW PROCESS/TRANSACTIONS command walks down a transaction queue. The SHOW PROCESS/PARTICIPANTS command walks down a resource manager queue.

/VECTOR_REGS

Displays the saved process vector registers.

/WORKING_SET or /WSL

Displays the working set list of the process.

Description

The SHOW PROCESS command displays information about the process specified by process-name, the process specified with the /INDEX qualifier, the system process, or all processes. By default, the SHOW PROCESS command produces information about the SDA current process, as explained in Section 4.

The SHOW PROCESS command performs an implicit SET PROCESS command under certain uses of its qualifiers and parameters, as explained in Section 4, Section 5, and Section 6. If you use the SHOW PROCESS command and name a process that is the current process on a CPU, SDA temporarily assigns the symbols shown in Table SDA-9 to the values in the process. You can then refer to those symbols when you use the FORMAT command.

The default of the SHOW PROCESS command provides information taken from the software process control block (PCB).¹³ This information describes the following characteristics of the process:

• Software context
• Condition-handling information
• Information about interprocess communication
• Information about counts, quotas, and resource usage

Among the displayed information are the PID, EPID, priority, job information block (JIB) address, and process header (PHD) address of the process. SHOW PROCESS also describes the resources owned by the process, such as event flags and mutexes. The "State" field records the current scheduling state of the process; in a multiprocessing system, the display indicates the CPU ID of any process whose state is CUR.

The SHOW PROCESS/ALL command displays additional process-specific information, also provided by several of the individual qualifiers to the command.

The process header display, also produced by the /PHD qualifier, provides information taken from the process header (PHD), which is swapped into memory when the process becomes part of the balance set. Each item listed in the display reflects a quantity, count, or limit for the process's use of the following resources:

• Process memory
• The pager
• The scheduler
• Asynchronous system traps
• I/O activity
• CPU activity

The process registers display, also produced by the /REGISTERS qualifier, describes the hardware context of the context, as reflected in its registers.

The hardware context of a process is stored in two places:

• If the process is currently executing on a processor in the system (that is, in the CUR scheduling state), its hardware context is contained in that processor's registers. (That is, the registers of the process and the registers of the processor contain identical values, as illustrated by a SHOW CPU command for that processor or a SHOW CRASH command if the process was current at the time of the system failure.)
• If the process is not executing, its hardware context is stored in the part of the PHD known as the hardware PCB.

The process registers display first lists those registers stored in the hardware PCB ("Saved process registers"). If the process to be displayed is currently executing on a processor in the system, the display then lists the processor's registers ("Active registers for the current process"). In each section, the display lists the registers in the following groups:

• General-purpose registers (R0 through R11 and the AP, FP, and PC)
• Stack pointers (KSP, ESP, SSP, and USP)
• Special-purpose registers (PC and PSL)
• Base and length registers (P0BR, P1BR, P0LR, and P1LR)

The working set information and working set list displays, also produced by the /WORKING_SET qualifier, describe those virtual pages that the process can access without a page fault. After a brief description of the size, scope, and characteristics of the working set list itself, SDA displays the following information for each entry in the working set list.

Column	Contents
INDEX	Index into the working set list at which information for this entry can be found
ADDRESS	Virtual address of the page in the process address space that this entry describes
STATUS	Three columns that list the following status information: Page type Location of the page in physical memory Indication of whether the page is locked into the working set

When SDA locates one or more unused working set entries, it issues the following message:

--- n empty entries

In this message, n is the number (in decimal) of contiguous, unused entries.

The process section table information and process section table displays, also produced by the /PROCESS_SECTION_TABLE qualifier, list each entry in the process section table (PST) and display the offsets to the first free entry and last used entry.

SDA displays the information listed in Table SDA-19 for each PST entry.

Table SDA-19 Process Section Table Entry Information in the SHOW PROCESS Display

Part	Definition
INDEX	Offset into the PST at which the entry is found. Because entries in the process section table begin at the highest location in the table, and the table expands toward lower addresses, the following expression determines the address of an entry in the table: PHD + PSTBASOFF---INDEX.
ADDRESS	Virtual address that marks the beginning of the first page of the section described by this entry.
PAGES	Length, in pages, of the process section.
VBN	Virtual block number, the number of the file's virtual block that is mapped into the section's first page.
CLUSTER	Cluster size used when faulting pages into this process section.
REFCNT	Number of pages of this section that are currently mapped.
FLINK	Forward link, the pointer to the next entry in the PST list.
BLINK	Backward link, the pointer to the previous entry in the PST list.
FLAGS	Flags that describe the access that processes have to the process section.

The P0 page table and P1 page table displays, also produced by the /PAGE_TABLES qualifier, display listings of the page table entries of the process in the same format as that produced by the SHOW PAGE_TABLE command (see Tables SDA-16 and SDA-17).

The process active channels display, the last produced by SHOW PROCESS/ALL and the only one produced by the /CHANNEL qualifier, displays the following information for each I/O channel assigned to the process.

Column	Contents
Channel	Number of the channel
Window	Address of the window control block (WCB) for the file if the device is a file-oriented device; zero otherwise
Status	Status of the device: "Busy" if the device has an I/O operation outstanding; blank otherwise
Device/file accessed	Name of the device and, if applicable, name of the file being accessed on that device

The information listed under the heading "Device/file accessed" varies from channel to channel and from process to process. SDA displays certain information according to the conditions listed in Table SDA-20.

Table SDA-20 Process I/O Channel Information in the SHOW PROCESS Display

Information Displayed1	Type of Process
dcuu:	SDA displays this information for devices that are not file structured, such as terminals, and for processes that do not open files in the normal way.
dcuu: filespec	SDA displays this information only if you are examining a running system and only if your process has enough privilege to translate the file-id into the filespec.
dcuu:( file-id) filespec	SDA displays this information only when you are examining a dump. The filespec corresponds to the file-id on the device listed. If you are examining a dump from your own system, the filespec is probably valid. If you are examining a dump from another system, the filespec is probably meaningless in the context of your system.
dcuu:( file-id)	The file-id no longer points to a valid filespec, as when you look at a dump from another system; or the process in which you are running SDA does not have enough privilege to translate the file-id into the corresponding filespec.

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

4556PRO_014.HTML