TxT1E1SuperviseCarrier

Registers the application to receive unsolicited notifications of carrier alarm conditions, carrier synchronization state changes, and automatic 15 minute and 24 hour performance statistics.

Prototype

S16 TxT1E1SuperviseCarrier ( S16 handle, U8 carrier, U8 notifMask)

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

notifMask

Specifies the events that are notified. Refer to Details for a list of acceptable values.


Return values

Return value

Description

T1E1_SUCCESS

 

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

The following table lists the acceptable values for the notifMask parameter. Use OR with these values to request multiple events.

Value

Registers application to receive...

T1E1_REG_STATUS

Status changes.

T1E1_REG_ALARMS

Alarm notifications.

T1E1_REG_15MIN_REPORT

15 minute report.

T1E1_REG_24HR_REPORT

24 hour report.


Refer to Handling unsolicited T1/E1 notifications for more information.