User Auxiliary File - GeoTAX_Premium - 7 - 7.7

GeoTAX Premium for Windows, UNIX/Linux, and z/OS

Product type
Product family
Geo Addressing
GeoTAX Premium
Product name
GeoTAX Premium
GeoTAX Premium for Windows, UNIX/Linux, and z/OS
First publish date

Precisely updates its data regularly to incorporate new rules by government entities and enhancements by third-party data providers. In some cases, your organization may have newer information that Precisely has not yet incorporated into the data files. User Auxiliary files provide a way for you to process your input records against a file that includes these changes.

When matching to a User Auxiliary file, complete the following procedure.

Step 1: Create the User Auxiliary file

Directions for creating and editing the User Auxiliary file are located in Appendix G: Auxiliary Files in User Auxiliary file.

Step 2: Load the User Auxiliary file

On Windows:

  1. Copy the User Auxiliary file to %G1GTX%\data\. The filename must be SEQAUX.ASC. If you use a different name, you must edit %G1GTX%\bin\MAKEAUX.BAT and change the filename.

    Note: If GeoTAX is reinstalled, this change will be lost.
  2. Click Start > Programs > Precisely > GeoTAX > Database Load Utility.

    The GeoTAX Database Load Utility dialog box opens.

  3. Select the User auxiliary file option.

  4. To complete the loading process, follow the instructions provided by the utility.

The program installs the User Auxiliary file in the database location for GeoTAX.

On UNIX/Linux:

  1. Copy the User Auxiliary file into the $G1GTX/data subdirectory.

  2. Change to the $G1GTX/bin subdirectory.

  3. Run the installation script installdb.

  4. Select User Auxiliary File.

  5. To complete the loading process, follow the instructions provided by the script.

The load program creates the indexed sequential file G1GTAUX.

On z/OS:

Use the delivered file, yourhlq.GEOTAX.SEQAUX as a template to create your own User Auxiliary file.


  1. Modify the following variables:

    • yourhlq - your high-level qualifier

    • yourRTlib - Runtime Library in effect at your site

    • volume - VSAM DASD pack volser

  2. Insert a job card and submit.

The program produces a database file called G1GTAUX.

Step 3: Match to the User Auxiliary file

When you request a match to the User Auxiliary file, GeoTAX attempts a match to the Landmark Auxiliary file first, then to the User Auxiliary file before attempting a match to any other database. To use the User Auxiliary file for matching, put a Y in position 12 of the CONFIG parameter record in your batch job. The match code for records matching to User Auxiliary files is A.

For information on the CONFIG parameter, see CONFIG.

Step 4: Post User-Defined Data (optional)

Use the AUXOUT parameter record in your batch job to post data from the user-defined portion of the User Auxiliary file to your output records.

For information on the AUXOUT parameter, see AUXOUT.