HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CS_TRACE
3.104 QUERY_CS_TRACE
This verb returns information about the current 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.104.1 VCB Structure
typedef struct query_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 */
} QUERY_CS_TRACE;
3.104.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_CS_TRACE
dest_sys
The server name for which tracing options are being queried. This is an ASCII string, padded on the right
with spaces if the name is shorter than 128 characters.
To query tracing options 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.
If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name;
otherwise it performs a DNS lookup to determine the computer name.
To query the default tracing options (set by a SET_CS_TRACE verb with no destination system name
specified), set this parameter to all ASCII space characters.
3.104.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Not used.
trace_flags
386