START_DLC

START_DLC requests the activation of a data link control (DLC). It is subsequently returned indicating whether the activation of the DLC was successful. Note that the DLC can be started even if no ports have been defined for it. See DLC Processes, Ports, and Link Stations for more information about the relationship between DLCs, ports, and link stations.

VCB Structure

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

Supplied Parameters

The application supplies the following parameters:
opcode
AP_START_DLC
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 Data Link Control instance that is to be started. This is an 8-byte string in a locally displayable character set, which must have already been defined by a 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
If the verb does not execute because the DLC is deactivating, the Program returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
AP_DLC_DEACTIVATING
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