Displays PEdriver tracing data and parameters.
NOTE
This command is reserved for use by VSI Services and OpenVMS
Engineering only. Trace commands and output are subject to
change from release to release.
Format
SHOW TRACE nodename
1 – 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.
Use the SHOW CHANNEL command to display node names and local and
remote device names.
2 – Qualifiers
2.1 /CONTEXT
Displays only PEdriver trace settings and the event definition.
If this qualifier is not included, trace event data is displayed.
2.2 /EVENT
/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.
Use the SHOW TRACE/CONTEXT command to display event names.
2.3 /EXCLUDE
/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.
2.4 /GLOBAL
/GLOBAL (default when no nodes are specified)
/NOGLOBAL (default when nodes are specified)
Specifies whether or not global trace data is to be returned.
2.5 /INPUT
/INPUT=filename
Reads trace data from the specified file and displays it.
2.6 /LOCAL_DEVICE
/LOCAL_DEVICE=(landevicename[,...])
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.
2.7 /OUTPUT
/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.
2.8 /REMOTE_DEVICE
/REMOTE_DEVICE=(landevicename[,...])
Includes specific LAN devices which identify the remote end of
the channel, which you can use wildcards to specify.
Use the SHOW LAN_DEVICE command to display device names.
2.9 /SORT
/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.
3 – Examples
1.SCACP> SHOW TRACE/CONTEXT
The command in this example displays trace settings and
definition.
2.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