TxT1E1CarrierStatus

Queries the current status of a T1 or E1 carrier.

Prototype

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 values

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.


Details

TxT1E1CarrierStatus displays the configuration, state, and statistics for the specified T1/E1 carrier. Refer to T1/E1 statistics and performance measures for more information.