SET TRACE sets or modifies PEdriver tracing 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

      SET TRACE  nodename

1  –  Parameter

 nodename[,...]

    Includes channels and VCs 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, as well as the
    VC to the specified node.

    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, continue
    tracing for n events, and then stop. 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:

           trace all channels and VCs
           /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 when the system parameter SYSTEM_
    CHECK is set to 0. The default is "all events included" when
    SYSTEM_CHECK is set to 1.

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

2.4    /EXCLUDE

       /EXCLUDE=(nodename[/LOCAL_
       DEVICE=landevicename/ipinterfacename]
       [/REMOTEDEVICE=landevicename/ipinterfacename][,...])

    Excludes VCs or channels, or both, 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, the VC and all
    channels associated with the specified node are excluded.

2.5    /LOCAL_DEVICE

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

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

2.6    /REMOTE_DEVICE

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

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

    Use the SHOW LAN_DEVICE command to display device names.

2.7    /STOP

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

    Stops tracing on specific events, which you can use wildcards to
    specify. The default is "no events included."

    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> SET TRACE/EVENT=CC_STATE/SIZE=1000

      The command in this example specifies that the trace buffers
      for each channel, VC, and the global buffer each be 1000 bytes
      in length.

    2.SCACP> SET TRACE/EVENT=* NODE10/LOCAL=EWA,NODE20

      The command in this example specifies that all events are to be
      recorded; when applicable to a particular node, however, only
      channels and VCs to nodes NODE10 and NODE20 are to be included.

    3.SCACP> SET TRACE/EVENT=(ALL,NOTIMER) NODE10

      The command in this example specifies that all events except
      timer events on node NODE10 are to be included.