HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DEFAULT_PU
3.104.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.105 QUERY_DEFAULT_PU
QUERY_DEFAULT_PU allows the user to query the default PU (defined using DEFINE_DEFAULT_PU).
3.105.1 VCB Structure
typedef struct query_default_pu
{
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 def_pu_name[8]; /* default PU name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char def_pu_sess[8]; /* PU name of active default session */
unsigned char reserv3[16]; /* reserved */
} QUERY_DEFAULT_PU;
3.105.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_DEFAULT_PU
3.105.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
def_pu_name
Name of the PU specified on the most recent DEFINE_DEFAULT_PU verb. This is an 8-byte type-A EBCDIC
string (starting with a letter), padded on the right with EBCDIC spaces. If this field is set to all binary zeros,
this indicates that no DEFINE_DEFAULT_PU verb has been issued or that the default PU has been deleted
by issuing a DEFINE_DEFAULT_PU verb with the pu_name parameter specified as all zeros.
description
A null-terminated text string describing the default PU, as specified in the definition of the default PU.
def_pu_sess
Name of the PU associated with the currently active default PU session.
This parameter normally contains the same value as the def_pu_name field. However, if a default PU has been
defined, but the session associated with it is not active, SNAplus2 continues to use the session associated with
388