Fault Analyzer Java ラッパー・ユーティリティーの使用

Fault Analyzer Java ラッパー・ユーティリティーは、FA Java クラスを使用して、try-catch ブロックの呼び出し可能 Java アプリケーションをラップします。

try-catch ブロックは Java™ アプリケーションからの未処理の例外をトラップし、Fault Analyzer メソッドを使用して com.ibm.faultanalyzer.Snap.dump を呼び出します。

使用

バージョン 11 より前の Java JVM を使用している場合:

IDIXJAVA jar ファイルを HFS または zFS ディレクトリーにバイナリーとしてコピーします。

//* --- 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=*
Java JVM バージョン 11 以降を使用している場合:

IDIXJA11 jar ファイルを HFS または zFS ディレクトリーにバイナリーとしてコピーします。

//* --- 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=*

Fault Analyzer ラッパーの起動

ラッパー・ユーティリティーは、コマンド・ラインから、またはバッチ・ジョブ (JCL) の一部として呼び出すことができます。

次のいずれかのコマンドを使用して、コマンド・ライン・アプリケーションからラッパー・ユーティリティーを起動します。

バージョン 11 より前の Java JVM を使用している場合:
  • java -jar idixjava.jar <clsName> <mainArgs>

    または

  • java -cp idixjava.jar FA <clsName> <mainArgs>
Java JVM バージョン 11 以降を使用している場合:
  • java -jar idixja11.jar <clsName> <mainArgs>

    または

  • java -cp idixja11.jar FA <clsName> <mainArgs>
BPXBATCH を使用して起動される Java™ バッチ・アプリケーションの場合:
バージョン 11 より前の Java JVM を使用している場合:
//* --- 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=*
Java JVM バージョン 11 以降を使用している場合:
//* --- 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 は指定された引数をユーザー・アプリケーションの main メソッドに渡します。specified Java™ プロパティーおよび環境変数はユーザー・アプリケーションで通常どおり使用できます。

未処理の例外が発生した場合、結果として生じた障害項目には Java™ イベントに関する情報が含まれます。

図 1. Java ラッパー・ユーティリティーの使用方法を示すサンプルのイベント・サマリー

<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