-    INSTALLING UD8/CSV DRIVER    

How to install and configure UD8/CSV Driver

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

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/usys.asn) to load the ud8.dll.

Find the configuration file in your Uniface installation:

Uniface VersionDirectory of Configuration FileSection
SixC:\windows\usys61.ini or
C:\winnt\usys61.ini
[dlls]
7.1Usys:bin\usys.ins[uniface_dlls]
7.2Usys:bin\usys.ini[uniface_dlls]
8.2Usys:adm\usys.asn[USER_3GL]

In the nominated section add ud8.dll, eg:

Uniface 7.2.02
[uniface_dlls]
demandload=c:\usys72\bin\ud8.dll,...

Uniface 8.2.01
[USER_3GL]
.\ud8.dll

2.Modify your usys.asn file.

The following lines may appear in your assignment file in the [DRIVER_SETTINGS] section, to tell the UD8/CSV 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.

[DRIVER_SETTINGS]
USYS$UD8_PARAMS = separator comma

A detailed list of all UD8 driver settings can be found here, and example settings can be found here.

By default, the UD8/CSV driver is not optimised for maximum speed, it is optimised for maximum functionality (read/write/update).

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

USYS$UD8_PARAMS = nokeycheck

If you want to use UD8/CSV 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$UD8_PARAMS = disable pra

Congratulations !.

You have now installed the March Hare UD8/CSV driver for Uniface.

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

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

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

/cpy def:mytesttable.mytestmodel ud8:

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

Contacting us.

Support requests can be logged using our online bug tracking system, or via e-mail. To add or view existing bug reports in the online system you must first log in.

March Hare Online Bug Tracking
support@march-hare.com

For all other 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.13 $ $Date: 2011/02/28 02:56:32 $[go to top]