[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
AIX Version 4.3 Communications Technical Reference, 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. |
Implementation Specifics
This primitive is part of Base Operating System (BOS) Runtime.
Related Information
The DL_CONNECT_IND primitive, DL_CONNECT_REQ primitive.
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]