Using the Command Line to Process Phone Book and Region Files

Processing POP and region information requires that you first export phone book and region information from your current database into text files. After the text files are created, you can use the command-line interface to import the text files into the Phone Book Administrator database. For more information about the database format, see “Phone_Book.mdb.”

The following sections illustrate the text file formats into which you will need to export your phone book and region information.

Exported Phone Book File Format

Each row in a phone book file contains information related to a POP. The rows consist of eleven fields that are comma-delimited. For this reason, field data must not contain commas.

The following diagram illustrates the export phone book file format needed to process POPs by means of the command-line interface.

The following table outlines POP field names, data structures, and content.

Name	Data structure	Content
POP Index	Integer	Numerical POP identifier
Country ID	Integer	TAPI code
Region ID	Integer	Numerical region identifier
POP Name	Text	Name given to the POP
Area Code	Integer	Area code
Access Number	Integer (hyphen allowed)	Access Number
Min Baud	Integer	Minimum baud rate
Max Baud	Integer	Maximum baud rate
Always 0	Integer (must be zero)	Not applicable
Service Flag	Integer	Value representing a combination of POP settings
Dun Entry	Text	Name of the entry in the service profile that references a script

A list of country IDs may be found in the Country.txt file in \Program Files\PBA.

Exported Region File Format

The following diagram illustrates the export region file format that you will need to use if you add, edit, or delete regions by means of the command-line interface.

Note

The exported region files do not match the region file format generated by Phone Book Administrator.

The following table outlines region field names, data structures, and content.

Name	Data structure	Content
Region ID	Integer	Numerical region identification
Region Name	Text	Region name

Before you import phone book and region files into a particular phone book, you will have to make sure that the phone book name is registered in the administration tool’s phone books list.

To check whether the phone book name is registered

Click Start, point to Programs, point to Windows NT 4.0 Option Pack, point to Internet Connection Services for RAS, and then click Phone Book Administrator.
Read the names of the phone books listed in the Phone books list.

If the phone book does not appear, you need to use Phone Book Administrator to establish a phone book.

To establish a phone book

Click Start, point to Programs, point to Windows NT 4.0 Option Pack, point to Internet Connection Services for RAS, and then click Phone Book Administrator.
On the File menu, click New Phone Book.
Type the phone book name.

Notes

Some characters can not be used for a phone book name. For more information, please see "Fields with Special Requirements" in the Connection Point Services Administration Guide.

Before you use the command line interface to import POP information to a phone book, you must first quit the Phone Book Administrator.

To import phone book files

Click Start, point to Programs, and click Command Prompt.
In the Command Prompt window, change to the \Program Files\Pba directory, and then type the following:

Pbadmin /I ByteComp /P [drive:][path] filename1 /R [drive:][path] filename2

In this example, ByteComp is the name of the phone book file, filename1 is the name of the file containing POP information, and filename2 is the name of the file containing region information.

The following table is a descriptive list of command-line switches.

Switch	Description

/I phone_book_name	The name of the phone book into which you are importing data. (The phone book name must match one listed in the administration tool Phone book window.)
/P phone_book_file_name	The fully qualified path name of the phone book file from which you are importing data.
/R region_file_name	The fully qualified path name of the region file from which you are importing data.
/?	The list of command-line switches.