DLPI Programmer's Guide

120 Chapter 2
DLPI Primitives
Connection-mode Service Primitives
dl_reason
reason for the disconnection.
DL_DISC_NORMAL_CONDITION: normal release of a data link
connection.
DL_DISC_ABNORMAL_CONDITION: abnormal release of a data
link connection.
DL_CONREJ_PERMANENT_COND: a permanent condition caused
the rejection of a connect request.
DL_CONREJ_TRANSIENT_COND: a transient condition caused the
rejection of a connect request.
DL_UNSPECIFIED: reason unspecified
dl_correlation
if non-zero, conveys the correlation number that was contained in the
DL_CONNECT_IND being rejected. This value permits the DLS
provider to associate the primitive with the proper
DL_CONNECT_IND when rejecting an incoming connection. If
disconnect request is releasing a connection that is already
established, or is aborting a previously sent DL_CONNECT_REQ,
the value of dl_correlation should 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 one of the disconnect pending states, as defined in
Appendix B, Allowable Sequence of DLPI Primitives, of the DLPI 2.0
specification.
Response
If the disconnect is successful, DL_OK_ACK is sent to the DLS user
resulting in state DL_IDLE.
If the request fails, DL_ERROR_ACK is returned, and the resulting
state is unchanged.
Reasons for Failure