Document revision date: 15 July 2002

The first command in this example displays channel counters since the last SHOW command. The SPAWN command tells the DCL WAIT command to insert a 10-second delay. The second SHOW CHANNEL command displays counters after the 10-second period.

#5
SCACP> SHOW CHANNEL/1/3

The command in this example displays the first and third pages of data for all channels. The first page contains Channel Summary data, and the third page contains Channel Equivalent Channel Set (ECS) data.

SCACP> SHOW CHANNEL/LOCAL=EWA/REMOTE=EWB NODE10, 
NODE15/L=F*/R=F*, NODE20
      

The command in this example is equivalent to the following command:

SHOW CHANNEL NODE10/L=EWA/R=EWB, NODE15/L=F*/R=F*, NODE20/L=EWA/R:EWB

This command shows the following channels:

• To node NODE10, the channel with local device EWA and remote device EWB
• To node NODE15, the channel with local LAN device starting with F and remote LAN device starting with F
• To node NODE20, the channel with local LAN device EWA and remote LAN device EWB

Displays SCA circuit information. You can further qualify each node name you specify with additional parameters to uniquely identify a single circuit.

Format

SHOW CIRCUIT nodename

Parameter

nodename[,...]

Includes specific circuits to individual nodes, which you can use wildcards to specify.

Qualifiers

/EXCLUDE=(nodename[/PORT=portname[/RSTATION=n]][,...])

Allows you to exclude a specific circuit to a node. If multiple circuits to the same node exist, you can use the /PORT and /RSTATION qualifiers to uniquely identify the circuit.

/PORT=portname[/RSTATION=n]

If multiple circuits to the same node exist, you can use the /PORT and /RSTATION qualifiers to uniquely identify the circuit. You can use the /RSTATION qualifier only in conjunction with the /PORT qualifier.

Example

SCACP>SHOW CIRCUIT
      

The command in this example displays all circuits to nodes over port PEA0.

Circuit data for CLUIO2 at 07-DEC 11:55:31.80 Node Port Priority Load Remote Remote Name Name Cur Mgt Class State Station Type -------- -------- ---- ---- -------- -------- ------- -------- LYNX03 PEA0 0 0 10 Open dc NI CLUIO1 PEA0 0 0 10 Open dd NI PRMMC2 PEA0 0 0 10 Open de NI RXBOT1 PIB0 5 0 48 Open 4 RF72 RXTOP1 PIB0 5 0 48 Open 1 RF73 RXTOP0 PIB0 5 0 48 Open 0 RF73 CLUIO1 PIB0 5 0 48 Open 7 N710 R4JC3I PIC0 5 0 48 Open 7 RF73 R4HLEK PIC0 5 0 48 Open 5 RF73 R4XEWM PIC0 5 0 48 Open 3 RF73 R4A1FN PIC0 5 0 48 Open 2 RF73 R4XSVE PIC0 5 0 48 Open 4 RF73 R4VLNI PIC0 5 0 48 Open 1 RF73

SCACP>SHOW CIRCUIT * /PORT=PEA0
      

The command in this example displays all circuits to all nodes.

Circuit data for CLUIO2 at 07-DEC 12:42:23.03 Node Port Priority Load Remote_Port Name Name State Cur Mgt Class Number Type -------- -------- -------- ---- ---- -------- ------- -------- LYNX03 PEA0 Open 0 0 100 dc NI LYNX03 PNA0 Open 0 0 140 1 CI CLUIO1 PEA0 Open 0 0 10 dd NI PRMMC2 PEA0 Open 0 0 10 de NI

Displays PEDRIVER device data. Each device is a local LAN device on the system, which can be used for NISCA communications.

Format

SHOW LAN_DEVICE landevicename

Parameter

landevicename[,...]

Includes specific LAN devices, which you can use wildcards to specify.

Usage Notes

• Use the /EXCLUDE qualifier to exclude LAN devices.
• Use the SHOW LAN_DEVICE command to display device names.

Qualifiers

/ALL

Includes all device data.

/COUNTERS

Includes device counters data maintained by PEDRIVER and counters data maintained by the LAN drivers.

/EXCLUDE=(landevicename[,...])

Excludes specific LAN devices, which you can use wildcards to specify.

/INTERVAL

For the /COUNTERS display, displays the changes to counters since the last SHOW command.

/n

Displays the nth page. To select a particular page of a multipage display, specify the number of the page you want to display.

/OUTPUT=filespec

Creates the specified file and directs output to it.

/SDA

Includes LAN device data displayed in SDA format, with all the data collected in one display for one LAN device.

/SUMMARY

Includes device summary data. This is the default if /ALL, /COUNTERS, and /SDA qualifiers are not specified.

Examples

SCACP> SHOW LAN_DEVICE
      

The command in this example produces output similar to the following:

SYS999 PEA0 Device Summary 31-JAN-2001 10:58:57.93: Device Errors + Mgt Buffer MgtMax Line Total Current Device Type Events Status Priority Size BufSiz Speed Pkts(S+R) LAN Address ------ ---- ------ ------ -------- ---- ------ ----- --------- ----------- LCL 0 Run Online Local Restart 0 1426 0 N/A 46456 00-00-00-00-00-00 FWA DEFPA 847806 Run Online Restart 0 4396 0 100 0 08-00-2B-B9-1A-2C EWA DE500 0 Run Online Restart -123 1426 0 10 228538 AA-00-04-00-62-4D EWB DEGPA 1204 Run Online Restart 0 7460 0 1000 63188 00-60-6D-21-12-1E . . .

SCACP> SHOW LAN_DEVICE/ALL
      

The command in this example produces output similar to the following:

SYS999 PEA0 Device Summary 31-JAN-2001 10:59:00.88: Device Errors + Mgt Buffer MgtMax Line Total Current Device Type Events Status Priority Size BufSiz Speed Pkts(S+R) LAN Address ------ ---- ------ ------ -------- ---- ------ ----- --------- ----------- LCL 0 Run Online Local Restart 0 1426 0 N/A 46456 00-00-00-00-00-00 FWA DEFPA 847806 Run Online Restart 0 4396 0 100 0 08-00-2B-B9-1A-2C EWA DE500 0 Run Online Restart -123 1426 0 10 228538 AA-00-04-00-62-4D EWB DEGPA 1204 Run Online Restart 0 7460 0 1000 63188 00-60-6D-21-12-1E . . . SYS999 PEA0 Device Counters and Errors 31-JAN-2001 10:59:00.88: --------- Transmit --------- --------- Receive -------- Port Port Addr Restart Device Messages Bytes Errors Messages Bytes Errors Usable Down Change Failed *Last Event Time ------ -------- ----- ------ -------- ----- ------ ------ ---- ------ ------ ---------------- LCL 77926 10131658 0 77926 9196546 0 1* 0 0 0 30-JAN 14:53:04.27 EBA 79932 10771395 0 79828 9471857 0 1* 0 0 0 30-JAN 14:53:04.27 EWA 95170718 951046392 0 90389699 824505995 0 1 0 1* 0 30-JAN 14:53:54.96 EWB 28515398 3596974072 0 31235328 1573461656 0 1 0 1* 0 30-JAN 14:53:56.96 ELA 288523549 3938187772 0 268398349 1991472896 0 1* 0 0 0 30-JAN 14:53:04.38 SYS999 PEA0 Device Errors 31-JAN-2001 10:59:00.88: - Transmit - ------------------- Received -------------------- Allocation Generic Hello With Bad Mcast TR Short Short On Wrong Discard Failures On Device Errors Errors Last Transmit Error SYSTEMID Message CC Msg DX Msg Port PortDisa CH VC ------ ------ ------ ------------------- -------- ------- ------ ------ ---- -------- ---- ---- LCL 0 0 (No time) 0 0 0 0 0 0 0 0 EBA 0 0 (No time) 0 0 0 0 0 0 0 0 EWA 0 0 (No time) 0 0 0 0 0 0 0 0 EWB 0 0 (No time) 0 0 0 0 0 0 0 0 ELA 0 0 (No time) 0 0 0 0 0 0 0 0 SYS999 LAN Counters and Errors 31-JAN-2001 10:59:00.88: ---------- Transmit -------- ---------- Receive ------ Buffer Unavailable -- Unrecognized -- Device Packets Bytes Errors Packets Bytes Errors System User Individual Multicast Events ------ ------- ----- ------ ------- ----- ------ ------ ---- ---------- --------- ------ LCL 0 0 0 0 0 0 0 0 0 0 0 EBA 80172 10808778 0 80068 10786180 0 0 0 0 240 0 EWA 95170964 214548983411 0 90390818 185699326463 0 0 0 0 1119 0 EWB 28520511 14930703525 0 31255260 18836142478 0 0 0 1697 1653 0 ELA 288523791 655074988675 0 268399522 415695135533 0 0 0 0 1173 0

SCACP> SHOW LAN_DEVICE/COUNTERS
      

The command in this example displays device counters.

SCACP> SHOW LAN_DEVICE/COUNTERS/INTERVAL
SCACP> SPAWN WAIT 0:0:10
SCACP> SHOW LAN_DEVICE/COUNTERS/INTERVAL
      

The first command in this example displays device counters since the last SHOW command. The SPAWN command tells the DCL WAIT command to insert a 10-second delay. The second SHOW command displays counters after the 10-second period.

Displays information about selected SCA ports.

Format

SHOW PORT portname

Parameter

portname[,...]

Displays information about specific SCA ports, which you can use wildcards to specify. If no portname is specified, all ports on the node are displayed.

Qualifiers

/EXCLUDE=(portname[,...])

Excludes specific port names from the display. You cannot use wildcards to specify port names.

/OUTPUT=filespec

Creates the specified file and directs the output of the command to this file.

Example

SCACP> SHOW PORT
      

The command in this example produces output similar to the following:

Port data for CLUIO2 at 06-DEC 15:01:25.82 Port Mgt Msgs Msgs Dgrams Dgrams Name Prio Sent Rcvd Sent Rcvd ------ ---- ---------- ---------- ---------- ---------- PEA0 0 64582 92237 0 0 PIB0 0 95276 148937 0 0 PIA0 0 0 0 0 0 PIC0 0 62030 115148 0 0

Displays PEDRIVER tracing data and parameters.

Format

SHOW TRACE nodename

Parameter

nodename[,...]

Includes channels to specific nodes, which you can use wildcards to specify.

Each node name can be accompanied by optional qualifiers to specify local and remote device names. If no local or remote device name is specified, all channels associated with the specified node are included.

To display node names and local and remote device names, use the SHOW CHANNEL command.

Qualifiers

/CONTEXT

Displays only PEDRIVER trace settings and the event definition. If this qualifier is not included, trace event data is displayed.

/EVENT=(event1[,...])

Enables tracing on specific events, which you can use wildcards to specify. The default is all of the events that are in the trace buffer.

/EXCLUDE[=(nodename[,...])

Excludes channels to specific nodes, which you can use wildcards to specify. Each node name can be accompanied by optional qualifiers to specify local and remote device names. If no local or remote device name is specified, all channels associated with the specified node are included.

/GLOBAL (default when no nodes are specified)

/NOGLOBAL (default when nodes are specified)

Specifies whether global trace data is to be returned.

/INPUT=filename

Reads trace data from the specified file and displays it.

/LOCAL_DEVICE=(landevicename[,...])

Includes specific LAN devices that identify the local end of the channel; you can use wildcards to specify LAN devices.

/OUTPUT=filename

Creates the specified file and directs output to it. If the filename extension is .DMP, the trace data is written to a dump file so that you can use the /INPUT qualifier to display it later.

/REMOTE_DEVICE=(landevicename[,...])

Includes specific LAN devices which identify the remote end of the channel, which you can use wildcards to specify.

/SORT

/NOSORT (default)

Returns trace data sorted across channels, VCs, and the global trace buffer by sequence number. The default is trace data returned for channels and VCs one at a time, in order, for the channel or VC, but not across channels and VCs.

Usage Notes

• Use the SHOW TRACE/CONTEXT command to display event names.
• Use the SHOW LAN_DEVICE command to display device names.

Examples

SCACP> SHOW TRACE
      

The command in this example produces output similar to the following:

SYS999 Trace Results 31-JAN-2001 10:59:24.81 EntryTimeStamp Sequence VC/Channel State/Status Addl Data Event/SubType -------------- -------- ---------- ------------ --------- ------------- 53850998.232793 00000004 SYS999 004 STS. = 00000004 00000000 00000000 ECS_state/Exiting NEW_EPOCH 53850998.232793 00000009 SYS999 004 WSeq = 00010001 LAcc = 00000000 Send_TR_msg/None 53850998.232793 0000000A SYS999 005 00000000 00000000 00000000 00000000 VC_state/VC opened 53850998.232793 0000000B SYS999 005 WSeq = 00010001 LAcc = 00000000 Send_TR_msg/None 53850998.232793 0000000C SYS999 005 WSeq = 00010001 LAcc = 00000000 Send_TR_msg/None . . . 53851866.350546 3069EF05 SYS11 005 WSeq = 00010553 LAcc = 000008CB Send_TR_msg/None 53851866.350628 3069EF0C SYS666 005 EDly = 007F428A 000F722A 0003B13A Rcvd_TR_msg/Estimated RTT 53851866.352023 3069EF7E SYS44 005 WSeq = 00010000 LAcc = 00000D01 Send_TR_msg/None 53851866.352140 3069EF8B SYS11 005 EDly = 0075FFB9 000E16E8 00054879 Rcvd_TR_msg/Estimated RTT 53851866.375951 3069F644 SYS444_EWB_EIB Open 6B Evnt = 00000000 00000000 00000000 CC_event/Process CC event . . . Channel status legend: 6B - Path Open Remote_HWA_valid Tight Fast VC status legend: 004 - Path 005 - Open Path 00D - Open Path Queued

SCACP> SHOW TRACE/CONTEXT
      

The command in this example displays trace settings and definition.

SCACP> SHOW TRACE/OUTPUT=NODE10.TRC
      

The command in this example displays trace data and writes it to the specified file.

An example of the screen output of a SHOW TRACE/CONTEXT command follows.

SYS999 Trace Context 31-JAN-2001 10:59:28.25: Trace buffer size requested 2048 bytes Trace buffer total allocated 92160 bytes Trace buffer allocations 45 successful Trace buffer allocations 0 failed Current trace sequence number 812286047 System cycle counter 404196 cps Stop tracing 0 events after stop event Trace Stop Default Event ----- ---- ------- ----- Active Y Error Active Penalize_ch Active Timer Active Listen_timr Active Handsh_timr Active Size_probe Active Delay_msmt Active Verf_vack Active Y CC_event Active Y CC_state Active Y Path_state Active Y ECS_state Active ACK_process Active Y Chan_update Active Rcvd_CC_msg Active Rcvd_TR_msg Active Send_TR_msg Active Xmt_failed Active Y VC_state Active ACK_timeout Active Y TMO_listen Y No_path Channel Selection: Local Dev Remote Dev Remote Node Name Selection --------- ---------- ---------------- --------- All channels and VCs selected

SCACP> SHOW TRACE/LOCAL=EWA/REMOTE=EWB NODE10,NODE15/L=F*/R=F*,NODE20
      

The command in this example is equivalent to the following command:

SHOW TRACE NODE10/L=EWA/R=EWB, NODE15/L=F*/R=F*, NODE20/L=EWA/R:EWB

In this example, the command shows tracing for the following channels:

• To node NODE10, channels with local device EWA and remote device EWB
• To node NODE15, channels with local LAN device starting with F and remote LAN device starting with F
• To node NODE20, channels with local LAN device EWA and remote LAN device EWB

Displays PEDRIVER virtual circuit data. Each VC is an SCACP communications path between the local system and a remote system comprised of a set of channels.

Usage Note

Use the SHOW CHANNEL or SHOW VC commands to display node names, which are simply the names of the remote nodes.

Format

SHOW VC nodename

Parameter

nodename[,...]

Includes specific nodes, which you can use wildcards to specify.

Qualifiers

/ALL

Includes all VC data.

/COUNTERS

Includes VC counter data.

/EXCLUDE=(nodename[,...])

Excludes specific nodes, which you can use wildcards to specify.

Use the SHOW CHANNEL or SHOW VC commands to display VC names, which are simply the names of the remote nodes.

/INTERVAL

For the /COUNTERS display, displays the changes to counters since the last SHOW command.

/n

Displays the nth page. To select a particular page of a multipage display, specify the number of the page you want to display.

/OUTPUT=filespec

Creates the specified file and directs output to it.

/SDA

Includes VC data displayed in SDA format.

/SUMMARY

Includes VC summary data. This is the default if /ALL, /COUNTERS, and /SDA qualifiers are not specified.

Examples

SCACP> SHOW VC
      

The command in this example produces output similar to the following:

SYS999 PEA0 VC Summary 31-JAN-2001 10:59:08.74: Remote Total Channels ECS MaxPkt ReXmt XmtWindow Xmt Total Node State Errors Xmt:TMO Open ECS Pri Size TMO(uSec) Cur Max Options Pkts(S+R) ---- ----- ------ ------- ---- --- --- ---- --------- --- --- ------- --------- NODE17 Open 7 1346 13 1 0 7460 453639.7 7 31 10040 NODE22 Open 0 Infinite 13 1 0 1426 3000000.0 1 8 5 . . .

SCACP> SHOW VC/ALL
      

The command in this example produces output similar to the following:

SYS999 PEA0 VC Summary 31-JAN-2001 10:59:11.26: Remote Total Channels ECS MaxPkt ReXmt XmtWindow Xmt Total Node State Errors Xmt:TMO Open ECS Pri Size TMO(uSec) Cur Max Options Pkts(S+R) ---- ----- ------ ------- ---- --- --- ---- --------- --- --- ------- --------- NODE17 Open 7 1346 13 1 0 7460 453639.7 7 31 10040 NODE22 Open 0 Infinite 13 1 0 1426 3000000.0 1 8 5 . . .

SCACP> SHOW VC/COUNTERS NODE10
      

The command in this example displays VC counters for all VCs whose name (remote node name) starts with NODE10.

SCACP> SHOW VC/COUNTERS/INTERVAL
SCACP> SPAWN WAIT 0:0:10
SCACP> SHOW VC/COUNTERS/INTERVAL
      

The first command in this example displays VC counters since the last SHOW command. The SPAWN command tells the DCL WAIT command to insert a 10-second delay. The second SHOW VC command displays counters after the 10-second period.

	privacy and legal statement
6048PRO_056.HTML