DHI C access libs

DHI for C uses the Java Native Interface (JNI) mechanism for communications with a DHI server.

This is the JNI interface to the "DHI_Access.java" DHI Access functions written by ISTI for the IRIS DMC.

The following files should be viewed first:

    dhi_access.h - header file to include for the DHI Access functions.
    dhi_access_test.c - example of how to use the DHI Access functions.

To use the DHI Access functions the "dhi_access.h" header file should be included for function declarations. The first thing a program must do is initialize the JNI and CORBA via the "initJNI" function (see dhi_access.h.). If there is an error with the initialization the function will return a non-zero error value and the "getexitcode" function should be used to get the exit code.

After successful initialization, the "requestSeismograms" function may be used to request seismograms, the "requestEvents" function may be used to request events and the "requestResponse" function may be used to request a response. If there is an error with the request the function will return a NULL value and the "getexitcode" function should be used to get the exit code.

After each call to a request function (requestSeismograms, requestEvents, requestResponse) the corresponding free function (freeSeismograms, freeEvents, freeResponse) should be called to release any dynamically allocated memory.

The provided example program (see the "main" function in dhi_access_test.c) may be edited to request seismograms (default), events or a response.

COMPILING:

NOTE: In order to compile the JAVA_HOME environment variable in the script files must point to a Java JDK. A Java JRE will not work as it doesn't support JNI. Java version 1.4.1 and later have been tested. Earlier versions may or may not work and should be avoided if possible.

To compile on Linux, simply type:

make -f Makefile.linux

To run on Linux, simply type:

runLinux.sh

To compile on Mac OS X, simply type:

make -f Makefile.macosx

To run on Mac OS X, simply type:

runMacOSX.sh

To compile on Sun Solaris, simply type:

make -f Makefile.solaris

To run on Sun Solaris, simply type:

runSun.sh

NOTE: To clean the you may use the same command that is used to compile the program and just add " clean" to the end, such as:

make -f Makefile.solaris clean

COMPILING with Windows:

compileWin.bat: Windows batch file for compiling using Microsoft C
dhi_access.ide: Project file for compiling using Borland C
runWin.bat: Helper batch file for running 'dhi_access.exe'
jvm_bc.lib: Library file for compiling using Borland C

SEE ALSO:

Please refer to the CORBA FISSURES IDL for descriptions of the arguments to the request functions. They are described in detail in the "Fissures.idl" (for general values), "IfSeismogramDC.idl" (for the "requestSeismograms" function), the "IfNetwork.idl" (for the "requestResponse" function) and the "IfEvent.idl" ("for the requestEvents" function) IDL files.

If you have any problems contact support @ isti.com.