DL_ERROR_ACK Primitive for X.25

AIXLink/X.25 1.1 for AIX: Guide and Reference

DL_ERROR_ACK Primitive for X.25

Purpose

Informs the data link service (DLS) user that a request or response was invalid.

Structure

This primitive consists of one M_PROTO message block with the following structure:

typedef struct {
   ulong dl_primitive;
   ulong dl_error_primitive;
   ulong dl_errno;
   ulong dl_unix_errno;
} dl_ok_ack_t;

Description

The DL_ERROR_ACK primitive informs the DLS user that the previously issued request or response was invalid. The 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_prim

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, it can have the following values:

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_SYSERR	Reports operating system failures that prevent the processing of a given request or response.

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.

States

Valid	The message 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 X.25 Licensed Program.

[ Previous | Next | Contents | Search ]