NAME
IrDIALSTRINGS - IRAPI dial strings
SYNOPSIS
#include <irapi.h>
DESCRIPTION
Dial strings are passed to IRAPI functions to make outbound
calls through irCall(3IRAPI) or dial digits through
irDial(3IRAPI). The call-control characters listed below
are a subset of, and consistent with, the AT&T Core Symbols
for Terminal Dialing. The type of dialing done (pulse or
touch-tone) is determined via the IRP_OUTCALL_DIALTYPE
parameter [see IrPARAMETERS(4IRAPI)].
The following characters are valid for dial strings:
[0-9], [a-d], *, #
Dual tone multi-frequency (DTMF) charac-
ters. Only 0-9 are allowed for pulse
dialing.
''[a-z]'' Double quotation marks ("") surrounding
alphabetic characters ([a-z]) cause them
to be interpreted as touch-tone digits.
The letter 'q' maps to 7 and the letter
'z' maps to 9. When in a string, the
double quotes must be escaped with
backslash.
- ) ( These characters insert a delay equal in
length to a single DTMF tone if touch-
tone dialing is used; a delay equal in
length to the inter-digit pulse wait
period is used if pulse dialing is used.
Delay causing characters are only opera-
tional with Tip/Ring (T/R) telephony
interfaces. These characters are
treated as space (see below) for other
telephony types.
, Comma inserts a one second delay (T1/E1
only).
space Any number of space or blank characters
may be used to make the dial string more
readable.
The maximum length of the dial string is dependent on the
telephony type. Currently all digital interfaces have a
maximum dial string length of 15 characters when using
irCall or irDial. Applications that wish to pass more than
15 characters of data in an irDial request, should use mul-
tiple irDial requests. While analog interfaces allow up to
30 character dial strings, it is probably wise to use at
most 15 character dial strings.
VERSION
This is version 10/29/99 of this man page.