DELETE_DLC

DELETE_DLC deletes all ports, link stations, and connection network transmission groups (TGs) associated with the DLC if it is reset. All DLC control blocks are deleted and the memory freed. The Node Operator Facility returns a response specifying whether the DLC was deleted successfully.

Note that if a link station, which has a PU associated with it, is deleted (because it is associated with the DLC) then any LUs defined on this PU will also be deleted.

VCB Structure

typedef struct delete_dlc
{
        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   dlc_name[8];    /* name of DLC           */

} DELETE_DLC;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_DLC
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.
dlc_name
Name of DLC to be deleted. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant and must be set.

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_DLC_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_DLC_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