DELETE_DOWNSTREAM_LU_RANGE


The Communications Server icon lets you know that there is a change in the way things operate.
 This verb applies only to Communications Server.

For example, a base name of LUNME combined with an NAU range of 1 to 4 deletes 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.

This verb deletes all LUs in the range. If an LU in the range does not exist, then the verb continues with the next one that does exist. The verb only fails if no LUs exist in the specified range.

VCB Structure

typedef struct delete_downstream_lu_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   dslu_base_name[5];/* Downstream LU base name    */
        unsigned char   min_nau;          /* min NAU address in range   */
        unsigned char   max_nau;          /* max NAU address in range   */
} DELETE_DOWNSTREAM_LU_RANGE;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_DOWNSTREAM_LU_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.
dslu_base_name
Base name for downstream LU name range. 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 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.

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

AP_INVALID_LU_NAME
AP_DSLU_ACTIVE
AP_DELAYED_VERB_PENDING

secondary_rc
AP_INVALID_LU_NAME
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 parameters:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR