Z Abend Investigator Java ラッパー・ユーティリティーの使用

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

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

使用

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

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

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

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

//* --- Copy HFZXJA11 to an HFS or zFS directory:
//CPYXJAVA EXEC PGM=BPXBATCH
//STDPARM DD *
SH cp "//'HFZ.SHFZDOC1(HFZXJA11)'" /u/hunter2/hfzxjava.jar
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*

Z Abend Investigator ラッパーの起動

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

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

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

    または

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

    または

  • java -cp hfzxja11.jar FA <clsName> <mainArgs>
BPXBATCH を使用して起動される Java™ バッチ・アプリケーションの場合:
バージョン 11 より前の Java JVM を使用している場合:
//* --- 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=*
Java JVM バージョン 11 以降を使用している場合:
//* --- 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/hfzxja11 JavaApp arg1 arg2
/*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*

Z Abend Investigator は指定された引数をユーザー・アプリケーションの 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