HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DLC_TRACE
Unpadded length, in bytes, of data specific to the type of DLC. The data structure for this data follows the
def_data
structure, but is padded to start on a 4-byte boundary. For more details of the DLC-specific data, see
Section 3.19,
DEFINE_DLC.
3.110.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
Possible values are:
AP_INVALID_DLC_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE, to list all entries starting from the
supplied name, but the dlc_name parameter was not valid.
AP_INVALID_LIST_OPTION
The list_options 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.110.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.111 QUERY_DLC_TRACE
QUERY_DLC_TRACE returns information about DLC line tracing, which was set up using ADD_DLC_TRACE
verbs.
This verb can be used to obtain information about tracing on all resources, on a specific resource type, or on a spe-
cific resource, depending on the options used.
3.111.1 VCB Structure
typedef struct query_dlc_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 *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char list_type; /* type of listing required */
409