(Page 4 of 9 in this chapter) Version


Mtp2LinkStats

Description

Obtains (and potentially resets) data link statistical information about the specified link number.

Prototype

MTP2_STATUS Mtp2LinkStats (U8 board,
S16 linkNo,
MTP2LinkStats *pStats,
BOOL bReset)

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 statistical information about. The link number must have been previously defined via the Mtp2SetLinkCfg function.

pStats A pointer to a buffer provided by the application where the requested statistical information will be returned. Refer to the MTP2LinkStats structure below.

bReset If true (non-zero), the statistics are reset (set to zero) after returning the current values. If false (zero) no reset is performed.

Return Values

Details

There are a large number of link statistics. They include counts for the various message types and their acknowledgments both transmitted and received. All counts are U32 fields. Refer to the MTP2LinkStats structure below.

typedef struct _Mtp2LinkStats /* MTP Level 2 link statistics  */
{
  U32  inService;       /* start of in-service                */
  U32  lclBusy;         /* duration of local-busy             */
  U32  slFailAll;       /* all reasons for a signaling link
                         * failure                            */
  U32  slFailAb;        /* Abnormal FIBR/BSNR link failure    */
  U32  slFailAck;       /* delay of acknowledgment link 
                         * failure                            */
  U32  slFailErr;       /* excessive error rate link failure  */
  U32  slFailCong;      /* excessive congestion link failure  */
  U32  slFailAlign;     /* alignment link failure             */
  U32  slNSUErr;        /* number of signal units in error    */
  U32  slNegAck;        /* number of negative acknowledgments */
  U32  nSifSioTx;       /* number of SIF/SIO packets 
                         * transmitted                        */
  U32  nRetrans;        /* number of octets transmitted       */
  U32  mTx;             /* information frames transmitted     */
  U32  lTx;             /* receive ready frames transmitted   */
  U32  fTx;             /* receive not ready frames 
                         * transmitted                        */
  U32  nSifSioRx;       /* number of SIF/SIO packets received */
  U32  mRx;             /* information frames received        */
  U32  lRx;             /* receive ready frames received      */
  U32  fRx;             /* receive not ready frames received  */
} MTP2LinkStats;


(Page 4 of 9 in this chapter) Version


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