XEIIN グローバル・ユーザー出口の実装

CICS® タスク終了によってストレージの最終解放が行われるまでオーバーレイが検出されない場合、XEIIN グローバル・ユーザー出口が役立つことがあります。明示的な FREEMAIN の間、またはタスク終了の間、CICS® は Storage Accounting Area (SAA) オーバーレイを検出できます。タスク終了で検出された場合、タスクは CICS® によって異常終了されないため、Fault Analyzer は起動しません。CICS® はダンプ・コード SM0102 でシステム・ダンプを取得しようと試みますが、CICS® システム・ダンプが抑止されている場合、それ以降の分析は可能ではありません。

SAA オーバーレイに役立つことを目的に、Fault Analyzer には、必要に応じて XEIIN グローバル・ユーザー出口にインストールできるプログラムが用意されています。インストールされている場合、このプログラムは EXEC CICS® RETURN ステートメントごとに、すべての CICS® Storage Accounting Area で現在のタスクを検証します。オーバーレイが見つかると、以下の 2 つのアクションのいずれかが実行されます。

CICS® トランザクション・ダンプをダンプ・コード IDIS で取るための呼び出しが行われます。
Fault Analyzer が XDUREQ グローバル・ユーザー出口にインストールされている場合、このトランザクション・ダンプは通常の方法で分析され、ヒストリー・ファイル障害項目が作成されます。
CICS® 領域の SDUMP が取られます。
この SDUMP を取る要求は IDIS サブシステムによって出されるため、CICS® システム・ダンプ抑止設定による影響はありません。SDUMP が取り込まれると、「File」メニューのオプション 5 で対話式で分析できるようになります。

Fault Analyzer XEIIN グローバル・ユーザー出口プログラムの使用可能化、および実行されるアクションの設定は、Fault Analyzer 提供の CFA トランザクションを使用して行われます。他の Fault Analyzer CICS® 出口とは異なり、CICS® PLT 処理の間に XEIIN 出口を有効にするオプションはありません。

呼び出されたときの初期 CFA 画面は、次のようになっています。

                   Fault Analyzer Control Transaction                        
Options: I=Install U=Uninstall                                               
                  Current Status/Error Message                               
_ XPCABND         Installed                                                  
_ XDUREQ          Installed                                                  
_ LE Exit         Installed                                                  
_ SDUMP Screening Installed                                                  
_ XEIIN           Uninstalled   
                                                                             
        Current    HWM  Setting    MWS                                       
Active     0000   0001     0001                                              
Waiting    0000   0000     0017   0000                                       
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
IDITRACE OFF DeferredReport ON                                               
                                                                             
PF1=Help PF3=Exit PF4=Opts PF5=Clear FND Area PF9=IVP PF11=TRACE ENTER=Update

この画面で「I」を XEIIN の横に入力すると、その出口をインストールできます。この後、次のような画面が表示されます。

                   Fault Analyzer Control Transaction                        
Options: I=Install U=Uninstall                                               
                  Current Status/Error Message                               
_ XPCABND         Installed                                                  
_ XDUREQ          Installed                                                  
_ LE Exit         Installed                                                  
_ SDUMP Screening Installed                                                  
_ XEIIN           Installed   N TXN dump N SDUMP Set at least one option to Y
                                                                             
        Current    HWM  Setting    MWS                                       
Active     0000   0001     0001                                              
Waiting    0000   0000     0017   0000                                       
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
                                                                             
IDITRACE OFF DeferredReport ON                                               
                                                                             
PF1=Help PF3=Exit PF4=Opts PF5=Clear FND Area PF9=IVP PF11=TRACE ENTER=Update

この画面で、TXN dump または SDUMP の横に「Y」を入力して、SAA オーバーレイが検出されたときに実行するアクションを設定します。

I (Install) オプションは、TXN フィールドまたは SDUMP フィールドが変更されるたびに使用する必要があります。

注: Fault Analyzer 出口をインストール/有効にしたときのオーバーヘッドはありませんが、XEIIN 出口だけは EXEC CICS® コマンドごとに CICS® によって呼び出されるため、わずかなオーバーヘッドを生じます。そのため、SAA オーバーレイを調べる必要がある場合のみ、XEIIN 出口を使用するようお勧めします。