START_INTERNAL_PU

The START_INTERNAL_PU verb requests the dependent LU requester (DLUR) to initiate SSCP-PU session activation for a previously defined local PU that is served by DLUR.

VCB Structure

typedef struct start_internal_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];         /* internal PU name      */
        unsigned char   dlus_name[17];      /* DLUS name             */
        unsigned char   bkup_dlus_name[17]; /* Backup DLUS name      */
} START_INTERNAL_PU;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_START_INTERNAL_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 the internal PU for which the SSCP-PU session activation flows will be solicited. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
dlus_name: Name of the dependent LU server (DLUS) node that DLUR will contact to solicit SSCP-PU session activation for the given PU. This should be set to all zeros or a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.) This value overrides the value specified in the DEFINE_INTERNAL_PU verb. If the field is set to all zeros, the DLUS specified in the DEFINE_INTERNAL_PU verb will be used. If no DLUS has been specified in the DEFINE_INTERNAL_PU verb, then the global default (if specified by a DEFINE_DLUR_DEFAULTS verb) will be used.
bkup_dlus_name: Name of the DLUS node that DLUR will store as the backup DLUS for the given PU. This should be set to all zeros or a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.) This value overrides the value specified in the DEFINE_INTERNAL_PU verb. If the field is set to all zeros, the backup DLUS name specified by a DEFINE_INTERNAL_PU verb will be retained as the backup DLUS for this PU. If no backup DLUS was specified by the DEFINE_INTERNAL_PU verb, the global backup default DLUS (if defined by the DEFINE_DLUR_DEFAULTS verb) is retained as the backup default for this PU.

Returned Parameters

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

primary_rc: AP_OK

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

primary_rc: AP_PARAMETER_CHECK
secondary_rc: AP_INVALID_DLUS_NAME
AP_INVALID_BKUP_DLUS_NAME

If the verb does not execute because of a state error, the Program returns the following parameters:

primary_rc: AP_STATE_CHECK
secondary_rc: AP_NO_DEFAULT_DLUS_DEFINED
AP_PU_NOT_DEFINED
AP_PU_ALREADY_ACTIVATING
AP_PU_ALREADY_ACTIVE

If the verb does not execute successfully, the Program returns the following parameters:

primary_rc: AP_UNSUCCESSFUL
secondary_rc: AP_DLUS_REJECTED
AP_DLUS_CAPS_MISMATCH
AP_PU_FAILED_ACTPU

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