Outbound call control: outcta

Demonstrates:

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:

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.