IDIUTIL ListHFDUP ユーザー出口

IDIUTIL ListHFDUP ユーザー出口について、以下で説明します。

目的

この出口は、LISTHFDUP 制御ステートメントを使用して IDIUTIL バッチ・ユーティリティーを実行し、ヒストリー・ファイルの管理で異常終了インスタンスのリストを制御できます (詳しくは、LISTHFDUP 制御ステートメントを参照してください)。この制御は、データ域フィールド UTL.PERFORM_ACTION を「Y」(項目をリストする場合) または「N」(項目をリストしない場合) に設定することによって行われます。フィールド UTL.PERFORM_ACTION は、出口を呼び出す前に「Y」に設定されます。さらに、UTL.DUP_TYPE が提供され、現在の異常終了インスタンス・タイプの重複に関する情報が提供されます。UTL データ域の詳細については、UTL - IDIUTIL バッチ・ユーティリティー・ユーザー出口パラメーター・リストを参照してください。

ユーザー出口が呼び出される対象の異常終了インスタンスは、指定された LISTHFDUP 制御ステートメント基準に一致する異常終了インスタンスです。

呼び出されるタイミング

LISTHFDUP 制御ステートメントを使用して IDIUTIL バッチ・ユーティリティーが実行されるとき、この出口はヒストリー・ファイル内の異常終了インスタンスごとに 1 回呼び出されます。

パラメーター

パラメーターがどのように出口に渡されるかは、出口タイプ (REXX またはロード・モジュール) によって異なります。

Fault Analyzer は、IDIUTIL ListHFDup ユーザー出口を呼び出す前に、特定の異常終了インスタンスおよび有効な処理オプションの現行値を使用してパラメーター・リストを初期化します。

REXX

出口は、以下の 2 つのステムを使用できます。

定義された変数名は、フィールド名と同じです。例えば、ENV データ域のフィールド VERSION にアクセスするには、REXX 変数 ENV.VERSION を使用します。

ロード・モジュール

この出口へのエントリーで、R1 には以下の 2 つのフルワードを構成するパラメーター・リストの 31 ビット・アドレスが含まれます。

以下は、REXX で書かれた IDIUTIL ListHFDUP ユーザー出口の例です。

1. REXX IDIUTIL ListHFDup ユーザー出口の例
/* REXX */
if ENV.VERSION <> 5 then
say 'Note: ENV data area version change - field usage review required!'
if UTL.VERSION <> 2 then
say 'Note: UTL data area version change - field usage review required!'
if UTL.DUP_TYPE = 'F'      /* If it is a CICSFast duplicate */
  UTL.PERFORM_ACTION = 'Y' /* list current entry */
else
  UTL.PERFORM_ACTION = 'N' /* otherwise don't */
上記のサンプル出口がデータ・セット X.Y.Z のメンバー ABC として存在する場合、次の JCL DD ステートメント
//IDIEXEC DD DISP=SHR,DSN=X.Y.Z
および次の IDIUTIL バッチ・ユーティリティー制御ステートメント
Exits(LISTHFDUP(REXX(ABC)))
IDIUTIL バッチ・ユーティリティー・ヒストリー・ファイル管理ジョブに指定すると、出口が呼び出されます。