-    INSTALLING UD7/XML-Data DRIVER    

How to install and configure UD7/XML-Data Driver

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 the UD7/XML-Data driver the DLL is named UD7X.DLL. Use this name instead of the name in this installation guide.

Please note:

You do not have to uninstall any other drivers or March Hare ToolKit, they share no code except this help file.

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

Find the configuration file in your Uniface installation:

Uniface VersionDirectory of Configuration File
SixC:\windows\usys61.ini or
C:\winnt\usys61.ini
7.1Usys:bin\usys.ins
7.2Usys:bin\usys.ini

In the [uniface_dlls] section (version Six [dlls] section) add ud7.dll to the end of the demandload line (you may need to specify the full path eg: c:\usys72\bin\ud7.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:

mhhelp=mhhelp.hlp

2.Modify your usys.asn file.

The following lines may appear in your assignment file in the [DRIVERS] section, to tell the UD7/XML-Data driver which options to use. Uniface Six assignment files are often not broken into sections, in this case this line can appear anywhere in the assignment file.

USYS$UD7_PARAMS = translatechars binary, translate

By default, the UD7/XML-Data driver is not optimised for maximum speed, it is optimised for maximum functionality (read/write/update).

If you want to use UD7/XML-Data to without DELETE or UPDATE operations, for example if you just want to copy data to XML-Data format, you may enable the performance improving options:

USYS$UD7_PARAMS = nokeycheck

If you want to use UD7/XML-Data with DELETE operations, for example if you want to use it to store your Uniface repository, you need to disable all of the performance improving options:

USYS$UD7_PARAMS = disable pra

Congratulations !.

You have now installed the March Hare UD7/XML-Data driver for Uniface.

Use the driver like any other, either define a table, and direct Uniface to store it using UD7 in your assignment file:

[ENTITIES]
mytesttable.mytestmodel$UD7:test.*

Or copy data from a table in an existing database to XML using the IDF with a command line like:

/cpy def:mytesttable.mytestmodel ud7:

Remember that you cannot copy contents of tables until you have ANALYZED the model first.

For all support and enquiry's please contact:

March Hare Pty Ltd

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

www.march-hare.com
consultants@march-hare.com

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