TxT1E1PerfReport

Generates an on-demand performance report.

Prototype

S16 TxT1E1PerfReport ( S16 handle, U8 carrier, U8 flags, U16 pCurrInterval, TxT1E1Stats pCurrStats, U16 pValidInterval, TxT1E1Stats *pIntervalStats, TxT1E1Stats *pSummaryStats, U16 pPvcs, U16 pLvcs, U16 pSlips, U16 pEbits)

Argument

Description

handle

Handle returned from a previous call to TxT1E1Open for the desired board.

carrier

Network interface (carrier trunk number). Valid values:

NET_T1A through NET_T1D for PCI and PCI Express TX boards

NET_T1A through NET_T1H for CompactPCI TX boards

flags

Status request options flags. The only option is T1E1_RESET_COUNTS, which resets statistics accumulators after returning values.

pCurrInterval

Number of seconds in the current statistics interval returned to the caller.

pCurrStats

Current 15 minute interval performance statistics returned to the caller.

pValidInterval

Number of 15 minute intervals collected in summary statistics (always 96 except during first 24 hours after a boot, when it can be less than 96).

pIntervalStats

Pointer to the caller memory where interval statistics are returned.

pSummaryStats

Pointer to the caller memory where 24 hour summary statistics are returned.

pPcvs

Current value of the path code violations counter (accumulated since last reset) returned to the caller.

pLcvs

Current value of the line code violations counter (accumulated since last reset) returned to the caller.

pSlips

Current value of the controlled slips counter (accumulated since last reset) returned to the caller.

pEbits

Current value of the E-bit (E1) counter (accumulated since last reset) returned to the caller.


Return values

Return value

Description

T1E1_DEVICE_ERROR

Invalid adapter.

T1E1_INVALID_CARRIER

Invalid network interface.

T1E1_INVALID_HANDLE

Invalid handle.

T1E1_NO_RESOURCES

T1/E1 adapter is not present on the communications processor.


Details

TxT1E1PerfReport generates a report that includes performance statistics for the current 15 minute interval, the last 24 hours worth of 15 minute intervals, and the 24 hour summary. Refer to T1/E1 statistics and performance measures for more information.