How to use

XUPRICER
1. Introduction
XUPRICER program goal is to gather the different values necessary to provide a quote for the Xtech-
Upgrade package for the project.

XUPRICER is delivered in a X3 patch format.

On X-TECHARTS Web site, www.x-techarts.com, in the sales tab, a zip file is available for download.

It includes XUPRICER patch for

- X3 V5
- X3 V6
- X3 V7 or higher

You’ll have to install the adequate patch version on your customer folder.

Patch contains adx programs.

It must be installed and executed in the customer production folder (the one to upgrade).

If you plan to upgrade several folders, you’ll have to install and to execute XUPRICER patch on each
folder.

2. XUPRICER
- Reads Sage X3 development description in a set of supervisor tables (ATABLE, ATABZON,
AMSK, AMSKZON, …..) and the same tables in the X3 folder. It evaluates the differences and
writes them on a trace file.
- Sends SQL requests to the database to know the number of records and the size of each
table of the production folder, and writes the result in the same trace file.
- Reads some license information and writes them in the trace file

It doesn’t not write or alter any data and presents no risk for the customer folder.
Execution time is depending on the number of tables, the database size, ….. and the speed of the
server. An average time is around 5 minutes.

Depending on the GLANDEF parameter of the folder, XUPRICER will be executed in French
(GLANDEF=”FRA”) or in English otherwise.

A confirmation will be asked before running the script, and TEMPON messages will show you where
you are in the process.

XUPRICER V5.1 1
3. Ho to use XUPRICER

1) Download the zip file on X-TECHARTS Web site

2) Unzip the file with 7-Zip

3) Choose the patch distribution corresponding to your customer X3 version (V5, V6, or V7 or
higher)
4) Connect to the production folder and call the patch integration function (PATCH). Nota : the
patch must be integrated in the production folder

5) Execute the XUPRICER program with the Run Processes (EXETRT) function. Nota : You must
be logged in the production folder to execute this script

XUPRICER V5.1 2
6) After a few minutes you will obtain a trace file (Note : Display messages will inform you of
the progress). Copy this file using the copy function in the trace file. Trace you get must be
completed, finishing by “Normal End of Trace”

XUPRICER V5.1 3
 7) Fulfill this form

Your Company Name

Customer Name

Target X3 version V9 V11 V12

Do you intend to change the database system during the

Upgrade (Oracle <-> SQL Server) ? YES NO

Is-it a multi folder upgrade ? YES NO

If yes, how many folders do you plan to upgrade ?

Nota : In case of multi-folders upgrade you have to produce and send a XUPRICER trace for all the
folders you plan to upgrade as a license will be produced and delivered for each of them.

8) Email trace(s) file(s) and the form to info@x-techarts.com.

You’ll receive an answer with a quote for your upgrade.

XUPRICER V5.1 4
 4. Understanding the trace file
The trace file provides a set of information that may be useful, even if you don’t need at all to
understand the content at this stage

For development topics, you’ll find

- The number of elements added
- The number of elements modified (ie. for collections and sub-collections - tables and
columns, masks and fields)
- The number of “Top Modification”. A “top modification” is when you set a specific activity
code in a standard element at the top level (ie. On a standard mask, window, table, ..). You’ll
have to remove these activity code when you’ll upgrade.
During the upgrade process Xtech-Toolbox will help you to detect everything that may cause
trouble and to correct it.

For each table program will gather some information

- Table name
- Followed by
o * if it is a flow table
o – if it is a table that will be excluded from the upgrade
o + if it is a settings table
o “blank” if it is a development table
- The number of rows of a table
- A set of 3 values
o c for the number of columns
o z for the number of zones (columns multiplied by the dimension),
o lg for the length of the table line in bytes
- Data and Index size of the table in Gb
- Maximum size of the table extracted in SVG format. A second value will give the maximum
size of the lobs if the table contains any lob. Maximum SVG size for the table will be the sum
of the 2 values, even if practically it will be less, as lobs are not always filled

XUPRICER V5.1 5