DEFINE_DEFAULT_PU

DEFINE_DEFAULT_PU allows the user to define, redefine, or modify any field of a default PU. It also allows the user to delete the default PU, by specifying a null PU name. If a PU name is not specified explicitly on a TRANSFER_MS_DATA verb, then the management services information carried on the TRANSFER_MS_DATA is sent on the default PU's session with the host SSCP. For more information about this see Management Services Verbs.

VCB Structure

typedef struct define_default_pu
{
        unsigned short  opcode;         /* verb operation code   */
        unsigned char   reserv2;        /* reserved              */
        unsigned char   format;         /* format                */
        unsigned short  primary_rc;     /* primary return code   */
        unsigned long   secondary_rc;   /* secondary return code */
        unsigned char   pu_name[8];     /* PU name               */
        unsigned char   description[RD_LEN];
                                        /* resource description  */
        unsigned char   reserv3[16];    /* reserved              */
} DEFINE_DEFAULT_PU;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_DEFINE_DEFAULT_PU
format: Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
pu_name: Name of local PU that will serve as the default. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
description: Resource description (returned on QUERY_DEFAULT_PU). This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:

primary_rc: AP_OK

If the verb does not execute because the node has not yet been started, the Program returns the following parameter:

primary_rc: AP_NODE_NOT_STARTED

If the verb does not execute because the node is stopping, the Program returns the following parameter:

primary_rc: AP_NODE_STOPPING

If the verb does not execute because of a system error, the Program returns the following parameter:

primary_rc: AP_UNEXPECTED_SYSTEM_ERROR