NAME

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 {
    t_scalar_t   PRIM_type;      /* Always T_DISCON_REQ */
    t_scalar_t   SEQ_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 be 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 reference TPI-SMD.

Non-fatal errors

These errors will be indicated via the T_ERROR_ACK primitive described in reference TPI-SMD.

ERRORS

The allowable errors are as follows:

[TBADDATA]

The amount of user data specified was invalid.

[TBADSEQ]

The sequence number specified in the primitive was incorrect or invalid.

[TNOTSUPPORT]

This primitive is not supported by the transport provider.

[TOUTSTATE]

The primitive would place the transport interface out of state.

[TSYSERR]

A system error has occurred and the UNIX system error is indicated in the primitive.

MODES

Only connection-mode.

ORIGINATOR

Transport user.