[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 1
DL_DISCONNECT_IND Primitive
Purpose
Informs the data link service (DLS) user that the data
link connection on the current stream has been disconnected, or that a pending
connection has been cancelled.
Structure
The primitive consists of one M_PROTO message block, which contains the following structure:
typedef struct
{
ulong dl_primitive;
ulong dl_originator;
ulong dl_reason;
ulong dl_correlation;
} dl_disconnect_ind_t;
Description
The DL_DISCONNECT_IND primitive
informs the DLS user of one of the following conditions:
- The data link connection on the current stream
has been disconnected.
- A pending connection from either the DL_CONNECT_REQ or DL_CONNECT_IND primitive
has been cancelled.
The primitive indicates the origin and the cause of
the disconnect.
Note
This primitive applies to connection mode.
Parameters
dl_primitive |
Specifies the DL_DISCONNECT_IND primitive. |
dl_originator |
Indicates whether the disconnect originated from a DLS user or provider.
Valid values are DL_USER and DL_PROVIDER. |
dl_reason |
Specifies the reason for the disconnect. Reasons for disconnect are:
- DL_DISC_PERMANENT_CONDITION
- Indicates the connection was released because of a permanent condition.
- DL_DISC_TRANSIENT_CONDITION
- Indicates the connection was released because of a temporary condition.
- DL_CONREJ_DEST_UNKNOWN
- Indicates the connect request has an unknown destination.
- DL_CONREJ_DEST_UNREACH_PERMANENT
- Indicates the connection was released because the destination for
connect request could not be reached. This is a permanent condition.
- DL_CONREJ_DEST_UNREACH_TRANSIENT
- Indicates the connection was released because the destination for
connect request could not be reached. This is a temporary condition.
- DL_CONREJ_QOS_UNAVAIL_PERMANENT
- Indicates the requested quality of service (QOS) parameters became
permanently unavailable while establishing a connection.
- DL_CONREJ_QOS_UNAVAIL_TRANSIENT
- Indicates the requested QOS parameters became temporarily unavailable
while establishing a connection.
- DL_DISC_UNSPECIFIED
- Indicates the connection was closed because of an unspecified reason.
|
dl_correlation |
If the value is nonzero, specifies the correlation number contained
in the DL_CONNECT_IND primitive being cancelled.This
value permits the DLS user to associate the message with the proper DL_CONNECT_IND primitive. If the disconnect request indicates the release
of a connection that is already established, or is indicating the rejection
of a previously sent DL_CONNECT_REQ primitive, the value
of the dl_correlation parameter is zero. |
States
Valid |
The primitive is valid in any of the following states:
- DL_DATAXFER
- DL_INCON_PENDING
- DL_OUTCON_PENDING
- DL_PROV_RESET_PENDING
- DL_USER_RESET_PENDING
|
New |
The resulting state is DL_IDLE. |
Related Information
The DL_CONNECT_IND primitive, DL_CONNECT_REQ primitive.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]