# Outbound call control: outcta

Demonstrates:

- Placing an outbound call. Refer to the Natural Call Control Developer's Reference Manual for more information about placing an outbound call.

- Simple glare detection.

- Synchronous programming model for one port in one process.

- Play and record using the Voice Message service. Refer to the Voice Message Service Developer's Reference Manual for more information.

#### Usage

outcta [options]

where options are:

Option | Use this option to...
--- | ---
-A xxxmgr | Specify the Natural Access service manager. Default: ADIMGR
-b n | Specify the board number n. Default: 0
-d digits | Specify the number to dial. Default: 123
-F filename | Specify the name of the Natural Access configuration file. Default: cta.cfg
-l | Print low-level call control events.
-s [stream:]slot | Specify the port (DSP) address. Default: 0:0.
-p protocol | Specify the protocol to run. Default: lps0
-r tries | Specify the maximum number of dial attempts or retries on failure.

#### Featured functions

adiCollectDigits, vceCreateFile, vceOpenFile, vcePlayList, vceRecordMessage

#### Description

The demonstration program seizes the line and places a call. For the wink-start protocol, the program must receive a wink (momentary off-hook) before it dials the digits.

When the demonstration detects an answer (off-hook indication), it plays a greeting message, then prompts the called party to perform one of the following actions:

- Record a message

- Play back the message

- Hang up

#### Procedure

The following procedure assumes you are testing on an AG 2000 board that has a 2500-type telephone connected to one of the lines.

Complete the following steps to run outcta:

Step | Action
1 | Change to the directory containing the outcta program and voice files.
2 | Start outcta by entering the following command at the prompt: outcta -b n -s [stream:]slot -p wnk0 [-d digits -r tries -l] Use the -l option if you want to see all call control events. outcta displays the message: "Placing a call to 'xxx' ..."
3 | Lift the handset and replace it to simulate a wink from the network. NCCEVN_PLACING_CALL displays as the NCC service dials the digits. If you specified the -l command line option, NCCEVN_CALL_PROCEEDING displays when dialing is complete.
4 | Lift the handset to simulate network answer. You hear the greeting message and the menu message.
5 | Dial 1 to record a message.
6 | Begin speaking after the beep. Recording ceases shortly after you stop speaking. You hear the menu message again.
7 | Dial 2 to play back what you recorded.
8 | Dial 3 to quit. The demonstration hangs up the line and outcta exits.

Note: outcta demonstrates synchronous programming of a single port. A start command is initiated and the demonstration continuously retrieves events from the board until the expected event returns, simplifying the overall program flow.