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 セットの戻りコードのみが 保管されます。
CREATE VIEW 特権の DBADM 許可検査では、FASTAUTH 要求が 20 回を超える結果になることがあります。 その理由は、CREATE VIEW 要求が複数のデータベースから表、 または表とビューの組み合わせを参照する可能性があるからです。Db2 は、 XAPLDBSP がポイントしたデータベース・リストを使用して CREATE VIEW で参照された すべてのデータベースの名前を渡します。SYSCTRL または SYSADM 許可検査が CREATE VIEW 特権を 付与せず、また DBACRVW が使用可能であることを XAPLCRVW フィールドが示す場合、RACF アクセス・コントロール・モジュールは、リストにある データベースごとにユーザーの DBADM 許可を検査します。各 DBADM 検査の結果は、各データベースに関連付けられた XAPLDBDA フィールドに設定され ます。RACF アクセス・コントロール・モジュールは、次のコードで XAPLDBDA を更新します。
Y
データベースへのアクセスが許可されています。
N
データベースへのアクセスが許可されていません。
U
RACF は決定結果を戻すことができませんでした。これが発生するのは、FASTAUTH 要求が SAF 戻りコード X'04' を戻す場合です。
XAPLDBSP がポイントしたデータベース・リストは、XAPLDBS マクロでマップされる、4 ワードの データベース情報構造で構成されます。
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 を使用して利用できます。

RACF アクセス・コントロール・モジュールは、SAF 戻りコードおよび RACF 戻りコードを 1 バイトに、RACF 理由コードを 2 バイトに切り捨ててから、それらを XAPLDIAG に保管します。XAPLDIAG の各ワードのフォーマットは、次のとおりです。
xxyyzzzz
ここで、
xx
1 バイトの SAF 戻りコード
yy
1 バイトの RACF 戻りコード
zzzz
2 バイトの RACF 理由コード