                                          README

                                  EMC Symmetrix Java/JNI API 
                                       Version 6.0.0

* Contents
* Installation
* Requirements

CONTENTS:

  libemc_jsymapi.so              JNI native library loaded by java programs using SYMAPI/STORAPI services.
  emc_jsymapi.dll                

  symapi.jar                     Java side SYMAPI services.
  storapi.jar                    Java side STORAPI services.
  storapi_symapi.jar             Java side STORAPI and SYMAPI services.
 
  SYMAPI_CALLBACKS.java          Contains only Java method signatures.  
                                 The function body can be extended by the user.
                                 Note: add compiled class to classpath.

  STORAPI_CALLBACKS.java         Contains only Java method signatures.  
                                 The function body can be extended by the user.
                                 Note: add compiled class to classpath.

  symapi_example.java            Sample Java program using the SYMAPI.

  symapi_interactive.class       An interactive program to drive all available functions.


INSTALLATION:

Setting CLASSPATH environmental variable

 Note that <PRODUCT_TYPE> can be set to 
 one of the following for the SDK kits:

  symapi
  storapi
  storapi_symapi

 Windows:
 
     C:\> set CLASSPATH=C:\Program Files\EMC\WIDESKY\interfaces\java\<PRODUCT_TYPE>.jar;%CLASSPATH%
 
 
 Unix:
 
   Korn Shell
 
     % export CLASSPATH=/usr/storapi/interfaces/java/<PRODUCT_TYPE>.jar:$CLASSPATH
 
   Bourne Shell
 
     % CLASSPATH=/usr/storapi/interfaces/java/<PRODUCT_TYPE>.jar:$CLASSPATH
     % export CLASSPATH
 
   C Shell
 
     % setenv CLASSPATH /usr/storapi/interfaces/java/<PRODUCT_TYPE>.jar:$CLASSPATH



   The file emc_jsymapi.dll implements in "C" the native methods in symapi.jar. These 2 files 
   must be an exact version match. Applications should BUNDLE and load these 2 files so 
   that compatibility can be supported between the Java/JNI API and the current SYMAPI kit. 
   Applications should use CLASSPATAH or -classpath "xxxx" to specify the load path to the 
   bundled version of symapi.jar and should use the system property -Djava.library.path="xxxx" 
   to specify the load path to the bundled version of emc_jsymapi.dll 


REQUIREMENTS:

  To run the samples you must obtain the Java 2 SDK version 1.3 or higher or the JRE equivalent.
  Refer to the Sun Microsystems pages on the World Wide Web:

  http://java.sun.com

NOTES:

  Some SYMAPI functions that return very large data sets may require a larger working stack size.   
  Here is an example of how to increase working stack.
  java -Xss2048k <args>
