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.