[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1
DL_ERROR_ACK Primitive
Purpose
Informs the data link service (DLS) user that a request or response was invalid.
Structure
The message consists of one M_PCPROTO message block, which contains the following structure:
typedef struct
{
ulong dl_primitive;
ulong dl_error_primitive;
ulong dl_errno;
ulong dl_unix_errno;
} dl_ok_ack_t;
This structure is defined in /usr/include/sys/dlpi.h.
Description
The DL_ERROR_ACK primitive informs the DLS user that the previously issued request or response was invalid. This primitive identifies the primitive in error, specifies a Data Link Provider Interface (DLPI) error code, and if appropriate, indicates an operating system error code.
Parameters
dl_primitive |
Specifies the DL_ERROR_ACK primitive. |
dl_error_primitive |
Identifies the primitive that caused the error. |
dl_errno |
Specifies the DLPI error code associated with the failure. See the individual request or response for the error codes that are applicable. In addition to those errors:
DL_BADPRIM |
Indicates an unrecognized primitive was issued by the DLS user. |
DL_NOTSUPPORTED |
Indicates an unsupported primitive was issued by the DLS user. |
|
dl_unix_errno |
Specifies the operating system error code associated with the failure. This value should be nonzero only when the dl_errno parameter is set to DL_SYSERR. It is used to report operating system failures that prevent the processing of a given request or response. |
States
Valid |
The primitive is valid in all states that have a pending acknowledgment or confirmation. |
New |
The resulting state is the same as the one from which the acknowledged request or response was generated. |
Implementation Specifics
This primitive is part of Base Operating System (BOS) Runtime.
Related Information
The DL_OK_ACK primitive.
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]