Queries the current status of a T1 or E1 carrier.
S16 TxT1E1CarrierStatus ( S16 handle, U8 carrier, U8 flags, U8 *pAlarmState, U8 *pLastAlmState, U8 *pSyncState, TxT1E1Config *pConfig, U16 pCurrInterval, TxT1E1Stats pCurrStats, U16 pValidInterval, 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 available option is T1E1_RESET_COUNTS, which resets statistics accumulators after returning values. |
pAlarmState |
Pointer to where the current alarm state is returned to the caller. |
pLastAlmState |
Pointer to where the previous alarm state is returned to the caller. |
pSyncState |
Pointer to where the current synchronization state is returned to the caller. |
pConfig |
Pointer to the configuration block for this carrier. |
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 the summary statistics (always 96, except during first 24 hours after a boot, when it can be less than 96). |
pSummaryStats |
Pointer to the caller memory where the 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 value |
Description |
T1E1_DEVICE_ERROR |
Invalid adapter found. |
T1E1_INVALID_CARRIER |
Invalid network interface. |
T1E1_INVALID_HANDLE |
Invalid handle. |
T1E1_NO_RESOURCES |
T1/E1 adapter is not present on the communications processor. |
TxT1E1CarrierStatus displays the configuration, state, and statistics for the specified T1/E1 carrier. Refer to T1/E1 statistics and performance measures for more information.