DL_UDQOS_REQ(7dlpi) DL_UDQOS_REQ(7dlpi)
NAME
DL_UDQOS_REQ - Message Type
SYNOPSIS
The message consists of one M_PROTO message block containing
the structure shown below.
typedef struct {
ulong dl_primitive;
ulong dl_qos_length;
ulong dl_qos_offset;
} dl_udqos_req_t;
DESCRIPTION
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.
Parameters
dl_primitive
Conveys DL_UDQOS_REQ.
dl_qos_length
Conveys the length, in bytes, of the requested
quality of service parameter values. 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 want to
select, the value DL_QOS_DONT_CARE may be set and the DLS
provider will maintain the current value for that parameter.
dl_qos_offset
conveys the offset from the beginning of the
M_PROTO message block where the quality of service
parameters begin.
State
The message is valid in state DL_IDLE.
New State
The resulting state is DL_UDQOS_PENDING.
Copyright 1994 Novell, Inc. Page 1
DL_UDQOS_REQ(7dlpi) DL_UDQOS_REQ(7dlpi)
Response
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.
Reasons for Failure
DL_BADQOSPARAM
The quality of service parameters contained values
outside the range of those supported by the DLS
provider.
DL_BADQOSTYPE
The quality of service structure type was not
supported by the DLS provider.
DL_OUTSTATE The primitive was issued from an invalid state.
Mode
Connectionless-mode.
REFERENCES
the section ``QOS Data Structures'' of the book STREAMS
Modules and Drivers
the section ``Quality of Data Link Service'' of the book
STREAMS Modules and Drivers has a full description of the
quality of service parameters
Copyright 1994 Novell, Inc. Page 2