(Page 5 of 9 in this chapter) Version


Mtp2LinkStatus

Description

Obtains data link status information about the specified link number.

Prototype

MTP2_STATUS Mtp2LinkStatus (U8 board,
S16 linkNo,
MTP2LinkStatus *pStatus)

board The TX board number on which the desired MTP 2 task resides. This value must be from 1 to MAXBOARD (currently 8).

linkNo The link number to obtain status information about. The link number must have been previously defined via the Mtp2SetLinkCfg function.

pStatus A pointer to a buffer provided by the application where the requested status information will be returned. Refer to the MTP2LinkStatus structure below.

Return Values

Details

This function obtains link status information about the specified link number. This information includes the link state, flow control state, queue sizes, and busy states. Refer to the MTP2LinkStatus structure below for detailed information.

This structure is filled by the MTP 2 task in response to an Mtp2LinkStatus request.

typedef struct _Mtp2LinkStatus /* MTP Level 2 - signaling link status */
{
  DateTime  DT;                /* Date / time stamp                   */
  U8        hlSt;              /* sap state                           */
  U8        psOutsFrm;         /* outstanding frames to MAC           */
  S16       cntMaDrop;         /* frames dropped by MAC               */
  U8        llSt;              /* link level matrix state             */
} MTP2LinkStatus;
Field Name

Possible values

Description

hlSt

ST_UNBOUND, ST_CONFIGURED, ST_BND_DISABLED, or ST_BND_ENABLED

Sap State

psOutsFrm

0 - 0xFF

Outstanding frames to MAC

cntMaDrop

0 - 0xFFFF

Frames dropped by MAC

llSt

ST_UNUSED, ST_OUT_OF_SERVICE, ST_INITIAL_ALIGNMENT, ST_ALIGNED_READY, ST_ALIGNED_NOT_READY, ST_PROC_OUT, ST_IN_SERVICE, ST_IDLE, ST_NOT_ALIGNED, ST_IS_ALIGNED, ST_PROVING, ST_LOCAL_PROC_OUT, ST_REMOTE_PROC_OUT, ST_BOTH_PROC_OUT, ST_MONITORING, ST_CONGESTION, or ST_POWER_OFF

Link level matrix state



(Page 5 of 9 in this chapter) Version


tech_support@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.