T_DISCON_REQ(D7tpi)

T_DISCON_REQ -- Disconnect Request

Synopsis

This message consists of one M_PROTO message block followed by one or more M_DATA message blocks if there is any user data specified by the transport user. The format of the M_PROTO message block is as follows:

   struct T_discon_req {
   	long PRIM_type;	/* always T_DISCON_REQ */
   	long SEQ_number;	/* sequence number */
   }

Description

This primitive requests that the transport provider deny a request for connection, or disconnect an existing connection.

Parameters

PRIM_type: identifies the primitive type.
SEQ_number: identifies the outstanding connect indication that is to by denied. If the disconnect request is disconnecting an already existing connection, then the value of SEQ_number will be ignored.

Rules

This primitive requires the transport provider to generate the following acknowledgment on receipt of the primitive, and the transport user must wait for the acknowledgment before issuing any other primitives:

Successful: Correct acknowledgment of the primitive is indicated via the T_OK_ACK primitive described in
Non-fatal errors: These errors will be indicated via the T_ERROR_ACK primitive described in

Errors

The allowable errors are as follows:

TOUTSTATE: The primitive would place the transport interface out of state.
TBADDATA: The amount of user data specified was invalid.
TBADSEQ: The sequence number specified in the primitive was incorrect or invalid.
TSYSERR: A system error has occurred and the UNIX system error is indicated in the primitive.
TNOTSUPPORT: This primitive is not supported by the transport provider.

Modes

Only connection-mode.

Originator

Transport user.

Notices

Hardware constraints

None

Applicability

N/A

Backward compatibility

UnixWare-specific TPI Message Formats

Forward compatibility

N/A