T_OPTMGMT_ACK(D7tpi)

T_OPTMGMT_ACK -- Option Management Acknowledgment

Synopsis

This message consists of a M_PCPROTO message block formatted as follows:

   struct T_optmgmt_ack {
   	long PRIM_type;    /* always T_OPTMGMT_ACK */
   	long OPT_length;   /* options length -   */
   	long OPT_offset;   /* options offset */
   	long MGMT_flags;   /* flags */
   }

Description

This indicates to the transport user that the options management request has completed.

Parameters

PRIM_type: indicates the primitive type.
OPT_length: is the length of the protocol options associated with the primitive
OPT_offset: is the offset from the beginning of the M_PCPROTO block where the options begin.

The proper alignment of the options is not guaranteed. MGMT_flags should be the same as those specified in the T_OPTMGMT_REQ primitive with any additional flags as specified below.

Rules

The following rules apply to the T_OPTMGMT_ACK primitive.

If the value of MGMT_flags in the T_OPTMGMT_REQ primitive is T_DEFAULT, the provider should return the default provider options without changing the existing options associated with the stream.
If the value of MGMT_flags in the T_OPTMGMT_REQ primitive is T_CHECK, the provider should return the options as specified in the T_OPTMGMT_REQ primitive along with the additional flags T_SUCCESS or T_FAILURE which indicate to the user whether the specified options are supportable by the provider. The provider should not change any existing options associated with the stream.
If the value of MGMT_flags in the T_OPTMGMT_REQ primitive is T_NEGOTIATE , the provider should set and negotiate the option as specified by the following rules:
- If the OPT_length field of the T_OPTMGMT_REQ primitive is 0, then the transport provider is to set and return the default options associated with the stream in the T_OPTMGMT_ACK primitive.
- If options are specified in the T_OPTMGMT_REQ primitive, then the transport provider should negotiate those options, set the negotiated options and return the negotiated options in the T_OPTMGMT_ACK primitive. It is the user's responsibility to check the negotiated options returned in the T_OPTMGMT_ACK primitive and take appropriate action.

Errors

If the above rules result in an error condition, the transport provider must issue a T_ERROR_ACK primitive to the transport user specifying the error as defined in the description of the T_OPTMGMT_REQ primitive.

Modes

Both connection-mode and connectionless-mode.

Originator

Transport provider.

Notices

Hardware constraints

None

Applicability

N/A

Backward compatibility

UnixWare-specific TPI Message Formats

Forward compatibility

N/A