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

120

Chapter 2