Starts or resumes PEdriver tracing, optionally setting tracing
options.
NOTE
This command is reserved for use by VSI Services and OpenVMS
Engineering only. Trace commands, their qualifiers, and
output are subject to change from release to release.
Format
START TRACE nodename
1 – Parameter
nodename[,...]
Includes information about communications with 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, the VC and 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 /AFTER
/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.
n can be any value between 0 and FFFFFFF.
2.2 /DEFAULT
Sets the trace context back to the default settings, which are:
channelname=*
/AFTER=0
/EVENT=default settings
/STOP
/SIZE=512
2.3 /EVENT
/EVENT=(event1[,...])
Enables tracing on specific events, which you can use wildcards
to specify. 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.
2.4 /EXCLUDE
/EXCLUDE=(landevicename/IPinterface[,...])
Excludes specific LAN devices/IP interfaces, which you can use
wildcards to specify.
Use the SHOW LAN_DEVICE/SHOW IP_INTERFACE command to display
device names.
2.5 /LOCAL_DEVICE
/LOCAL_DEVICE=(landevicename/IPinterface[,...])
Includes specific LAN devices that identify the local end of
the channel. You can use wildcards to specify LAN devices/IP
interfaces.
Use the SHOW LAN_DEVICE/SHOW IP_INTERFACE command to display
device names.
2.6 /REMOTE_DEVICE
/REMOTE_DEVICE=(landevicename/IPinterface[,...])
Includes specific LAN devices that identify the remote end of
the channel. You can use wildcards to specify LAN devices/IP
interfaces.
Use the SHOW LAN_DEVICE/SHOW IP_INTERFACE command to display
device names.
2.7 /STOP
/STOP=(event[,...])
Stops tracing on specific events, which you can use wildcards to
specify. The default is to stop no events.
Use the SHOW TRACE/CONTEXT command to display event names.
2.8 /SIZE
/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. n can be any
value between 0 and FFFFFFF.
3 – 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.