isupNSapStats

Sends a request to retrieve the statistics for a given network service access point and blocks the calling application while waiting for a response.

Prototype

short isupNSapStats ( U8 board, S16 sapID, IsupNSapStats *stats);

Argument

Description

board

TX board number.

sapId

ISUP service access point.

stats

Pointer to the IsupNSapStats structure where the requested statistics information is returned.

For more information, refer to IsupNSapStats structure and to the Details that follow.


IsupNSapStats structure

typedef struct _IsupNSapStats
{
  DateTime dt;              /* Date and time                          */
  Duration dura;            /* Duration                               */
  S32  adrCmpltTx;          /* Address complete transmitted           */
  S32  answerTx;            /* Answer transmitted                     */
  S32  progressTx;          /* Progress transmitted                   */
  S32  contiTx;             /* Continuity transmitted                 */
  S32  conChkReqTx;         /* Continuity Check Request transmitted   */
  S32  loopBckAckTx;        /* Lookback Acknowledge transmitted       */
  S32  confusTx;            /* Confusion transmitted                  */
  S32  callModReqTx;        /* Call Modification Request transmitted  */
  S32  callModRejTx;        /* Call Modification Reject transmitted   */
  S32  callModComTx;        /* Call Modification Complete transmitted */
  S32  suspTx;              /* Suspend transmitted                    */
  S32  resmTx;              /* Resume transmitted                     */
  S32  forwTx;              /* Forward transmitted                    */
  S32  conTx;               /* Connect transmitted                    */
  S32  relTx;               /* Release transmitted                    */
  S32  overldTx;            /* Overload transmitted                   */
  S32  relCmpltTx;          /* Release Complete transmitted           */
  S32  facTx;               /* Facility Request transmitted           */
  S32  facAckTx;            /* Facility Ack transmitted               */
  S32  facRejTx;            /* Facility Reject transmitted            */
  S32  initAdrTx;           /* Initial Address transmitted            */
  S32  infoTx;              /* Info transmitted                       */
  S32  infoReqTx;           /* Info Request transmitted               */
  S32  passAlongTx;         /* Pass Along transmitted                 */
  S32  subsAdrTx;           /* Subsequent Address transmitted         */
  S32  usrToUsrTx;          /* User to User transmitted               */
  S32  uneqCirIdTx;         /* Unequipped Circuit ID transmitted      */
  S32  cirReserveTx;        /* Circuit reservation  transmitted       */
  S32  cirResAckTx;         /* Circuit reservation ack transmitted    */
  S32  exitTx;              /* Exit transmitted                       */
  S32  netResMgmtTx;        /* Network Resourse transmitted           */
  S32  netIdReqTx;          /* Network Id Request transmitted         */
  S32  netIdRspTx;          /* Network Id Request transmitted         */
  S32  chargeTx;            /* Charge transmitted                     */
  S32  loopPrevTx;          /* Loop Prevention transmitted            */
  S32  preRelTx;            /* Pre-Release transmitted                */
  S32  appTransTx;          /* Application Transport transmitted      */
  S32  adrCmpltRx;          /* Address complete received              */
  S32  answerRx;            /* Answer received                        */
  S32  progressRx;          /* Progress received                      */
  S32  contiRx;             /* Continuity received                    */
  S32  conChkReqRx;         /* Continuity Check Request received      */
  S32  loopBckAckRx;        /* Lookback Acknowledge received          */
  S32  confusRx;            /* Confusion received                     */
  S32  callModReqRx;        /* Call Modification Request received     */
  S32  callModRejRx;        /* Call Modification Reject received      */
  S32  callModComRx;        /* Call Modification Complete received    */
  S32  suspRx;              /* Suspend received                       */
  S32  resmRx;              /* Resume received                        */
  S32  forwRx;              /* Forward received                       */
  S32  conRx;               /* Connect received                       */
  S32  overldRx;            /* Overload received                      */
  S32  relRx;               /* Release received                       */
  S32  relCmpltRx;          /* Release Complete received              */
  S32  facRx;               /* Facility Request received              */
  S32  facAckRx;            /* Facility Ack received                  */
  S32  facRejRx;            /* Facility Reject received               */
  S32  initAdrRx;           /* Initial Address received               */
  S32  infoReqRx;           /* Info Request received                  */
  S32  infoRx;              /* Info received                          */
  S32  passAlongRx;         /* Pass Along received                    */
  S32  subsAdrRx;           /* Subsequent Address received            */
  S32  usrToUsrRx;          /* User to User received                  */
  S32  uneqCirIdRx;         /* Unequipped Circuit ID received         */
  S32  cirReserveRx;        /* Circuit reservation  received          */
  S32  cirResAckRx;         /* Circuit reservation ack received       */
  S32  exitRx;              /* Exit received                          */
  S32  netResMgmtRx;        /* Network Resource received              */
  S32  netIdReqRx;          /* Network Id Request received            */
  S32  netIdRspRx;          /* Network Id Request received            */
  S32  chargeRx;            /* Charge message received                */
  S32  segRx;               /* Segmentation received                  */
  S32  loopPrevRx;          /* Loop Prevention received               */
  S32  preRelRx;            /* Pre-Release received                   */
  S32  appTransRx;          /* Application Transport received         */
} IsupNSapStats;

Return values

Return value

Description

ISUP_SUCCESS

 

ISUP_BOARD

board is out of range.

ISUP_DRIVER

Error occurred accessing the driver.

ISUP_FAILED

Task on the TX board returned a failure.

ISUP_UNBOUND

Application failed to call isupInitMgmtAPI prior to this call.


Details

isupNSapStats automatically resets the statistics counters. Use isupNSapStatsEx instead of isupNSapStats to control the resetting of the statistics counters. For more information, see isupNSapStatsEx.

<NMSBREAK>

Example

S16           status;
U8            boardNum=1;
S16           sapId=1;
IsupNsapStats sts;


if ((status = isupNsapStats(boardNum, sapID, &sts)) != ISUP_MGMT_SUCCESS)
{
    printf( "Board %d Service Access Point %d Get Statistics Request failed:
        status = %d\n", boardNum, sapID, status );
}
else
{
    printf("Successfully obtained NSAP statistics information for SAP %d on board %d\n",
        sapID, boardNum);

/* The structure ‘sts’ contains the returned NSAP statistics information */

}