Using the Fault Analyzer Java wrapper utility

Fault Analyzer 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 Fault Analyzer using the com.ibm.faultanalyzer.Snap.dump method.

Usage

If using a version of Java JVM earlier than version 11:

Copy the IDIXJAVA jar file as binary to an HFS or zFS directory:

//* --- Copy IDIXJAVA to an HFS or zFS directory:
//CPYXJAVA EXEC PGM=BPXBATCH
//STDPARM DD *
SH cp "//'IDI.SIDIDOC1(IDIXJAVA)'" /u/hunter2/idixjava.jar
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
If using a Java JVM version 11 or later:

Copy the IDIXJA11 jar file as binary to an HFS or zFS directory:

//* --- Copy IDIXJA11 to an HFS or zFS directory:
//CPYXJAVA EXEC PGM=BPXBATCH
//STDPARM DD *
SH cp "//'IDI.SIDIDOC1(IDIXJA11)'" /u/hunter2/idixja11.jar
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*

Invoking the Fault Analyzer 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:

If using a version of Java JVM earlier than version 11:
  • java -jar idixjava.jar <clsName> <mainArgs>

    or

  • java -cp idixjava.jar FA <clsName> <mainArgs>
If using Java JVM version 11 or later:
  • java -jar idixja11.jar <clsName> <mainArgs>

    or

  • java -cp idixja11.jar FA <clsName> <mainArgs>
For a Java™ batch application that is invoked using BPXBATCH:
If using a version of Java JVM earlier than version 11:
//* --- Launch an earlier than version 11 batch Java application with
//* --- Fault Analyzer 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/idixjava JavaApp arg1 arg2
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
If using Java JVM version 11 or later:
//* --- Launch a batch Java version 11 or later application with
//* --- Fault Analyzer 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/idixja11 JavaApp arg1 arg2
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*

Fault Analyzer 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