DELETE_LU_POOL

This verb is used to delete an LU pool or to remove LUs from a pool. If no LU names are specified, the entire pool is removed. This verb completes successfully when the specified LUs within the LU pool, or the LU pool itself, no longer exist. The verb only fails if none of the specified LUs exist, or if there are no LUs in the specified pool.

VCB Structure

typedef struct delete_lu_pool
{
        unsigned short  opcode;                /* verb operation code        */
        unsigned char   attributes;            /* verb attributes            */
        unsigned char   format;                /* format                     */
        unsigned short  primary_rc;            /* primary return code        */
        unsigned long   secondary_rc;          /* secondary return code      */
        unsigned char   pool_name[8];          /* LU pool name               */
        unsigned short  num_lus;               /* number of LUs to add       */
        unsigned char   lu_names[10][8];       /* LU names                   */
} DELETE_LU_POOL;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_LU_POOL
attributes
The attributes of the verb. This field is a bit field. The first bit contains the visibility of the resource to be defined and corresponds to one of the following:

AP_EXTERNALLY_VISIBLE
AP_INTERNALLY_VISIBLE

format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
pool_name
Name of the LU pool. All 8 bytes are significant and must be set. This name is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
num_lus
Number of LUs specified in the lu_names list.
lu_names
Names of the LUs to be removed. Each name is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.

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_POOL_NAME

AP_INVALID_LU_NAME
AP_INVALID_NUM_LUS

If the verb does not execute because the system has not been built with dependent LU support, the Program returns the following parameter:
primary_rc
AP_INVALID_VERB
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