DL_TEST_REQ(7dlpi) DL_TEST_REQ(7dlpi)
NAME
DL_TEST_REQ - Message Type
SYNOPSIS
The message consists of one M_PROTO message block, followed by
zero or more M_DATA blocks containing zero or more bytes of
data. The message structure is as follows:
typedef struct {
ulong dl_primitive;
ulong dl_flag;
ulong dl_dest_addr_length;
ulong dl_dest_addr_offset;
} dl_test_req_t;
DESCRIPTION
Conveys one TEST command DLSDU from the DLS User to the DLS
Provider for transmission to a peer DLS Provider.
Parameters
dl_primitive conveys DL_TEST_REQ
dl_flag indicates flag values for the request as follows:
DL_POLL_FINAL
indicates if the poll/final bit is
set.
dl_dest_addr_length
conveys the length of the DLSAP address of the
destination DLS User. If the destination user is
implemented using DLPI, this address is the full
DLSAP address returned on the DL_BIND_ACK.
dl_dest_addr_offset
conveys the offset from the beginning of the
M_PROTO message block where the destination DLSAP
address begins.
State
The message is valid in states DL_IDLE and DL_DATAXFER.
New State
The resulting state is unchanged.
Copyright 1994 Novell, Inc. Page 1
DL_TEST_REQ(7dlpi) DL_TEST_REQ(7dlpi)
Response
On an invalid TEST command request, a DL_ERROR_ACK is issued
to the user. If the DLS Provider receives a response from the
remote side, a DL_TEST_CON is issued to the DLS User. It is
recommended that the DLS User use a timeout procedure to
recover from a situation when there is no response from the
peer DLS User.
Reasons for Failure
DL_OUTSTATE The primitive was issued from an invalid state
DL_BADADDR The DLSAP address information was invalid or was
in an incorrect format.
DL_SYSERR A System error has occurred and the UNIX System
error is indicated in the DL_ERROR_ACK.
DL_NOTSUPPORTED
Primitive is known but not supported by the DLS
Provider
DL_TESTAUTO Previous bind request specified automatic handling
of TEST responses.
DL_UNSUPPORTED
Requested service not supplied by provider.
Category
TEST.
Copyright 1994 Novell, Inc. Page 2