Requests that an active data link be disconnected.
The primitive consists of one M_PROTO message block, which contains the following structure:
typedef struct { ulong dl_primitive; ulong dl_reason; ulong dl_correlation; } dl_disconnect_req_t;
The DL_DISCONNECT_REQ primitive requests the data link service (DLS) provider to disconnect an active data link connection or one that was in the process of activation. The DL_DISCONNECT_REQ primitive can be sent in response to a previously issued DL_CONNECT_IND or DL_CONNECT_REQ primitive. If an incoming DL_CONNECT_IND primitive is being refused, the correlation number associated with that connect indication must be supplied. The message indicates the reason for the disconnect.
Note: This primitive applies to connection mode.
Valid | The primitive is valid in any of the following states: |
New |
Successful | The DL_OK_ACK primitive is sent to the DLS user resulting in the DL_IDLE state. |
Unsuccessful | The DL_ERROR_ACK primitive is returned, and the resulting state is unchanged. |
DL_BADCORR | Indicates the correlation number specified in this primitive does not correspond to a pending connect indication. |
DL_OUTSTATE | Indicates the primitive was issued from an invalid state. |
DL_SYSERR | Indicates a system error occurred. The system error is indicated in the DL_ERROR_ACK primitive. |
This primitive is part of Base Operating System (BOS) Runtime.
The DL_CONNECT_IND primitive, DL_OK_ACK primitive, DL_ERROR_ACK primitive, DL_CONNECT_REQ primitive.