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:
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:
After you use the UD5 installation program to install the tool/driver into your Uniface directory you need to perform the following additional activities:
You do not have to uninstall any other drivers or March Hare ToolKit, they share no code except this help file.
Find the configuration file in your Uniface installation:
|Uniface Version||Directory of Configuration File||Section|
|Six||C:\windows\usys61.ini or |
In the nominated section add
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.
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.
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.
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:
Use the driver to call useful 3GL's using the
perform proc statement, and call Java classes using either the
activate proc statements.
You can use the SQL workbench, or
sql proc statement to start a java class:
If you are using Uniface 7.2.04 or higher, you can use the
activate proc statement to start a java class:
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.
For all support and enquiry's please contact:
March Hare Software Limited
85 - 87 Bayham Street
|$Revision: 1.13 $ $Date: 2014/11/05 02:24:16 $||[go to top]|