# 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)