CTI Products NCB/EM with External PSTN Modem - Manual (Page 33)

CTI Products, Inc. NCB-EM User Guide
3. Network Variable Control 27
Value Auto Answer Mode
Off Disabled
On Enabled
Default State
On (Enabled)
T
ELEPHONE
D
IRECTORY
O
BJECT
A Directory Object is used to store and retrieve arrays of ASCII strings that are characterized as telephone
numbers (including characters used for control) used in dialing a data modem. The ASCII arrays are configured
using data file transfer or configuration network variables and are retrieved in real-time using an index value
passed via a network variable.
The output of a Directory Object (which emits telephone numbers) is typically bound to a Modem Controller
Object. . The input to a Directory Object is typically driven by an object requiring the services of the Modem
Controller Object to accomplish some connectivity task, e.g. notification of an alarm to a remote site. Usage of
a Directory Object allows the alerting object to initiate dialing of the Modem Controller Object to a specific
telephone number by simply emitting an array index from 0 to 15.
Two Directory Objects are available, for independently sending a distinct dial string to each of two Modem
Controller Objects. The Directory Objects use the same configuration data (all contain the same dial string
data).
Network Variables
Request Dial String (Input)
C Language Syntax
network input SNVT_char_ascii nviReqDialStr1;
network input SNVT_char_ascii nviReqDialStr2;
Usage
Two variables are available, one for each of the Directory Objects. These input network variables
request the output of a telephone number, from the requested index.
Valid Range
0-15
Dial String (Output)
C Language Syntax
network output SNVT_str_asc nvoDialStr1;
network output SNVT_str_asc nvoDialStr2;
Usage
Two variables are available, one for each of the Directory Objects. These output network
variables provide the phone number string from the Directory entry corresponding to the index
number received on nviReqDialStrx.
Valid Range
A NULL terminated ASCII string up to 31 bytes in length (including the NULL).
All ASCII characters are valid, with specific support for the following:
Letter P (upper or lower case, first character in string only) – Pulse Dial.
Digits (0-9,*,#) – Dials digit directly.
Comma (,) – Pauses 2 seconds for each comma encountered.
Letter W (upper or lower case) – Pauses until a dial tone is detected.
Exclamation Point (!) – Hookflash, go onhook for 0.5 seconds, then back offhook.