Using the Z Abend Investigator Java wrapper utility
Z Abend Investigator Java wrapper utility wraps a callable Java application in a try-catch block by using the FA Java class.
The try-catch block traps any unhandled exceptions from the Java™ application and calls Z Abend Investigator using the com.hcl.zai.Snap.dump method.
Usage
Copy the HFZXJAVA jar file as binary to an HFS or zFS directory:
//* --- Copy HFZXJAVA to an HFS or zFS directory:
//CPYXJAVA EXEC PGM=BPXBATCH
//STDPARM DD *
SH cp "//'HFZ.SHFZDOC1(HFZXJAVA)'" /u/hunter2/hfzxjava.jar
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
Invoking the Z Abend Investigator wrapper
You can call the wrapper utility through the command line or as part of a batch job (JCL).
Use either of the following commands to invoke the wrapper utility from a command line application:
-
java -jar hfzxjava.jar <clsName> <mainArgs>
or
-
java -cp hfzxjava.jar FA <clsName> <mainArgs>
For a Java™ batch application that is invoked using BPXBATCH:
//* --- Launch a batch Java application with
//* --- Z Abend Investigator wrapper
// EXPORT SYMLIST=*
// SET HFSDIR=<target directory>
//CPYXJAVA EXEC PGM=BPXBATCH
//STDENV DD *
JAVA_HOME=/usr/lpp/java800/31bit/J8.0/ &&
PATH=${PATH}:${JAVA_HOME}/bin
CLASSPATH=/u/hunter2/classes
/*
//STDPARM DD *
SH java -jar /u/hunter2/hfzxjava JavaApp arg1 arg2
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
Z Abend Investigator passes the specified arguments to the main method of the user application. Any specified Java™ properties and environment variables are available to the user application as normal.
When an unhandled exception occurs, the resulting fault entry contains information about the Java™ event.