初期化 (XAPLFUNC = 1)

XAPLFUNC 機能コード 1 を指定して RACF® アクセス・コントロール・モジュールを呼び出すと、このコントロール・モジュールは RACROUTE REQUEST=STAT 要求を発行して、 RACF がアクティブかどうかを判別します。

RACF がアクティブでない場合、RACF アクセス・コントロール・モジュールは、 Db2® に戻りコード 12 を戻します。RACF がアクティブな場合、RACF アクセス・コントロール・モジュールは、 アセンブラー SET シンボルで指定されたとおりにクラス名を作成し、新規 Db2 関連クラスごとに RACROUTE REQUEST=LIST,CLASS=classname を実行します。

重要

  • &CLASSNMT をオーバーライドするかまたは単一サブシステム適用範囲を使用する場合、RACF アクセス・コントロール・モジュールは、 お客様が定義したクラスのみを使用します。
  • デフォルトの &CLASSNMT とともに複数サブシステム適用範囲を使用する場合、 RACF アクセス・コントロール・モジュールは、IBM® 提供のクラスを使用します。

RACROUTE REQUEST=LIST,ENVIR=CREATE,GLOBAL=YES 要求は、その特定の Db2 用のデータ・スペースにプロファイルを取り込むか、または後続の Db2 がそれらのストレージ内にあるプロファイルを使用できるようにします。

アクティブな Db2 関連クラスがなかった場合、障害が発生し、RACF アクセス・コントロール・モジュールは戻りコード 12 で終了します。

注: 以下は、障害ではありません。
  • クラスがアクティブでない (SAF RC=4, RACF RC=10)
  • クラスが定義されていない (SAF RC=4, RACF RC=8)

クラスがアクティブでないか、あるいはオブジェクトまたは権限用に存在していない場合、 RACF アクセス・コントロール・モジュールは、Db2 に許可検査を任せて、 戻りコード 4 で終了します。

1 つの 要求が失敗すると、初期化全体 が失敗します。 これが発生した場合、RACF アクセス・コントロール・モジュールはすべてのリソースをクリーンアップし、戻りコード 12 で終了します。

Db2 オブジェクトに対する許可用に Db2 クラスを使用する場合、そのクラスは、Db2 サブシステムの始動時に アクティブでなければなりません。

初期化処理時の障害は、戻りコードと理由コードを対にして、メッセージを付けて出力されます。

初期化時の戻りコードおよび理由コード

以下の戻りコードおよび理由コードは、10 進表記で示されています。
戻りコード
意味
0
初期化は正常終了しました。
理由コード
意味
0
インストール・ オプション &ERROROPT が 1 に設定されました。 したがって、エラーの場合、Db2 が元来保有する許可が使用されます。
16
インストール・オプション &ERROROPT が 2 に設定されました。 したがって、後続の許可検査でエラーの場合、Db2 システムが停止されるように要求されます。
12
初期化は失敗しました。RACF アクセス・コントロール・モジュールは再び呼び出されません。
理由コード
意味
1
入力 Db2 サブシステム ACEE が提供されませんでした。インストール・オプション &ERROROPT が 1 に設定されました。したがって、Db2 本来保有の許可が使用されます。
2
RACF がアクティブではありません。インストール・ オプション &ERROROPT が 1 に設定されました。 したがって、Db2 本来保有の許可が使用されます。
3
RACROUTE REQUEST=LIST,ENVIR=CREATE 障害。インストール・オプション &ERROROPT が 1 に設定されました。したがって、Db2 本来保有の許可が使用されます。
4
アクティブな Db2 クラスがありません。インストール・ オプション &ERROROPT が 1 に設定されました。 したがって、Db2 本来保有の許可が使用されます。
10
XAPL レベルに誤りがあります。XAPLLVL の値が V8R1M0 より小さい値です。インストール・ オプション &ERROROPT が 1 に設定されました。 したがって、Db2 本来保有の許可が使用されます。
12
入力 Db2 サブシステム ACEE が無効でした。インストール・オプション &ERROROPT が 1 に設定されました。したがって、Db2 本来保有の許可が使用されます。Db2 許可が使用されます。
16
初期化エラーが発生しました。インストール・オプション &ERROROPT が 2 に設定されました。したがって、Db2 サブシステムが停止するように要求されます。