How to install and configure Form ToolKit version 1.4

After you use the installation program to install the tool into your Uniface installation you need to perform the following additional activities:

If you are installing the demo version of Form ToolKit Version 1.4, the forms are named MHGFP14X.FRM and AGBFSPEX.FRM, and the DLL is named MHGFP14X.DLL. Use these names instead of the names in this installation guide.

Please note:

You do not have to uninstall version 1.3 to install version 1.4. These two versions can both be installed and run at the same time, they share no code except this help file.

1.Modify your configuration file (usys.ini) to load the mhgfp140.dll.

Find the configuration file in your Uniface installation:

Uniface VersionDirectory of Configuration File
SixC:\windows\usys61.ini or

In the [uniface_dlls] section (version Six [dlls] section) add tableau.dll to the end of the demandload line (you may need to specify the full path eg: c:\usys72\bin\mhgfp140.dll).

If you are using a INI file specified from the command line (eg: idf /ini=c:\7205.ini) then you may wish to use the [userdlls] section instead.

In the [help] section, add the line:


2.Modify your usys.asn file.

The following lines must appear in your assignment file in the [FILES] section, to tell the IDF where to find the TRX file and the source code.

Depending on the version of Uniface that you are using, you may already have the first line.


3.Load the Uniface signatures and source code.

In order to use the pre-compiled .frm files that were installed you need to load the matching signatures into your repository. If you have purchased the non-demo version of the tools you may also load in the source code.

To do this alter your IDF shortcut to include a ? at the end of the command line, eg:

C:\usys72\bin\idf.exe ?

Now when you start this shortcut, Uniface will present a small dialog box for you to enter some parameters.

If you have purchased the full product enter the following:

/cpy trx:usys:mhgfp140.trx idf:

If you have the demo product enter the following:

/cpy trx:usys:mhgfp14x.trx idf:

4.Load in the device translation table and set up a printer to use for ‘difference’ operations.

If you want to use the ‘Functional Spec’ feature of the Form ToolKit to compare 2 forms, then you need to use a printer definition that:

We have included a device translation table and a printer definition for this purpose. Consult the Uniface documentation of device translation tables and Uniface printer definitions for more information about their definition and interrelationship.

To install the device translation table FORMTOOLKIT and the printer definition FORMTOOLKIT, use the shortcut you created in step 3, with these commands:

/sup /cpy trx:usys:pprinter.trx sys:
/sup /cpy trx:usys:pdict.trx idf:
/sup /cpy trx:usys:ptext.trx uuu:

If you have any of the following settings in your assignment file, then you will have to re-compile your DOL file to use the new printer definition:


To recompile the DOL file, no user can be using that DOL file (ie: using Uniface or a Uniface application), then use the previous shortcut with this command:


To use this printer model in Form ToolKit with the Functional Spec utility, when prompted for the Printer Model, specify: FORMTOOLKIT.

Congratulations !.

You have now installed the March Hare Form Paint Tableau Search tool for Uniface.

To start Form ToolKit, use the shortcut defined in step 3 with the command:

/tst mhgfp140

or if you have installed the demo version:

/tst mhgfp14x

For all support and enquiry's please contact:

March Hare Pty Ltd

P.O. Box 265
Church Point, NSW, 2105


$Revision: 1.10 $ $Date: 2011/02/28 02:56:32 $[go to top]