JavaWrap_Asapx_Readme.txt

This README covers the installation of a wrapper for Java to access ASAP. 

In the following, <extractdir> denotes the directory into which you
extracted the ASAP wrapper files (for example, /usr/tandem/ASAPJava),
while <javadir> denotes the base OSS directory for your Java installation
(for example, /usr/tandem/nssjava).  Wherever you encounter <extractdir>
or <javadir> below, substitute the appropriate actual directory name.

Step 1: Create a directory for the wrapper files (the <extractdir>)

   mkdir <extractdir>


Step 2: Copy the ASAP wrapper pax file (JavaWrap_Asapx.pax) to this directory

   cp JavaWrap_Asapx.pax <extractdir>


Step 3: Extract the files from the pax file

   cd <extractdir>
   pax -r -f JavaWrap_Asapx.pax

   This will place the following files onto your system:

   <extractdir>/README_ASAP             -- This document
   <extractdir>/JavaAsap.a              -- A lib to be bound with the JVM
   <extractdir>/Asap.jar                -- A jar file with the Asap class
   <extractdir>/Docs/*                  -- Documentation for the Asap Class
   <extractdir>/Test/*                  -- A test program called TestAsap


Step 4: Copy the JavaAsap.a lib to the <javadir>/lib directory.
          
   cd <extractdir>
   cp JavaAsap.a <javadir>/lib

   
Step 5: Bind the JavaAsap.a lib with the JVM
  
   cd <javadir>/install
   make 


Step 6: Configure the JVM to always run as a named process
  
   nld -change RUNNAMED ON <javadir>/bin/oss/posix_threads/java


Step 7: Copy the Asap.jar file to the <javadir>/lib directory.

   cd <extractdir>
   cp Asap.jar <javadir>/lib

   
Step 8: Place the Asap.jar file into the CLASSPATH for java

   export CLASSPATH=$CLASSPATH:<javadir>/lib/Asap.jar

 *note: You may want to put this command in the .profile or other file being used to set up 
        defaults when logging on to OSS.



To try the test program...

Step 1: Install the test edl 
    
    cd <extractdir>/Test 
    cp /TEST.edl /G/SYSTEM/SYSTEM/TESTEDLC

    (in tacl)
    ctoedit $system.system.testedlc, $system.system.testedl 

    edit $system.system.asapuser 
     a 
     include $system.system.testedl;
     //
     e 

     *restart ASAP as this point


Step 2: Run the test program

     cd <extractdir>/Test
     java TestAsap


Step 3: Monitor via ASAP 

    (in tacl) 

    ASAP 
    app test*, detail