HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TRACE_TYPE
trace_file_size
The maximum size of the trace file. If dual_files is set to
AP_YES, tracing will switch between the two files
when the current file reaches this size. If dual_files is set to
AP_NO, this parameter is ignored; the file size is
not limited.
file_name
Name of the trace file, or of the first trace file if dual_files is set to
AP_YES. This parameter is an ASCII
string of 1–80 characters, followed by a NULL character (binary zero).
If no path is included, the file is stored in the default directory for diagnostics files,
/var/opt/sna if a path
is included, this is either a full path (starting with a / character) or the path relative to the default directory.
file_name_2
Name of the second trace file; this parameter is used only if dual_files is set to
AP_YES. This parameter is an
ASCII string of 1–80 characters, followed by a NULL character (binary zero).
If no path is included, the file is stored in the default directory for diagnostics files, /var/opt/sna if a path
is included, this is either a full path (starting with a / character) or the path relative to the default directory.
3.167.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_FILE_TYPE
The trace_file_type parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.167.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.168 QUERY_TRACE_TYPE
This verb returns information about the current tracing options for SNAplus2 kernel components. For more
information about tracing options, see the HP-UX SNAplus2 Administration Guide.
This verb does not return information about DLC line tracing. To do this, use the QUERY_DLC_TRACE verb.
This verb must be issued to a running node.
3.168.1 VCB Structure
typedef struct query_trace_type
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
692