Java try-catch ブロックからの Fault Analyzer の起動

代替スナップ・ダンプ呼び出しメソッド

Fault Analyzer を起動するために使用できる Java™「Snap.dump」メソッドには、多重定義されたバージョンがいくつかあります。

/**
  * Create a Fault Entry
  *
  * @param dumpTitle The user title to use for the Fault Entry. (non-null & non-empty).
  */
public static void dump(String dumpTitle)

/**
  * Create a Fault Entry
  *
  * @param dumpTitle The user title to use for the Fault Entry. (non-null & non-empty).
  *
  * @return The ID of the created Fault Entry, in the form <history file dataset>(<fault id>).
  * E.g. IDI.HIST(F00001)
  *
  */
public static String dump(String dumpTitle, Throwable t)

/**
  * Create a Fault Entry.
  * (This should only be used when gathering diagnostic information requested by IBM Support.)
  *
  * @param dumpTitle The user title to use for the Fault Entry. (non-null & non-empty).
  * @param debug Specifying 'true' will enable verbose debug information.
  * Provide the output to IBM Support.
  *
  * @return The ID of the created Fault Entry, in the form <history file dataset>(<fault id>).
  * E.g. IDI.HIST(F00001)
  */
public static String dump(String dumpTitle, Throwable e, boolean debug)

アプリケーション・クラスパスへのスナップ・クラスの追加

com.ibm.faultanalyzer.Snap.dump メソッドの呼び出しを容易にするには、Fault Analyzer IDIXJAVA Java™ ライブラリーがアプリケーション・プログラム・ビルド・パスに存在しているか、または現行クラス・パス経由で使用可能になっていなければなりません。

IDIXJAVA Java™ ライブラリーは以下の手順で取得できます。

1. 以下のいずれかを実行します。
   • 次のような JCL を使用して、z/OS 上のアプリケーション・ディレクトリーに jar ファイルをコピーします。

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

   • ご使用のプロジェクト開発ディレクトリーにファイル IDI.SIDIDOC1 として IDIXJAVA(IDIXJAVA) をバイナリー FTP 転送します。
     注: IDI.SIDIDOC1(IDIXJAVA) データ・セットおよびメンバーは、Fault Analyzer SMP/E インストールの一部として作成されているので、別の高位修飾子が付いている可能性があります。
2. 以下のいずれかを実行します。
   1. プロジェクト・ビルド・パスを構成して、外部 JAR ライブラリー依存として IDIXJAVA を組み込みます。
   2. ディレクトリー名およびファイル名を現行の ClassPath に追加します。

Fault Analyzer Java SVC ダンプ・タイトル