HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_DEFAULT_PU
3.16 DEFINE_DEFAULT_PU
DEFINE_DEFAULT_PU specifies which PU is the default for handling SNAplus2 management services data. Only
one default PU for each node can be defined at any time; a second DEFINE_DEFAULT_PU verb for a different
PU name overrides the previous definition.
DEFINE_DEFAULT_PU enables the user to define, redefine, or modify any field of a default PU. This verb also
enables the user to delete the default PU, by specifying a null PU name.
If an application issues the MS API verb TRANSFER_MS_DATA without specifying a PU name, then the data is
routed to the default PU defined for the local node, and sent on this PU’s session with the host SSCP. For more
information about TRANSFER_MS_DATA, see the
HP-UX SNAplus2 MS Programmer’s Guide.
3.16.1 VCB Structure
typedef struct define_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 pu_name[8]; /* PU name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char reserv3[16]; /* reserved */
} DEFINE_DEFAULT_PU;
3.16.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_DEFAULT_PU
pu_name
Name of the default PU; this must be a PU name defined by a previous DEFINE_LS verb. This is an 8-byte
type-A EBCDIC string (starting with a letter), padded on the right with EBCDIC spaces if necessary.
To delete the default PU, specify all zeros.
description
A null-terminated text string (0–31 characters followed by a null character) describing the PU. This string is
for information only; it is stored in the node’s configuration file and returned on the QUERY_DEFAULT_PU
verb, but SNAplus2 does not make any other use of it.
3.16.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
124