DELETE_LS

DELETE_LS checks that the link station has been previously defined and reset. It removes the link station control block and returns a response from the Node Operator Facility specifying whether the link station has been deleted successfully. Note that any LUs defined on the PU using this link station will also be deleted.

VCB Structure

typedef struct delete_ls
{
        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   ls_name[8];     /* name of link station  */
} DELETE_LS;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_LS
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.
ls_name
Name of link station being 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_LINK_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_LS_ACTIVE

AP_INVALID_LINK_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 parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR