STOP_INTERNAL_PU

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

VCB Structure

typedef struct stop_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   stop_type;      /* type of stop requested */
} STOP_INTERNAL_PU;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_STOP_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 will be deactivated. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
stop_type: Specifies stop type requested for the PU. An orderly stop will deactivate all underlying PLU-SLU and SSCP-LU sessions before deactivating the SSCP-PU session.
AP_ORDERLY_STOP
AP_IMMEDIATE_STOP

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_STOP_TYPE

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_PU_NOT_DEFINED
AP_PU_ALREADY_DEACTIVATING
AP_PU_NOT_ACTIVE

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