High Availability Monitors Version A.03.02 Release Notes

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
ADD_DLC_TRACE
Chapter 3124
ADD_DLC_TRACE
This verb specifies tracing on SNA messages sent on a DLC. It can be
used to activate tracing on a particular DLC, port, or LS, or on a
particular session on a specified LS, and to specify which types of
messages are to be traced. It can also be used to activate tracing on all
DLCs, ports, and LSs. For more information about how to use SNAplus2
tracing, see the HP-UX SNAplus2 Administration Guide.
If multiple ADD_DLC_TRACE verbs relating to the same resource are
issued, a message will be traced if it matches any of the verbs currently
active. For example:
• If you issue a verb to trace all messages for a port and its LSs, and
then issue a second verb to trace only messages with a specified
LFSID for one of the LSs owned by the port, all messages for the LS
will continue to be traced (because they match the first verb). If you
then use REMOVE_DLC_TRACE to remove tracing for the port,
messages on the LS with the specified LFSID will continue to be
traced (because they match the second verb which is still active), but
other messages on this LS will not be traced.
• If you issue a verb to trace XID messages on all resources, and then
issue a second verb to trace SC and DFC messages on a particular LS,
all three message types will be traced for this LS.
VCB Structure
typedef struct add_dlc_trace
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
DLC_TRACE_FILTER filter; /* resource to be traced */
} ADD_DLC_TRACE;
typedef struct dlc_trace_filter
{
unsigned char resource_type; /* type of resource */
unsigned char resource_name[8]; /* name of resource */
SNA_LFSID lfsid; /* session identifier */