Xiox Phone Interface Program
Version 1.2

Overview

The XIOX interface program written by Software Technology, Inc. is a DOS program. It is used to convert telephone transactions from a Xiox Phone System or the General Business Software (GBS) for Windows to be compatible with the TABS III Merge Data Capture Transactions program. The XIOX program must reside in the same directory as the TABS III programs in order to work properly. The phone data is transferred from the Xiox System (by selecting the "All Calls Report" text file) or from the General Business Software (GBS) for Windows. The phone data file must be copied to the TABS III program directory.

Xiox System A fee transaction record will be created for each phone call that has a non-zero timekeeper number as part of the Xiox account code. A cost transaction record will be created if the cost of the call is greater than the minimum cost. To create a fee transaction record, the Account Code field must be in the format "CCCC:MMMM:TT", where "CCCC" is the client number, "MMMM" is the matter number, and "TT" is the timekeeper number. For example, if a call is a made by timekeeper 14 to TABS III client number 200.03, the account code information would be keyed in on the phone keypad as "200:03:14". If a long distance call is made and only the cost of the call should be charged to the client, then you should key in timekeeper number 00 (i.e. account code "200:03:00" would be keyed in on the phone keypad) or key in the account code field in the format "CCCCMMMM" (i.e. account code "20003" would be keyed in on the phone keypad).

GBS for Windows System A cost transaction record will be created if the cost of the call is greater than the minimum cost. The Account Code field must be in the format "CCCCMMMM", where "CCCC" is the client number and "MMMM" is the matter number. An optional colon may be included to separate the client number from the matter number. For example, if a call is a made to a TABS III client number 200.03, the account code information would be entered as "20003" or "200:03".

Note: The Create Validation Files program must be run before you can successfully use this data capture device interface program. The Create Validation Files program is found in TABS III by selecting the following menu options Maintenance|Integration|Create Validation Files. When creating validation files, select a Validation File Type of Data Capture Device.

Installation

The Xiox interface program (Xiox.EXE) must be transferred to the directory on your hard disk where the TABS III program files reside. This is done by using the INSTALL program on the Xiox interface program disk.

To install the Xiox interface program on your hard disk:

  1. Insert the Xiox interface program disk into your floppy disk drive.

  2. From a DOS prompt, make the floppy disk drive the default drive by entering the drive letter followed by a "colon". For example, if your floppy disk drive is drive A, then enter:
  3.         A:

  4. From the floppy disk drive prompt, enter the command:
  5.         INSTALL

    Note: The INSTALL program has a built-in search feature that will find where your TABS III program files reside. On larger network hard drives, this search feature can take quite a bit of time. If you know where the TABS III program files reside, you can bypass this search feature by entering the path following the install command. For example, if the TABS III program files reside on drive F: in a directory named "STI", you would enter: INSTALL F:\STI

  6. Follow the on-screen instructions to install the software onto your hard disk. The Install program will locate your TABS III software on your hard disk so that the interface program can be transferred to the same directory as TABS III. After the installation process, the message "Installation Complete" will be displayed.

Executing the XIOX Interface Program

Use the following procedure for conversion:

  1. Transfer the data from your Xiox system or your GBS for Windows system to your computer’s hard disk where your TABS III data files reside. The data must be in ASCII format and must reside in the TABS III program directory.

  2. From a DOS prompt, start the interface program by entering:
  3.         XIOX

  4. You will be prompted to enter the input file name containing the Xiox telephone data.

  5. If you are using the Xiox System, the first time you run the XIOX program you will be asked to enter the TABS III fee transaction code number that you use for telephone fee transactions. Then you will be asked to enter the TABS III cost transaction code number that you use for telephone cost transactions. You may use the same transaction code number for both fees and costs if you wish. Then, you can also specify the minimum phone call duration before a fee transaction will be created. For example, if you don’t want to charge a fee for phone calls less than 6 minutes, enter 6. You will also be asked to specify a minimum cost before a cost transaction will be created. Phone calls with a cost below the minimum cost will not be converted.

    If you are using the GBS for Windows system, the first time you run the XIOX program you will be asked to enter the TABS III cost transaction code used for telephone cost transactions. Next, you will be prompted to specify the minimum cost before a cost transaction will be created. Phone calls with a cost below the minimum cost will not be converted.
  6. Note: All the options entered above are stored in a parameter file named XIOX.PRM. Each time the XIOX program is executed, it will read the XIOX.PRM file and use those options automatically.

  7. Next, the "Is it OK to continue? (Y/N)" prompt will be displayed. If you enter "N", the program will be aborted. If you enter "Y", the program will look for the input file containing the phone data. If the input file is found to contain data, the program will display the message "CONVERTING TRANSACTIONS" followed by a count for each transaction read from the file. The files T3EXPKEY.REM, T3EXP.REM and T3EDESC1.REM will be created which can be merged with the main TABS III data files. If you are using the Xiox system, the file T3FEEKEY.REM, T3FEE.REM, T3FDESC1.REM will also be created which can be merged with the main TABS III data files. You must then start TABS III and run the Merge Data Capture Transactions program.

Important: Be sure to clear the transactions from your phone system’s memory to avoid duplication of data in your TABS III data files.

Note: If you are not using a demo version of the program, the telephone data file will automatically be deleted when the conversion is complete to avoid double posting of the data.

Note: You may change the telephone transaction codes, minimum duration, or minimum cost in the future by deleting the file XIOX.PRM which is created in your TABS III directory. This will enable you to go through the setup procedure described above in Step 4 as a first time user of the program.

 

Xiox System File Layout

Field

Name

Starts at

Length

Format

1

Extension

4

4

not used

2

Trunk Used

10

4

not used

3

Number Dialed

17

16

(xxx)xxx-xxxx or INCOMING

4

Date

34

8

mm/dd/yy format

5

Time

43

6

not used

6

Duration

50

8

minutes in decimal format up to 9999.9

7

Cost

59

8

billable dollar amount with dollar sign up to $99999.99

8

Account Code

68

EOL

up to 16 digits (with optional decimal point or colon)

Notes

GBS for Windows File Layout

Field

Name

Format

1

Account

up to 12 digits (with optional decimal point or colon)

2

Account Code Description

not used

3

Date

mm/dd/yy format

4

Time

not used

5

DAC

not used

6

Number Dialed

(xxx)xxx-xxxx or INCOMING

7

City/State

not used

8

Duration

not used

9

Cost

billable dollar amount with dollar sign up to $99999.99

10

CrLf

carriage return/line feed

Notes

Optional Client Fee File for XIOX (XIOXFEE.DTA)

An optional client flat fee file can be used by the XIOX program to create a fee transaction for a specified flat fee amount for selected clients. If a phone call includes the attorney number as part of the call account information, a fee transaction will be generated. Normally, fee transactions are based on the duration of the call multiplied by the attorney’s hourly rate. However, if the client being billed for the call has a record in the optional fee file, then the fee transaction will be based on the flat fee associated with the client instead.

The client flat fee file must be a standard (ASCII) text file and can be created using a word processing program. The file must be named XIOXFEE.DTA and it must reside on your hard disk drive in the same directory as the XIOX.EXE program. The file can contain as many client records as are necessary.

XIOXFEE.DTA File Layout

Field

Name

Starts at

Length

Format

1

Client Number

1

12

up to 12 digits

2

Flat Fee Amount

14

5

billable dollar amount up to 99999 or 99.99

3

Description

19

EOL

not used

Sample XIOXFEE.DTA File:

The following is a sample of a XIOXFEE.DTA file. The positioning of the clients and amounts is intentional to show you the flexibility allowed in the format. Normally, you will probably want to right-justify the client numbers and align the dollar amounts making the information more readable when you look at the file. The sample transactions are preceded by three lines of numbers. The first line shows the field number, the second line shows the character position by tens, and the third line shows character position by single digits.

1         2    3
         1         2         3         4         5
1234567890123456789012345678901234567890123456789012345
101          15.00 ABC Insurance Co.
200          10.00
203          10    Allstate Corp.
1025          15.    XYZ Co.
123           15
2024         20.50
300          5.75   (note that the decimal points don’t have to align)

2001/02/08