CTI Products NCB/AY with Serial Interface - Manual (Page 31)

CTI Products, Inc. NCB-AY User Guide
3. Network Variable Control 25
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. They are named ‘Directory 1’, ‘Directory 2’, etc. both Directory Objects use the same
configuration data (both 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 Object. 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 Object. 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.