Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX SNAplus2 NOF Programmers Guide: HP-UX 11i > Chapter 3 NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)

DEFINE_DEFAULT_PU

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

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 Programmers Guide.

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;

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.

Returned Parameters: Successful Execution

If the verb executes successfully, SNAplus2 returns the following parameters:

primary_rc

AP_OK

Returned Parameters: Other Conditions

Appendix A “Common Return Codes” lists further combinations of primary and secondary return codes that are common to all NOF verbs.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2003 Hewlett-Packard Development Company, L.P.