Previous section.

Data Link Provider Interface (DLPI), Version 2
Copyright © 2000 The Open Group


DL_UDQOS_REQ (dl_udqos_req_t) - requests the DLS provider to apply the specified quality of service parameter values to subsequent data unit transmissions. These new values will remain in effect until another DL_UDQOS_REQ is issued.


The message consists of one M_PROTO message block containing the structure shown below.

typedef struct {
    t_uscalar_t  dl_primitive;
    t_uscalar_t  dl_qos_length;
    t_uscalar_t  dl_qos_offset;
} dl_udqos_req_t;



conveys DL_UDQOS_REQ.


conveys the length, in bytes, of the requested quality of service parameter values. The values are conveyed in the appropriate structure defined in QOS Data Structures. The available range of QOS values that may be selected is specified by the dl_qos_range_length and dl_qos_range_offset parameters in the DL_INFO_ACK primitive. For any parameter whose value the DLS user does not wish to select, the value DL_QOS_DONT_CARE may be set and the DLS provider will maintain the current value for that parameter. See Quality of Data Link Service. for a full description of the quality of service parameters.


conveys the offset from the beginning of the M_PROTO message block where the quality of service parameters begin.


The message is valid in state DL_IDLE.


The resulting state is DL_UDQOS_PENDING.


If the quality of service request is successful, DL_OK_ACK is sent to the DLS user and the resulting state is DL_IDLE. If the request fails, message DL_ERROR_ACK is returned and the resulting state is unchanged.



The quality of service parameters contained values outside the range of those supported by the DLS provider.


The quality of service structure type was not supported by the DLS provider.


The primitive was issued from an invalid state.

Contents Next section Index