HP-UX SNAplus2 R7 NOF Programmer's Guide

ManualsBrandsHP ManualsSoftwareHP-UX SNAplus2 Software

NOF API Verbs

ADD_DLC_TRACE

3.3 ADD_DLC_TRACE

This verb speciﬁes tracing on SNA messages sent on a DLC. It can be used to activate tracing on a particular

DLC, port, LS, or HPR RTP connection, or on a particular session on a speciﬁed LS, and to specify which types of

messages are to be traced. It can also be used to activate tracing on all DLCs, ports, link stations, and HPR RTP

connections. 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 speciﬁed LFSID for one of the LSs owned by the port, all messages for the LS will continue

to be traced (because they match the ﬁrst verb). If you then use REMOVE_DLC_TRACE to remove tracing

for the port, messages on the LS with the speciﬁed 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.

If you are tracing an SDLC line and would like more detailed trace information, you can get this by using internal

tracing on SDLC as well as line tracing. The additional detail is formatted as part of the output for line tracing, so

that you will see all of the SDLC tracing in one ﬁle. For more information, see Section 3.184, SET_TRACE_TYPE.

3.3.1 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 */

unsigned char message_type; /* type of messages */

} DLC_TRACE_FILTER;

typedef struct sna_lfsid

{

union

{

AP_UINT16 session_id;

struct

{

unsigned char sidh;

unsigned char sidl;

}s;

} uu;

AP_UINT16 odai;

} SNA_LFSID;