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.

Figure 1. Sample event summary showing use of the Java wrapper utility
<H1> E V E N T   S U M M A R Y


The following events are presented in chronological order.

Event           Fail  Module   Program  EP
#  Type         Point Name     Name     Name     Event Location (*) Description
-- ------------ ----- -------- -------- -------- ------------------ ---------------------------------------
 1 JavaExc            n/a      n/a      Driver.main
                                                 L#4                From file:/u/testfa1/Driver.class