HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_CS_TRACE
3.176 SET_CS_TRACE
This verb specifies tracing options for data sent between computers on the SNAplus2 LAN. For more information
about tracing options, see the HP-UX SNAplus2 Administration Guide.
This verb must be issued to a running node.
3.176.1 VCB Structure
typedef struct set_cs_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 */
unsigned char dest_sys[128]; /* node to which messages are traced */
unsigned char reserv4[4]; /* reserved */
AP_UINT16 trace_flags; /* trace flags */
AP_UINT16 trace_direction; /* direction (send/rcv/both) to trace */
unsigned char reserv3[8]; /* reserved */
} SET_CS_TRACE;
3.176.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_SET_CS_TRACE
dest_sys
The server name for which tracing is required. This is an ASCII string, padded on the right with spaces if
the name is shorter than 128 characters.
To manage tracing on messages flowing between the computer to which this verb is issued (identified by the
target_handle parameter on the NOF API call) and one other server on the LAN, specify the name of the
other server here. Tracing on messages flowing to and from other computers on the LAN will be unchanged;
in particular, you can issue two SET_CS_TRACE verbs to activate tracing between the same target computer
and two different destination servers.
If the server name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name;
otherwise it performs a DNS lookup to determine the server name.
To manage tracing on messages flowing between the computer to which this verb is issued (identified by the
target_handle parameter on the NOF API call) and all other servers and clients on the LAN, set this parameter
to 128 ASCII space characters. The options you specify on this verb override any previous settings for tracing
to specific computers (identified by dest_sys on the previous verbs).
trace_flags
The types of tracing required. To turn off all tracing, or to turn on tracing of all types, specify one of the
following values:
AP_NO_TRACE
No tracing.
AP_ALL_TRACE
712