SccpGetNSapStats

Retrieves and optionally resets the SCCP network service access point (NSAP) statistics for a specified network service access point of the SCCP task.

Prototype

SCCP_STATUS SccpGetNSapStats ( U8 board, SccpNSapStats *pStats, U16 sapId, U8 bReset)

Argument

Description

board

TX board number.

pStats

Pointer to the address of the caller's SCCP network service access point statistics buffer where statistics are returned:

typedef struct
{
  U8       month;    /* month                               */
  U8       day;      /* day                                 */
  U8       year;     /* year - since 1900                   */
  U8       hour;     /* hour - 24 hour clock                */
  U8       min;      /* minute                              */
  U8       sec;      /* second                              */
  U8       tenths;   /* tenths of second                    */
  U8       fill;     /* alignment                           */
} DateTime;

typedef struct 
{
  DateTime dt;         /* Date and Time                       */
  Duration dura;       /* Duration (not used)                 */
  S32      ssAllTx;    /* SS allowed transmitted              */
  S32      ssOutGTx;   /* SS out of service grant transmitted */
  S32      ssOutRTx;   /* SS out of service request 
                        * transmitted                         */
  S32      ssProhTx;   /* SS prohibited transmitted           */
  S32      ssStatTx;   /* SS status test transmitted          */
  S32      ssAllRx;    /* SS allowed received                 */
  S32      ssOutGRx;   /* SS out of service grant received    */
  S32      ssOutRRx;   /* SS out of service request received  */
  S32      ssProhRx;   /* SS prohibited received              */
  S32      ssStatRx;   /* SS status test received             */
  S32      connActive; /* number of currently active
                        * connections                         */
} SccpNSapStats;

Counts of type S32 are the number of event occurrences since the statistics were last cleared.

sapId

Network service access point ID.

bReset

If non-zero, statistics are reset to zero after retrieval.


Return values

Return value

Description

SCCP_SUCCESS

 

SCCP_BOARD

board is out of range.

SCCP_DRIVER

Error occurred accessing the driver.

SCCP_EXCEEDMAXCFG

Network service access point ID is out of the configured range.

SCCP_NOGENCFG

SccpSetGenCfg has not been called.

SCCP_NULLPTR

Null pointer was specified for pStats.

SCCP_RESOURCES

TX board resource is exhausted. Check the txalarm log.

SCCP_TIMEOUT

Request timed out.

SCCP_UNINIT

Application failed to call SccpMgmtInit prior to this call.