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.

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.