Previous section.

Data Link Provider Interface (DLPI), Version 2
Copyright © 2000 The Open Group

NAME

DL_DISCONNECT_IND (dl_disconnect_ind_t) - informs the DLS user that the data link connection on this stream has been disconnected, or that apending connection (either DL_CONNECT_REQ or DL_CONNECT_IND ) has been aborted. The primitive indicates the origin and the cause of the disconnect.

SYNOPSIS

The message consists of one M_PROTO message block containing the structure shown below.


typedef struct {
    t_uscalar_t  dl_primitive;
    t_uscalar_t  dl_originator;
    t_uscalar_t  dl_reason;
    t_uscalar_t  dl_correlation;
} dl_disconnect_ind_t;


PARAMETERS

dl_primitive

conveys DL_DISCONNECT_IND.

dl_originator

conveys whether the disconnect was DLS user or DLS provider originated (DL_USER or DL_PROVIDER, respectively ) .

dl_reason

conveys the reason for the disconnect:

Reason for Disconnect

DL_DISC_PERMANENT_CONDITION

connection released due to permanent condition

DL_DISC_TRANSIENT_CONDITION

connection released due to transient condition

DL_CONREJ_DEST_UNKNOWN

unknown destination for connect request

DL_CONREJ_DEST_UNREACH_PERMANENT

could not reach destination for connect request - permanent condition

DL_CONREJ_DEST_UNREACH_TRANSIENT

could not reach destination for connect request - transient condition

DL_CONREJ_QOS_UNAVAIL_PERMANENT

requested quality of service parameters permanently unavailable during connection establishment

DL_CONREJ_QOS_UNAVAIL_TRANSIENT

requested quality of service parameters temporarily unavailable during connection establishment

DL_DISC_UNSPECIFIED

reason unspecified


dl_correlation

if non-zero, conveys the correlation number that was contained in the DL_CONNECT_IND that is being aborted (see Multi-threaded Connection Establishment). This value permits the DLS user to associate the message with the proper DL_CONNECT_IND. If the disconnect indication is indicating the release of a connection that is already established, or is indicating the rejection of a previously sent DL_CONNECT_REQ, the value of dl_correlation will be zero.

STATE

The message is valid in any of the states: DL_DATAXFER,DL_INCON_PENDING, DL_OUTCON_PENDING,DL_PROV_RESET_PENDING,DL_USER_RESET_PENDING.

NEW STATE

The resulting state is DL_IDLE.

Contents Next section Index