User`s guide

AUDIX Administration and Data Acquisition Package 585-302-502 Issue 17
May 2002
Using the ADAP Command Line Language
11-17Command Line Commands
11
NOTE:
When constructing input records for ADAP commands, all fields, regardless
of type, must be enclosed in double quotation marks and separated by
commas. The records must be terminated with a NEWLINE. These rules
hold true whether the input is redirected from a file or entered interactively
from the keyboard though the use of the -i option.
Optional Input Fields
A field name enclosed in square brackets, that is [....], indicates an optional input
field. You do not have to provide a value for this input field when using that
particular ADAP command. If you wish not to provide a value for this input field but
want to give a value for a field later in the input field sequence, you must insert a
placeholder set of double quotes ("") denotes a null string) and a field separator (a
comma) into the input record in the place of this input field.
The null string and comma serve as a placeholder so you can tell ADAP you want
to skip the field and go to a field later in the input sequence. The ADAP command
may then determine the purpose of the value later in the input record. If you wish
to provide a value for the nth input field, you must have provided values or
placeholders for all previous (n-1) fields in the input record. If you wish to omit all
optional fields, you need only provide the required fields; placeholders are not
necessary.
When you omit optional fields, ADAP does not place a value into the
corresponding field on the voice mail form. It allows the voice mail machine to
provide a default value in the case of adding local or remote subscribers. When
changing existing subscribers, omitting optional fields causes the corresponding
information on the voice mail machine to be skipped, leaving intact any value that
may already be there.
Input of Name or Extension
(DEFINITY/I
NTUITY AUDIX)
S
ome input records format tables indicate that a name and an extension should
be provided. There is some flexibility when an ADAP is communicating with a
DEFINITY AUDIX or I
NTUITY AUDIX system. When an ADAP command for a
DEFINITY AUDIX or I
NTUITY AUDIX system accepts both a name and extension
in an input record, an empty set of double quotes may be placed for either the
name or the extension. Both data items need not be provided.
If only the name is provided, the command uses the name; if only the extension is
provided in the input record, the command uses the extension. If both the name
and extension are specified in an input record, the name is ignored and the
extension is employed in the transaction. For operations which change the name
or extension, these easements apply only to the old name and old extension.
These guidelines do not apply to interactions with R1 AUDIX systems.