DELETE_LU_0_TO_3_RANGE

This verb is used to delete a range of LUs. The node operator provides a base name and an NAU range. The LU names are generated by combining the base name with the NAU addresses.

For example, a base name of LUNME combined with an NAU range of 1 to 4 would delete the LUs LUNME001, LUNME002, LUNME003, and LUNME004. A base name of less than five non-pad characters results in LU names of less than eight non-pad characters.

All LUs in the range are deleted. If an LU in the range does not exist, then the verb continues with the next one that does exist. The verb fails if no LUs exist in the specified range.

VCB Structure

Format 1 
typedef struct delete_lu_0_to_3_range
{
        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   base_name[6];          /* base name                  */
        unsigned char   min_nau;               /* minimum NAU address        */
        unsigned char   max_nau;               /* maximum NAU address        */
        unsigned char   name_attributes;       /* Attributes of base_name    */
        unsigned char   base_number;           /* Base number for LU names   */
        unsigned char   reserv5[16];           /* reserved                   */
} DELETE_LU_0_TO_3_RANGE;

VCB Structure

Format 0 
typedef struct delete_lu_0_to_3_range
{
        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   base_name[5];          /* base name                  */
        unsigned char   min_nau;               /* minimum NAU address        */
        unsigned char   max_nau;               /* maximum NAU address        */
        unsigned char   reserv3;               /* reserved                   */
} DELETE_LU_0_TO_3_RANGE;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_LU_0_TO_3_RANGE
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.
base_name
Base LU name. This is an 5-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces. This base name is appended with three type-A EBCDIC numeric characters, representing the decimal value of the NAU address, for each LU in the NAU range.
min_nau
Minimum NAU address in the range. This can be from 1 to 255 inclusive.
max_nau
Maximum NAU address in the range. This can be from 1 to 255 inclusive.
name_attributes
This bit field modifies the interpretation and usage of the supplied base_name. This field may take the value of zero, or any or all of the following values bit-wise ORed together.
AP_USE_HEX_IN_NAME
If this bit is set, the interpretation of the base_name is modified as follows:

This is a 6-byte alphanumeric types A EBCDID string (starting with a letter), padded to the right with EBCDID spaces. This base name is appended with two EBCDID characters, representing the hexadecimal values of the NAU address, for each LU in the NAU range.

AP_USE_BASE_NUMBER
If this bit is set, the interpretation of the base_name is modified as follows:

This is a 5-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces. This base name is appended with three EBCDIC numeric characters, representing the decimal index of the LU in the range, starting with base_number and ending with (base_number + max_nau + min_nau).

base_number
If the AP_USE_BASE_NUMBER bit is not set in name_attributes this field is ignored. Otherwise, this field modifies the interpretation of base_name as described above. Legal values are from zero to (255 – max_nau + min_nau).

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_NAU_ADDRESS

AP_INVALID_LU_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_INVALID_LU_NAME

AP_CANT_DELETE_IMPLICIT_LU

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