HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TRACE_FILE
unsigned char trace_file_type; /* type of trace file */
unsigned char dual_files; /* dual trace files */
AP_UINT32 trace_file_size; /* trace file size */
unsigned char reserv3[4]; /* reserved */
unsigned char file_name[81]; /* file name */
unsigned char file_name_2[81]; /* second file name */
} QUERY_TRACE_FILE;
3.167.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_TRACE_FILE
trace_file_type
The type of trace file. Possible values are:
AP_CS_TRACE
File contains tracing on data transferred across the SNAplus2 LAN between the specified computer and
other nodes (activated by the SET_CS_TRACE verb).
AP_BCK_CS_TRACE
File contains tracing on data transferred across the SNAplus2 LAN between a current-level server and
back-level computers (activated by the SET_BCK_CS_TRACE verb).
AP_TN_SERVER_TRACE
File contains tracing on the SNAplus2 TN server component.
AP_IPS_TRACE
File contains tracing on kernel components for the specified node (activated by the SET_TRACE_TYPE
or ADD_DLC_TRACE verb).
3.167.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Not used.
dual_files
Specifies whether tracing is to one file or to two files. Possible values are:
AP_YES
Tracing is to two files. When the first file reaches the size specified by trace_file_size, the second
file is cleared, and tracing continues to the second file. When this file then reaches the size specified
by trace_file_size, the first file is cleared, and tracing continues to the first file. This ensures that
tracing can continue for long periods without using excessive disk space; the maximum space required
is approximately twice the value of trace_file_size.
AP_NO
Tracing is to one file.
691