dynaport Dynamic Avaya IVR port allocation program

dynaport DCM Software Operation Manual

Contents

Contacts..............................................................................................3 Description.........................................................................................4 Call flow.............................................................................................5 Administration ...................................................................................6 Install application.......................................................6 Edit initial program values.........................................6 Manage application codes..........................................7 Source files.........................................................................................8 Oracle table ........................................................................................9

Last updated August 30, 2008

dynaport DCM Software Operation Manual

Contacts

DCM Software 300 North State Street #2902 Chicago, IL 60654

Name Title Telephone Email Steven Dahlman IVR Developer 312-644-6260 steved@dcmsoft.com

dynaport DCM Software Operation Manual

Description

dynaport is a custom application for Avaya IVR systems that collects digits passed from a Definity PBX and starts a script on the voice channel, based on the collected digits. Digits are passed using the converse-on vector command, which can pass up to two strings of variable-length, #-terminated digits. The IVR application will accept up to 64 digits per string. Each string must be terminated with the # key. If a string is not being passed, send just the # terminator. The first string is a 1-5 digit application code (e.g., a number based on DNIS) associated with an application that should be started. The second string (optional) is a value that should be passed to the application as the last argument, following any pre-defined values specified in the database record for the application code. If no digits are passed that can be associated with a script, the caller is transferred to a pre-determined telephone number or extension.

dynaport DCM Software Operation Manual

dynaport Dynamic Avaya IVR Port Allocation Program

4321#6123312423#

DEFINITY PASSES TWO #-TERMINATED DIGIT STRINGS TO AVAYA IVR SYSTEM IVR

DCM Software
PBX 10-19-07

COLLECT FIRST STRING

Application code (1-5 digits)

Converse data return Exit if number not defined

TRANSFER TO DEFAULT NUMBER

No

ANY DIGITS?

Yes COLLECT SECOND STRING Optional (1-64 digits)

APP CODE

RETRIEVE APPLICATION
APP NAME

LOCAL ORACLE TABLE

No

FOUND?

Sample record: 4321, AppTest, Y (Start application "AppTest", pass "Y" as first argument)

EXECUTE APPLICATION PASS ARG1 FROM TABLE RECORD AS FIRST ARGUMENT PASS SECOND STRING COLLECTED FROM PBX AS SECOND ARGUMENT

Yes EXECUTE APPLICATION Yes ARG1 SPECIFIED? No PASS SECOND STRING COLLECTED FROM PBX AS FIRST ARGUMENT

DISCONNECT DISCONNECT

dynaport DCM Software Operation Manual

Administration

Install application To re-install the application, restore from backup the directory /home/dcm/dynaport. Login to the Avaya IVR system as root or super-user and enter the following commands:
cd /home/dcm/dynaport/bin sh dpinst

Edit initial program values The following values are located in the text file dynaport.ini, located in /home/dcm/dynaport/data. Feature Access Code (Converse data return) Default transfer number (4-10 digits) Touchtone collection timeouts (initial and interdigit, in seconds, first and second strings) Database access (optional)

FAC=113 DEFAULT_NUM=4500 TT_TIMEOUT1=4 TT_TIMEOUT2=2 DBDIP=D

Example

The first timeout value is the maximum number of seconds to wait for the first digit string from the PBX. The second timeout value is the time to wait for the second string. The default values are four seconds and two seconds, respectively. By default, the program uses the standard database DIP to read from a local database. If this value is changed to U the program will instead call the Exec_UNIX.t external function. Use vi to edit the values. Then run the dpinst shell script located in /home/dcm/dynaport/bin.

dynaport DCM Software Operation Manual

Manage application codes Edit dynaport.dat, located in /home/dcm/dynaport/data, a text file comprised of three columns: Application code (max. 5 digits) Application name (max. 11 characters) Execute Argument 1 (max. 16 characters or null)

Example: 4619,DIS_Survey,1 In the above example, if application code 4619 is passed from the PBX, the application DIS_Survey will be started and passed the value of 1 as the first argument. Use vi to edit the file, adding, changing, or deleting records as needed. Then run the following commands:
cd .. bin/upddp

dynaport DCM Software Operation Manual

Source files

/home/dcm/dynaport/trans
collect.t External function to collect digits dynaport.h TSM script header file dynaport.t TSM script

/home/dcm/dynaport/bin
dpinst getapp rst_table upddp Install dynaport application Return application name from DYNAPORT table Recreate local Oracle table DYNAPORT Repopulate local Oracle table DYNAPORT

/home/dcm/dynaport/data
dynaport.dat Dynaport data file (application codes, names, and arguments) dynaport.ini Configuration settings

dynaport DCM Software Operation Manual

Oracle table

Table name:

DYNAPORT

dcAppCode CHAR (5) dcAppName CHAR (11) dcAppArg1 CHAR (32)