HP OpenVMS Systems Documentation

OpenVMS System Management Utilities Reference Manual

Contents

Index

SHOW TRACE

Displays PEDRIVER tracing data and parameters.

Note

This command is reserved for use by Compaq Services and OpenVMS Engineering only. Trace commands and output are subject to change from release to release.

Format

SHOW TRACE nodename

Parameters

nodename[,nodename1,nodename2,...]
Includes channels to specific nodes, which you can specify using wildcards. 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.
Use the SHOW CHANNEL command to display node names and local and remote device names.

Qualifiers

/CONTEXT
Displays only PEDRIVER trace settings and the event definition. If this qualifier is not included, trace event data is displayed.
/EVENT[=(event1,event2,...)]
Enables tracing on specific events, which you can specify using wildcards. The default is all of the events that are in the trace buffer.
Use the SHOW TRACE/CONTEXT command to display event names.
/EXCLUDE[=(nodename1,nodename2,...)]
Excludes channels to specific nodes, which you can specify using wildcards. 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[=(landevicename1,landevice2,...)]
Includes specific LAN devices that identify the local end of the channel; you can use wildcards to specify LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
/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[=(landevicename1,landevice2,...)]
Includes specific LAN devices which identify the remote end of the channel, which you can specify using wildcards.
Use the SHOW LAN_DEVICE command to display device names.
/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.

Examples

#1
(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

#2
SCACP> SHOW TRACE/CONTEXT

The command in this example displays trace settings and definition.

#3
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

#4
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

SHOW VC

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

Parameters

nodename[,nodename1,nodename2,...]
Includes specific nodes, which you can specify using wildcards.

Qualifiers

/ALL
Includes all VC data.
/COUNTERS
Includes VC counter data.
/EXCLUDE[=(nodename1,nodename2,...)]
Excludes specific nodes, which you can specify using wildcards.
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

#1
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

   .
   .
   .

#2
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
   .
   .
   .

#3
SCACP> SHOW VC/COUNTERS NODE10

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

#4
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.

SPAWN

Creates a subprocess of the current process. The SPAWN command copies the context of the subprocess from the current process.

Format

SPAWN [command-string]

Parameters

command-string
A string of commands to be executed in the context of the created subprocess. After the command string is executed, control returns to SCACP.

Qualifiers

None.

Example


SCACP> SPAWN SHOW TIME 24-AUG-2000 15:22:39 SCACP>

The command in this example creates a subprocess of the current process and displays the time.

START LAN_DEVICE

Directs PEDRIVER to start using the specified LAN device. The original (and still supported) means of starting PEDRIVER on a LAN device is SYS$EXAMPLES:LAVC$START_BUS.

Format

START LAN_DEVICE landevicename

Parameters

landevicename[,landevice1,landevice2,...]
Includes specific LAN devices, which you can specify using wildcards.
Use the /EXCLUDE qualifier to exclude LAN devices.
Use the SHOW LAN_DEVICE command to display device names.

Qualifiers

/EXCLUDE[=(landevicename1,landevicename2,...)]
Excludes specific LAN devices, which you can specify using wildcards.
Use the SHOW LAN_DEVICE command to display device names.

Example


SCACP> START DEVICE EWA

This command starts PEDRIVER on the LAN device EWA.

START TRACE

Starts or resumes PEDRIVER tracing, optionally setting tracing options.

Note

This command is reserved for use by Compaq Services and OpenVMS Engineering only. Trace commands and output are subject to change from release to release.

Format

START TRACE nodename

Parameters

nodename[,nodename1,nodename2,...]
Includes channels to specific nodes, which you can specify using wildcards. 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.
Use the SHOW CHANNEL command to display node names and local and remote device names.

Qualifiers

/AFTER[=n]
After the trace stop condition has been satisfied, continues tracing for n events, and then stops. If you do not specify /AFTER, tracing does not continue after the trace stop event.
/DEFAULT
Sets the trace context back to the default settings, which are:
channelname=* /AFTER=0 /EVENT=default settings /STOP /SIZE=512
/EVENT[=(event1,event2,...)]
Enables tracing on specific events, which you can specify using wildcards. The default is a subset of the events, which includes most errors and state changes.
Use the SHOW TRACE/CONTEXT command to display event names.
/EXCLUDE[=(landevicename1,landevicename2,...)]
Excludes specific LAN devices, which you can specify using wildcards.
Use the SHOW LAN_DEVICE command to display device names.
/LOCAL_DEVICE[=(landevicename1,landevice2,...)]
Includes specific LAN devices which identify the local end of the channel; you can use wildcards to specify LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
/REMOTE_DEVICE[=(landevicename1,landevice2,...)]
Includes specific LAN devices which identify the remote end of the channel, which you can specify using wildcards.
Use the SHOW LAN_DEVICE command to display device names.
/STOP[=(event1,event2,...)]
Stops tracing on specific events, which you can specify using wildcards. The default is to stop no events.
Use the SHOW TRACE/CONTEXT command to display event names.
/SIZE[=n]
Specifies a trace buffer size of n bytes to be used by PEDRIVER for each trace buffer: one for global PEDRIVER use, one for each selected channel, and one for each selected VC.

Examples

#1
SCACP> START TRACE/EVENT=CC_STATE/SIZE=2000

The command in this example changes the Trace Channel Control layer state with a 2000-byte trace buffer.

#2
SCACP> START TRACE/EVENT=ALL NODE10,NODE20

The command in this example traces all events but only for the NODE10 and NODE20 channels.

#3
SCACP> START TRACE/LOCAL=EWA/REMOTE=EWB NODE10, NODE15/L=F/R=F, NODE20

The command in this example is equivalent to the following command:
START TRACE NODE10/L=EWA/R=EWB, NODE15/L=F*/R=F*, NODE20/L=EWA/R:EWB
In the example, the command starts 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

STOP LAN_DEVICE

Directs PEDRIVER to stop using the specified LAN device. The original (and still supported) means of stopping PEDRIVER on a LAN devices is SYS$EXAMPLES:LAVC$START_BUS.

Caution
As with SYS$EXAMPLES:LAVC$STOP_BUS, you can cause the system to CLUEXIT if you do not maintain at least one path to each member of the cluster.

Format

STOP LAN_DEVICE landevicename

Parameters

landevicename[,landevice1,landevice2,...]
Includes specific LAN devices, which you can specify using wildcards.
Use the /EXCLUDE qualifier to exclude LAN devices.
Use the SHOW LAN_DEVICE command to display device names.

Qualifiers

/EXCLUDE[=(landevicename1,landevicename2,...)]
Excludes specific LAN devices, which you can specify using wildcards.
Use the SHOW LAN_DEVICE command to display device names.

Example


SCACP> STOP LAN_DEVICE EWA

This command stops PEDRIVER on the LAN device EWA.

STOP TRACE

Stops PEDRIVER tracing. You can read the trace data recorded so far with a SHOW TRACE command.
To revert trace behavior to initial settings, enter the command SET TRACE/DEFAULT.

Note

This command is reserved for use by Compaq Services and OpenVMS Engineering only. Trace commands and output are subject to change from release to release.

Format

STOP TRACE

Parameters

None.

Qualifiers

None.

Example


SCACP> STOP TRACE

The command in this example stops PEDRIVER tracing.

Contents

Index