INSTALLING 3GLs+UD5/JNI DRIVER

How to install and configure 3GLs+UD5/JNI Driver

This topic covers both the installation of the March Hare utility 3GL's DLL, and the UD5/Java Native Interface driver. You may install both or either one of these tools since they are not interdependant.

Before you install the UD5/JNI+MW1 driver you should either:

Install the JRE (Java Runtime Environment), which allows you to execute Java programs using the Java Native Interface.
Install the JDK (Java Development Kit), which includes JRE. This allows you to compile and execute Java programs.

Several versions are available for free download from the Oracle web site: http://www.oracle.com/technetwork/java/archive-139210.html.

NOTE: The most recent version of Java that we have tested is listed in the release notes of UD5.

NOTE: The Microsoft Java Runtime is not sufficient to use UD5/JNI+MW1.

After installing Java (as above) you must also add the jvm.dll to your System Environment PATH, eg:

On Windows use the SYSTEM control panel ENVIRONMENT VARIABLES button
PATH=C:\eclipse\jre7\bin\client;C:\eclipse\jre7\bin;...

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

Modify your configuration file to load the ud5.dll.
Modify your assignment file (usys.asn or other) for any driver parameters.
Modify system path to include the location of the UD5 shared library.

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 ud5.dll.

Find the configuration file in your Uniface installation:

Uniface Version	Directory of Configuration File	Section
Six	C:\windows\usys61.ini or C:\winnt\usys61.ini	[dlls]
7.1	Usys:bin\usys.ins	[uniface_dlls]
7.2	Usys:bin\usys.ini	[uniface_dlls]
8.2	Usys:adm\usys.asn	[USER_3GL]
9.x	Usys:adm\usys.asn	[USER_3GL]

In the nominated section add ud5.dll,mh3gls.dll, eg:

Uniface 7.2.02

[uniface_dlls]


demandload=c:\usys72\bin\ud5.dll,c:\usys72\bin\mh3gls.dll,...

Uniface 8.2.01 or Uniface 9.x.x

[USER_3GL]


.\ud5.dll


.\mh3gls.dll

to the end of the demandload line (you may need to specify the full path eg: c:\usys72\bin\ud5.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.

2.Modify your usys.asn file.

The following lines may appear in your assignment file in the [DRIVER_SETTINGS] section, to tell the UD5/JNI 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$UD5_PARAMS = -classpath C:\eclipse\jre7\lib;C:\ud5\MrchHre
USYS$MW1_PARAMS = -classpath C:\eclipse\jre7\lib;C:\ud5\MrchHre

NOTE: The MW1 setting is only for Uniface version 7.2.04 or higher (and all later versions including Uniface 9.6.x), if you wish to call Java methods using the Uniface activate proc instruction.

3. Modify system path to include the location of the UD5 shared library.

In order to be able to activate Uniface operations from within your Java programs (eg: the HELLOSWING or HELLOWORLDSWING classes supplied), the location of the UD5.DLL shared library must be added to the operating system PATH.

You can change the PATH environment variable in Windows by using the System Control Panel. Open the Control Panels window by the "Start" menu, and selecting "Settings, Control Panels". Open the System Control Panel, by double clicking on the System icon. The PATH environment variable is on the "Environment" tab.

Alternatively you can copy ud5.dll to a directory which is already on the PATH, eg: %SYSTEMROOT%\SYSTEM32 (c:\winnt\system32). If you do this, you must also ensure that Uniface opens the DLL from the same location by altering the INI file.

Congratulations !.

You have now installed the March Hare 3GL+UD5/JNI driver for Uniface.

These links will take you to further articles about how to use the MH3GLs.DLL and the UD6/JNI+MW1 Driver:

A Quick Tour

Use the driver to call useful 3GL's using the perform proc statement, and call Java classes using either the sql or activate proc statements.

[PATHS]


$UD5            UD5:


$MW1		MW1:





[SERVICES_EXEC]


HELLOWORLDSWING  $MW1:HelloWorldSwing


COMPUTE  $MW1:COMPUTE

You can use the SQL workbench, or sql proc statement to start a java class:

sql "HELLOWORLDSWING.EXEC","ud5"

If you are using Uniface 7.2.04 or higher, you can use the activate proc statement to start a java class:

activate "COMPUTE".ADD(1,2)


askmess "Result of 1+2=%%$status","ok"

For more information on the pre-defined 3GL routines available in MH3GLS.DLL, please refer to 3GL Routines in Proc Code. For more information on using the UD5+MW1 Driver please refer to UD5 Overview.

Getting Support

For all support and enquiry's please contact:

March Hare Software Limited
85 - 87 Bayham Street
Camden Town
London
NW1 0AG
United Kingdom

www.march-hare.com
support@march-hare.com

phone Australia: +61 2 8212 4409
phone North America: +1 800 653 1501
phone UK: Freecall 0800 376 0404
phone Europe: +44 (0)20 7692 0712, or within the UK: Freecall 0800 376 0404
phone international: +44 (0)20 7692 0712

$Revision: 1.13 $ $Date: 2014/11/05 02:24:16 $

[go to top]