X3-F9 Interface

Patch Installation and Technical Setup Guide

Installation Overview ...................................................................................................................... 2

Patch Installation............................................................................................................................. 2
Before Installation ....................................................................................................................... 2
Installation................................................................................................................................... 2
After Patch Installation ............................................................................................................... 2
Technical Setup ............................................................................................................................... 3
Fiscal Year Setup ........................................................................................................................ 3
F9 Reset Parameters .................................................................................................................... 4
F9 Copy Setup to PC................................................................................................................... 5

May 2010 Sage Page 1 of 8

 X3-F9 Interface Installation & Technical Setup

Installation Overview
Please read and understand all instructions before installation. One should also understand X3 patching
procedures before attempting to install. For additional information on X3 patching procedures please see
document HTG-X3 Patching.doc.

Patch Installation
Before Installation
This patch will install the following standard programs
XBF9.src
XBF9LIB.src
XBF9PARLIB.src
XBF9UT1.src
XBF9UT2.src
It is possible the current version of this program(s) may have been modified to provide specific
modifications to your X3 system. If that is the case those programs if any should be saved in your
TRT_Change directory. Review your TRT_Change directory if any and review the programs to see if any
match the programs listed above. If you find a match you should confirm the version in your TRT_Change
directory is the most up to date version. After the patch has been installed you will need to compare the
newly installed version to the version saved in your TRT_Change directory. The changes made to the
saved version must be reviewed and properly integrated into the newly installed version and recompiled.

Installation
Please note; the installation of the following patch is done during the initial installation if purchased.
Install following patch files:
NAV6-Px-XA09

After Patch Installation

The following menu item needs to be added to any users menus that will run the F9 interface. The menu
function should also be added to the standard NASTD menu structure.
MMXF9 F9 Interface
Technical Setup of X3 to F9 Interface is to be followed next.

May 2010 Sage Page 2 of 8

 X3-F9 Interface Installation & Technical Setup

Technical Setup
Fiscal Year Setup
The 'short title' on the Fiscal Year must indicate the fiscal year. This is important, as the X3-F9 Interface
will not work properly if it is not setup. After the 'short title' for the first year is defined for a company and
ledger type, the F9 interface will increment the field to the following financial years. For example, once the
short title is set for 2004 as shown below, the F9 interface will set 2005, 2006, etc. Note; the interface will
not add fiscal years but will set the short title.

Make sure to enter the fiscal year for the

short title for companies that are to use F9
financial reporting.

May 2010 Sage Page 3 of 8

 X3-F9 Interface Installation & Technical Setup

F9 Reset Parameters
This function will rebuild the SQL queries required to support the F9 interface according to the database
associated to the folder (SQL Server or Oracle). This function must be run when moving F9 between
folders on the target folder to re-establish the SQL queries for the interface. The application also creates
the appropriate data pump integration file as well as the data pump interface file. These files are copied
to the user's pc through the routine called "F9 Copy Setup To PC".

Select Ok to run this

application

Trace File Explanation

SQL Information

X3 Database Information

a) Reads current parameters

b) Sets the current version of the
interface
c) Re-creates and compiles SQL
Queries
d) Re-creates F9 datapump.ini and
*.ldi interface files

May 2010 Sage Page 4 of 8

 X3-F9 Interface Installation & Technical Setup

F9 Copy Setup to PC
This function allows the user to copy the appropriate integration (*.ldi) and (datapump.ini) interface files to
the user's pc. Note, the F9 Reset parameters is run once and then this routine is run on each pc that has
F9 installed on it that will require the F9 data from X3. Also, this function will have to be run if there are
changes to parameters or new X3 folders in which F9 is to be used as the financial report writer.

Confirmation prompt,
select Yes to continue or
No to end the application

Select Ok to run this

application

May 2010 Sage Page 5 of 8

 X3-F9 Interface Installation & Technical Setup

The following dialog allows user to select a Windows folder to save the F9 parameter files in. Normally,
this folder becomes with the word 'F9' but may be followed with an F9 version number as shown below.
Be sure to select the correct F9 folder as F9 looks for these in its default root directory (e.g., D:\F9v40) for
this install.
You may change the
folder information
here.

Do not change the

filename

May 2010 Sage Page 6 of 8

 X3-F9 Interface Installation & Technical Setup

The same type of selection box is provided for the *.ldi files. Normally these are installed in the same
location at the datapump.ini file as shown previously.
You should change
the folder information
here to match the data
pump location you
entered previously.

Do not change the

filename

May 2010 Sage Page 7 of 8

 X3-F9 Interface Installation & Technical Setup

The trace file shown below will appear after the copy to pc has been run.

SQL Information

X3 Database Information

a) Reads current parameters

b) Creates a copy of the parameters
in the X3 folder under
XAINT/XA09
c) Messages about the copy

May 2010 Sage Page 8 of 8