HFZXUFMT ロード・モジュール・フォーマット・ユーザー出口
HFZXUFMT ロード・モジュール・フォーマット・ユーザー出口 (以降のトピックでは HFZXUFMT 出口と呼びます) は、特殊なタイプのユーザー出口です。このユーザー出口は、REXX フォーマットかロード・モジュール・フォーマットかにかかわらず、 オプションで説明されている、他のユーザー出口に適用される通常の規則には従いません。
HFZXUFMT 出口は、Exits オプションでは指定できず、ロード・モジュール名で検索されます。HFZXUFMT という名前のロード・モジュールが Z Abend Investigator 実行中に APF 許可ライブラリーで見つかると、分析レポートのフォーマット時にこのロード・モジュールが呼び出されます。HFZXUFMT 出口は、Exits オプションで指定された他のフォーマット・ユーザー出口の直前に呼び出されます。
HFZXUFMT 出口には以下の条件があります。
- LE 準拠でなければなりません。
- 「main」関数を含んでいてはなりません。
- NORENT オプションを使用してリンク・エディットされている必要があります。
Z Abend Investigator は、HFZXLFMT (HFZXUFMT に付属する実行不能ロード・モジュール) 内に含まれている HCLXMFMT エントリー・ポイント経由で Z Abend Investigator 出口を呼び出します。出口ユーザー・コードは、エントリー・ポイント HFZXUFMT 経由で呼び出されます。
エントリーの指定
ユーザー・コード HFZXUFMT エントリー・ポイントは、以下を使用して呼び出されます。
- 以下の 2 つのフルワードを指す R1。
- 最初のフルワードは、ENV データ域のアドレスです (ENV - 共通出口環境情報を参照)。
- 2 番目のフルワードは、UFM データ域のアドレスです (UFM - ユーザー出口パラメーター・リストのフォーマットを参照)。
- 保管域を指す R13。
- 戻りアドレスを含む R14。
- HFZXUFMT エントリー・ポイント・アドレスを含む R15。
戻り指定
HFZXUFMT エントリー・ポイントからの戻り時には、以下のようになります。
- R0 および R1 は未定義です。
- R2 から R14 は未変更でなければなりません。
- R15 は未定義です。
サンプル HFZXUFMT 出口
2 つのサンプル HFZXUFMT 出口が、コンパイル (またはアセンブル) およびリンク用の JCL とともに提供されています。
- C HFZXUFMT サンプル出口が HFZ.SHFZSAM1(HFZXUFMC) に提供されています。
- アセンブラー HFZXUFMT サンプル出口が HFZ.SHFZSAM1(HFZXUFMA) に提供されています。