User`s guide

AUDIX Administration and Data Acquisition Package 585-302-502 Issue 17

May 2002

Using the ADAP Command Line Language

11-20Command Line Commands

The placeholding value is a zero for numeric fields that have been deleted. For

deleted character, digit sequence or logical fields, the placeholding value is an

empty string enclosed in a set of delimiters (which by default is "").

Redirecting Output to Files

If you don’t specify an output file to receive the data, ADAP displays all retrieved

screens data on the PC screen. Most applications can use the MS-DOS redirect

capability to write the data to a file. To do this, specify an output filename

preceded by a redirect symbol such as > ofile.

For example, if you are retrieving data for the DEFINITY AUDIX or I

NTUITY List

Extensions screen and you want the data written to a file named dir.dat, enter the

following:

getdir > dir.dat

ADAP retrieves the data from the List Extensions screen for all subscribers on the

DEFINITY AUDIX or I

NTUITY system and writes it to a file named dir.dat instead of

displaying it on your PC screen.

Using Output with dBASE III PLUS

You can use the output of the ADAP retrieval commands with dBASE III PLUS.

The ADAP retrieval commands have output that places a single record per line.

The data items that make up a record are called fields. For example, the getdir

command outputs a line (a record) for each of the subscribers and that record

consists of fields containing the extension and the name of the particular

subscriber.

The data on these lines is printed in what is called a delimited format; character

field data is enclosed by delimiters (default delimiter is ") and the data items are

separated by commas. This output format is always the same regardless of

whether the command is entered from the MS-DOS prompt, from an MS-DOS

batch file, or from a dBASE III PLUS program. The output always consists of data

written in flat ASCII files or ASCII characters — no binary encoding or

compressing is done.

dBASE III PLUS can use ADAP output and any other files encoded with the

delimited format. If the ADAP retrieval output is redirected to a file, dBASE III

PLUS can read that file.

For example, a file called subs consists of a list of subscriber extensions, one per

line. Executing the following command from the DOS prompt retrieves data about

these subscribers and saves that data in a file called subscr.dat.

getsub < subs > subscr.dat