DLPI Programmer's Guide

114 Chapter 2
DLPI Primitives
Connection-mode Service Primitives
dl_correlation
correlation number that was received with the DL_CONNECT_IND
associated with the connection request. The DLS provider will use the
correlation number to identify the connect indication to which the
DLS user is responding.
dl_resp_token
if non-zero, the token associated with the responding stream on which
the DLS provider is to establish the connection; this stream must be
attached to a PPA and bound to a DLSAP.
dl_qos_length
length of the quality of service parameter. This should be the same
parameter specified in the DL_CONNECT_IND.
dl_qos_offset
offset from the beginning of the M_PROTO message block where the
quality of service parameters begin.
dl_growth
growth field for future enhancements to this primitive. Its value will
be set to zero.
State
The primitive is valid in state DL_INCON_PENDING.
New State
The resulting state is DL_CONN_RES_PENDING.
Response
If the connect response is successful, DL_OK_ACK is sent to the DLS
user. If no outstanding connect indications remain, the resulting state for
the current stream is DL_IDLE; otherwise, it remains
DL_INCON_PENDING. For the responding stream (designated by the
parameter dl_res_token), the resulting state is DL_DATAXFER. If the
current stream and responding stream are the same, the resulting state
of that stream is DL_DATAXFER. These streams may only be the same
when the response corresponds to the only outstanding connect
indication.