XAPLDIAG の内容の使用
RACF® アクセス・コントロール・モジュールは、Db2® および他のライセンス・プログラムが診断情報のトラップおよび獲得に使用できるように、パラメーター XAPLDIAG を戻します。
許可検査のために RACF アクセス・コントロール・モジュールが RACROUTE REQUEST=FASTAUTH マクロを発行した場合、 検査で使用される AUDIT オプションに応じて、このコントロール・モジュールは、結果の SAF 戻りコード、 RACF 戻りコード、 および RACF 理由コードを XAPLDIAG に記録できます。 RACF アクセス・コントロール・モジュールの各呼び出しごとに、 複数の RACROUTE REQUEST=FASTAUTH マクロを発行可能ですが、 このコントロール・モジュールは、生成された各戻りコードを評価し、 単一の正しい戻りコードを判別して、それを Db2 に送ります。
RACF アクセス・コントロール・モジュールは、RACROUTE REQUEST=FASTAUTH からの戻りコードを 20 セットまで XAPLDIAG に保管でき、しかも特定 の RACROUTE REQUEST=FASTAUTH マクロの結果を判別できるようにします。
XAPL パラメーター・リストは、Db2 トレース・レコード IFCID 314 を使用して収集できます。さらに、 許可失敗の場合の戻りコードおよび対応する理由コード (EXPLRC1 および EXPLRC2) は、 Db2 トレース・レコード IFCID 140 に収集されます。
XAPLDIAG の内容は、RACF アクセス・コントロール・モジュールからの戻りコードおよび理由コードによって異なります。 XAPLDIAG 内の戻りコードと理由コードは、特権ごとの規則表に記述されている検査と同じ順序です。 この順序を使用して、どの検査が失敗し、どの検査がアクセス権限を付与したかを判別できます。
- EXPLRC1=4 および ECPLRC2=14 (10 進数) の場合、ALESERV は失敗し、このコントロール・モジュール は RACROUTE REQUEST=FASTAUTH 検査を行いませんでした。この場合、XAPLDIAG の最初のワードには、 ゼロ以外の ALESERV 戻りコードが含まれています。
- それ以外の場合、XAPLDIAG の各ワードには、RACROUTE REQUEST=FASTAUTH マクロからのゼロ以外の戻りコードに対応する SAF 戻りコード、 RACF 戻りコード、および RACF 理由コードが入ります。 ゼロ以外の戻りコードに関連する情報は、最初のワードから始めて、すべてのゼロ以外の戻りコードに関連する 情報が保管されるまで、または XAPLDIAG エリアが満杯になるまで、XAPLDIAG に保管され ます。XAPLDIAG には 20 ワードを収容可能で、その結果、RACF アクセス・コントロール・モジュールの呼び出しに対して 20 回の FASTAUTH 要求に関連する 情報を保管できます。20 回を超える FASTAUTH 要求が発行された場合、最初の 20 セットの戻りコードのみが 保管されます。
- Y
- データベースへのアクセスが許可されています。
- N
- データベースへのアクセスが許可されていません。
- U
- RACF は決定結果を戻すことができませんでした。これが発生するのは、FASTAUTH 要求が SAF 戻りコード X'04' を戻す場合です。
XAPLDBNP DS F PTR TO NEXT DATABASE INFORMATION STRUC
XAPLDBNM DS CL8 DATABASE NAME
XAPLDBDA DS CL1 'Y' - IS DBADM
XAPLDBIM DS CL1 'Y' - IS AN IMPLICIT DATABASE
XAPLRSV5 DS CL2 RESERVED - UNUSED
DBADM 検査は複数のデータベースに対して実施可能ですが、 最初の 20 回の FASTAUTH 要求の結果のみが XAPLDIAG に保管されます。データベースごとのすべての DBADM 検査の結果は、 XAPL パラメーター・リストに含まれ、 Db2 トレース・レコード IFCID 314 を使用して利用できます。
xxyyzzzz
ここで、
- xx
- 1 バイトの SAF 戻りコード
- yy
- 1 バイトの RACF 戻りコード
- zzzz
- 2 バイトの RACF 理由コード