Setting up an ATE dialing directory

The ATE dialing directory file lists phone numbers that the ATE program uses to establish remote connections by modem.

To set up an ATE dialing directory, the following prerequisites must be met:

The Asynchronous Terminal Emulation (ATE) program must be set up on the system
To set up a system-wide dialing directory, the user must have write access to the /usr/lib/dir file

Users name the dialing directory file with any valid file name and place it in any directory where read and write access is owned. Edit the dialing directory file with any ASCII text editor. The default dialing directory information for the ATE program is contained in the /usr/lib/dir file, as shown in the following:

Note: In the following content, some ATE entries have been broken into separate lines for readability. In an actual dialing directory file, however, all elements of an entry must be declared on a single, continuous line.

#   COMPONENT_NAME: BOS dir
#
#   FUNCTIONS:
#
#   ORIGINS: 27
#
#
#   (C) COPYRIGHT International Business Machines Corp. 1985, 1989
#   Licensed Materials - Property of IBM
#
#   US Government Users Restricted Rights - Use, duplication or
#   disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#
#   dir - sample dialing directory
#
#
# Micom   9,555-9400 1200 7 1 2 0 0
# R20     9,555-9491 1200 7 1 2 0 0
# QT      9,555-8455 1200 7 1 2 0 0
# Dallas1 9,555-7051 1200 8 1 0 0 0

Users can access the dialing directory information from within ATE by using the directory subcommand available in the UNCONNECTED MAIN MENU. The screen will show the directory information as it would appear from within the ATE program.

Users can have more than one dialing directory. To change the dialing directory file the ATE program uses, the user must modify the ate.def file in the current directory.

Note: The dialing directory file can contain up to 20 lines (one entry per line). ATE ignores subsequent lines.

The dialing directory file is similar to a page in a telephone book that contains entries for the remote systems called with the ATE program. The format of a dialing directory entry is:

Name Phone Rate Length StopBit Parity Echo Linefeed

The fields must be separated by at least one space. More spaces can be used to make each entry easier to read. The fields are:

Name

Identifies a telephone number. The name can be any combination of 20 or fewer characters. Use the _ (underscore) instead of a blank between words in a name, for example, data_bank.

Phone

The telephone number to be dialed. The number can be up to 40 characters. Consult the modem documentation for a list of acceptable digits and characters. For example, if a 9 must be dialed to access an outside line, include a 9, (the numeral 9 and a comma) before the telephone number as follows: 9,1112222.

Although the telephone number can be up to 40 characters long, the directory subcommand displays only the first 26 characters.

Rate

Transmission or baud rate in bits per second (bps). Determines the number of characters transmitted per second. Select a baud rate that is compatible with the communication line being used. The following are acceptable rates:

50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, or 19200.

For non-POSIX baud rates, setting the rate at 50 causes the ATE to use the configured baud rate set through SMIT for that device.

Length

Number of bits that make up a character. The entry for the Length field can be 7 or 8.

StopBit

Stop bits signal the end of a character. The entry for the StopBit field can be 1 or 2.

Parity

Checks whether a character was successfully transmitted to or from a remote system. The entry for the Parity field can be 0 (none), 1 (odd), or 2 (even).

Echo

Determines whether typed characters display locally. The entry for the Echo field can be 0 (off) or 1 (on).

Linefeed

Adds a line-feed character at the end of each line of data coming in from a remote system. The line-feed character is similar in function to the carriage-return and new-line characters. The entry for the Linefeed field can be 0 (off) or 1 (on).

Note: Changing or remapping may be necessary if control keys conflict across applications. For example, if the control keys mapped for the ATE program conflict with those in a text editor, remap the ATE control keys.

Note: The ASCII control character selected may be in octal, decimal, or hexadecimal format, as follows:

octal: 000 through 037. The leading zero is required.
decimal: 0 through 31.
hexadecimal: 0x00 through 0x1F. The leading 0x is required. The x may be uppercase or lowercase.

Create an ate.def file that defines those characteristics to change characteristics of ATE emulation. For example, to change the RATE to 300 bps, the DEVICE to tty3, the TRANSFER mode to x (xmodem protocol), and the DIRECTORY to my.dir, create an ate.def with the following entries, in the directory running the ATE program:

RATE          300
DEVICE        tty3
TRANSFER      x
DIRECTORY     my.dir

The program uses the defined values from time the ATE program starts from that directory.

Create the dialing directory file:
1. Change to the directory where the dialing directory file will reside.
2. Copy the /usr/lib/dir file to use as a template. Rename the file to any valid file name.
3. Create telephone number entries using the format given in the dialing directory file format.
4. Save the file.
  Note: If the new dialing directory file is to be the system-wide default file, save the file with the name /usr/lib/dir.
If the dialing directory file name is not the default (/usr/lib/dir), edit the ate.def file in the directory from which the ATE program is run. Change the DIRECTORY parameter in the ate.def file to the new dialing directory file.
See Editing the ATE default file
Start ATE, and view the dialing directory with the directory subcommand.