dtmSendAlarm

Starts or stops sending an alarm on a digital trunk.

Note: dtmSendAlarm cannot be used with BRI trunks.

Prototype

DWORD dtmSendAlarm ( DTMHD dtmhd, unsigned alarm)

Argument

Description

dtmhd

Handle to the trunk monitor object.

alarm

Alarm to send. Use DTM_SEND_NO_ALARMS to disable.

Refer to the Details section for alarm settings.


Return values

Return value

Description

SUCCESS

 

CTAERR_INVALID_HANDLE

dtmhd is not a valid monitor handle.

CTAERR_SVR_COMM

Communication error in server environment.


Details

dtmSendAlarm starts or stops sending a specified alarm on a digital trunk to the remote end of the trunk. Alarms from the board to the application running on the host are not affected by this operation.

alarm can be one of the following settings:

Alarm setting

Value

Description

DTM_SEND_NO_ALARMS

0

Auto (board generates yellow alarms when appropriate)

DTM_SEND_AIS

1

AIS (all ones signal)

DTM_SEND_LOF

2

Loss of frame (yellow)

DTM_SEND_TS16AIS

3

TS16AIS (E1 only)