STOP_DLC

STOP_DLC requests that a DLC be stopped. It is returned indicating whether the DLC was successfully stopped. STOP_DLC is also used to instruct the Program to stop automatically retrying the activation of any link stations on ports over this DLC.

VCB Structure

typedef struct stop_dlc
{
        unsigned short  opcode;         /* verb operation code   */
        unsigned char   reserv2;        /* reserved              */
        unsigned char   format;         /* format                */
        unsigned short  primary_rc;     /* primary return code   */
        unsigned long   secondary_rc;   /* secondary return code */
        unsigned char   stop_type;      /* stop type             */
        unsigned char   dlc_name[8];    /* name of DLC           */
} STOP_DLC;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_STOP_DLC
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
stop_type
Manner in which DLC should be stopped.
AP_ORDERLY_STOP
Node should perform cleanup operations before stopping DLC.
AP_IMMEDIATE_STOP
Node should stop DLC immediately.
dlc_name
Name of DLC to be stopped. This is an 8-byte string in a locally displayable character set, which must match that on the DEFINE_DLC verb.

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

AP_UNRECOGNIZED_DEACT_TYPE

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_STOP_DLC_PENDING
If the verb does not execute because it has been canceled, the Program returns the following parameter:
primary_rc
AP_CANCELLED
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