LANCP$HELP.HLB  —  SET  DEVICE  Qualifiers (General), /TRACE
       /TRACE=size-option, mask-option, stop-option
       /NOTRACE

    Provides the LAN driver trace settings for the device. By
    default, most LAN drivers do tracing of error conditions and
    state changes. Tracing is controlled by an event mask that
    selects the events to trace, a stop mask that specifies when
    to stop tracing, and the size of the trace buffer.

    You can change tracing settings at any time. The LAN driver
    allocates the trace buffer from non-paged pool. You can calculate
    the amount of pool needed by multiplying the number of entries by
    the size of each entry, 32-bytes.

    The impact of tracing on the system is negligible for error
    and state change events, more significant when all events are
    selected, and very significant when full packet tracing is
    enabled.

    The command SHOW DEVICE/TRACE displays trace results as well as
    the trace mask.

    You can specify the following keywords with this qualifier:

    o  size-option

             SIZE=value

       Use SIZE=value to specify the size of the trace buffer in
       entries, each 32 bytes. The default is 2048 entries. The
       permitted range is 256 to 1000000.

       The size MOD 3 encodes the amount of packet data to include,
       either 35 bytes, 66 bytes, 97 bytes, or the entire packet.

    o  mask-option

             MASK=(value1,value2)

       Use MASK=(value1,value2) to specify the trace mask to select
       which type of entries should be collected in the trace
       buffer. The first 32 bits consist of events common to most
       LAN drivers. The second 32 bits consist of events specific to
       the LAN driver for the specified device.

    o  stop-option

             STOP=(value1,value2)

       Use STOP=(value1,value2) to specify the trace mask to select
       which type of entries should stop tracing. When a trace entry
       is made that matches one of the bits in the stop mask, the
       trace mask is cleared so that you can look at the trace data
       accumulated so far.
Close Help