DL_RESET_IND Primitive

Communications Technical Reference, Volume 1

DL_RESET_IND Primitive

Purpose

Indicates a data link service (DLS) connection has been reset.

Structure

The primitive consists of one M_PROTO message block, which contains the following structure:

typedef struct 
{
   ulong dl_primitive;
   ulong dl_originator;
   ulong dl_reason;
} dl_disconnect_ind_t;

Description

The DL_RESET_IND primitive informs the DLS user that either the remote DLS user is resynchronizing the data link connection, or the DLS provider is reporting loss of data from which it can not recover. The primitive indicates the reason for the reset.

Note: This primitive applies to connection mode.

Parameters

dl_primitive

Specifies the DL_RESET_IND primitive.

dl_originator

Specifies whether the reset was originated by the DLS user or DLS provider. The values are DL_USER or DL_PROVIDER, respectively.

dl_reason

Indicates one of the following reasons for the reset:

DL_RESET_FLOW_CONTROL	Indicates flow control congestion.
DL_RESET_LINK_ERROR	Indicates the occurrence of a data link error.
DL_RESET_RESYNCH	Indicates a request for resynchronization of a data link connection.

States

Valid	The primitive is valid in the DL_DATAXFER state.
New	The resulting state is DL_PROV_RESET_PENDING.

Acknowledgments

The DLS user should issue a DL_RESET_RES primitive to continue the resynchronization procedure.

Implementation Specifics

This primitive is part of Base Operating System (BOS) Runtime.

Related Information

The DL_RESET_RES primitive.