DELETE_DSPU_TEMPLATE


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

VCB Structure

Format 1

typedef struct delete_dspu_template
{
        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   template_name[8];    /* name of template          */
        unsigned short  num_of_dslu_templates;
                                             /* Number of DSLU templates  */
        unsigned char   reserv1[10];         /* reserved                  */
} DELETE_DSPU_TEMPLATE;
typedef struct dslu_template
{
        unsigned char   min_nau;             /* min NAU address in range  */
        unsigned char   max_nau;             /* max NAU address in range  */
        unsigned char   allow_timeout;       /* Allow timeout of host LU? */
        unsigned char   delayed_logon;       /* Allow delayed logon to    */
                                             /* host LU                   */
        unsigned char   reserv1[8];          /* reserved                  */
        unsigned char   host_lu[8];          /* host LU or pool name      */
} DSLU_TEMPLATE;

VCB Structure

Format 0

typedef struct delete_dspu_template
{
        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   template_name[8];    /* name of template          */
} DELETE_DSPU_TEMPLATE;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_DSPU_TEMPLATE
attributes
The attributes of the verb. This field is a bit field. The first bit contains the visibilityof 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.
template_name
Name of the DSPU template. (This corresponds to the name specified in the implicit_dspu_template field on PORT_DEF_DATA). This is an 8–byte string in a locally-displayable character set. All 8 bytes are significant and must be set.
num_of_dslu_templates
The number of DSLU template overlays which follow the DEFINE_DSPU_TEMPLATE VCB. This can be from 0 to 255 inclusive. The DSLU templates are appended as overlays to the end of the DELETE_DSPU_TEMPLATE VCB.
dslu_template.min_nau
Minimum NAU address in the range. This can be from 1 to 255 inclusive.
dslu_template.max_nau
Maximum NAU address in the range. This can be from 1 to 255 inclusive.
def_data.allow_timeout
This field is reserved.
def_data.delayed_logon
This field is reserved.
dslu_template.host_lu
This field is reserved.

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_TEMPLATE_NAME

AP_INVALID_NAU_RANGE

If the verb does not execute because one or more relevant START_NODE parameters were not set, the Program returns the following parameter:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
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