NAME

T_OPTMGMT_ACK - Option Management Acknowledgment

SYNOPSIS

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

struct T_optmgmt_ack {
    t_scalar_t   PRIM_type;      /* Always T_OPTMGMT_ACK */
    t_scalar_t   OPT_length;
    t_scalar_t   OPT_offset;
    t_scalar_t   MGMT_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.

• If the value of MGMT_flags in the T_OPTMGMT_REQ primitive is T_CURRENT, the provider should return the currently effective option values without changing any existing options associated with the stream.

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.