[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1


DL_RESET_REQ Primitive

Purpose

Requests that the data link service (DLS) provider begin resynchronizing a data link connection.

Structure

The primitive consists of one M_PROTO message block, which contains the following structure:
typedef struct
{
   ulong dl_primitive;
} dl_reset_req_t;

Description

The DL_RESET_REQ primitive requests that the DLS provider begin resynchronizing a data link connection.

Notes:
  1. No guarantee exists that data in transit when the DL_RESET_REQ primitive is initiated will be delivered.
  2. This primitive applies to connection mode.

Parameters


dl_primitive Specifies the DL_RESET_REQ primitive.

States


Valid The primitive is valid in state DL_DATAXFER.
New The resulting state is DL_USER_RESET_PENDING.

Acknowledgments


Successful There is no immediate response to the reset request. However, as resynchronization completes, the DL_RESET_CON primitive is sent to the initiating DLS user, resulting in the DL_DATAXFER state.
Unsuccessful The DL_ERROR_ACK primitive is returned and the resulting state is unchanged.

Error Codes


DL_OUTSTATE Indicates the primitive was issued from an invalid state.
DL_SYSERR Indicates a system error occurred. The system error is indicated in the DL_ERROR_ACK primitive.

Implementation Specifics

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

Related Information

The DL_RESET_CON primitive, DL_ERROR_ACK primitive.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]