HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_TRACE_FILE
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 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 */
} SET_TRACE_FILE;
3.183.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_SET_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. This type of tracing is 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).
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.
AP_LEAVE_UNCHANGED
Leave the dual_files setting unchanged from the existing definition. (The initial default, when the
SNAplus2 software is started, is to use two files.)
727