Sends a request to retrieve the statistics for a given network service access point and blocks the calling application while waiting for a response.
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. |
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 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. |
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>
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 */
}