アクセス制御許可ルーチンのパラメーター・リスト

アクセス制御許可ルーチンのパラメーター・リストには、他の情報へのポインターが含まれます (作業域や許可 ID リストなど)。

プログラム固有のプログラミング・インターフェース情報の開始次の図に、パラメーター・リストが他の情報を指す仕組みを示します。
図 1. 許可ルーチンのパラメーター・リストは、他の情報をどのように指しているか
図の説明の始め。許可ルーチンのパラメーター・リストは他の情報を指しています。
図の説明の終わり。

Db2® の始動時に作業域 (4096 バイト) が取得され、Db2 がシャットダウンされたときのみ解放されます。作業域は出口ルーチンへの呼び出しすべてによって共用されます。

呼び出し時には、レジスターは設定され、許可検査ルーチンは標準出口パラメーター・リスト (EXPL) を使用します。 マクロ DSNDXAPL により記述される出口固有のパラメーター・リストを以下に示します。アスタリスク (*) が示されているフィールド名 は初期化、終了、および許可検査に適用されます。 変更の始まり二重のアスタリスク (**) で示されたフィールド名は、初期化だけに適用されます。変更の終わり その他のフィールドは許可検査だけに適用されます。
表 1. アクセス制御許可ルーチンのパラメーター・リスト
名前 16 進オフセット データ・タイプ 入力または出力 説明
XAPLCBID* 0 文字、2 バイト 入力 制御ブロック ID。値 X'216A'。
XAPLLEN * 2 符号付き 2 バイト整数 入力 長さ XAPL。値 X'100' (10 進の 256)
XAPLEYE * 4 文字、4 バイト 入力 制御ブロック目印。値「XAPL」。
XAPLLVL * 8 文字、8 バイト 入力 Db2 バージョンおよびレベル。例えば「VxRxMx  」。
XAPLSTCK * 10 文字、8 バイト 入力 出口が呼び出された時点のストア・クロック値。 これを使用して、この特定の呼び出しに情報を相関させます。
XAPLSTKN * 18 文字、8 バイト 入力 XAPLACEE が存在しているアドレス・スペース内の STOKEN。2 進ゼロは、XAPLACEE がホーム・アドレス・スペース内にあることを示します。
XAPLACEE * 20 アドレス、4 バイト 入力
  • ACEE アドレス
    • XAPLFUNC が 1 または 3 の時の Db2 アドレス・スペース (ssnmDBM1)。
    • XAPLFUNC が 2 の時にこのエージェント変更の始まりまたは XAPLUCHK ID変更の終わり と関連した 1 次許可 ID。

      ACEE アドレスがエージェントに対して使用不可になっている場合があります。 このような場合、このフィールドには 2 進ゼロが入ります。

XAPLUPRM * 24 文字、8 バイト 入力 以下の ID の 1 つ。
  • XAPLFUNC が 1 または 3 の時は、Db2 アドレス・スペース (ssnmDBM1) のユーザー ID が入ります。
  • XAPLFUNC が 2 の時は、エージェントと関連した 1 次許可 ID が入ります。変更の始まり1 次許可 ID は、XAPLOWAC がオンの場合には XAPLUCHK ID に設定されます。変更の終わり
XAPLFUNC * 2C 符号付き 2 バイト整数 入力 出口ルーチンで実行する機能:
1
初期化
2
許可検査
3
終了
XAPLGPAT * 2E 文字、4 バイト 入力 データ共用の Db2 グループ接続名。データ共用しない場合は、Db2 サブシステム名。
XAPLUCKT 32 文字、1 バイト 入力 Db2 が検査を実行する対象の許可 ID のタイプ:
' '
許可 ID
L
ロール
XAPLONRT 33 文字、1 バイト 入力 XAPLOWNR 内のオブジェクトを所有する許可 ID のタイプ:
' '
許可 ID
L
ロール
XAPLSDEF 34 文字、1 バイト 入力 システム定義オブジェクト:
S
システム定義ルーチンまたはパッケージ
' '
システム定義オブジェクト以外
XAPLRSV1 35 文字、3 バイト   予約済み
XAPLPRIV 38 符号付き 2 バイト整数 入力 検査中の Db2 特権。行および列のアクセス制御に必要なセキュリティー管理者 (SECADM) 権限およびセキュア・オブジェクト作成 (CREATE_SECURE_OBJECT) 特権
XAPLTYPE 3A 文字、1 入力 Db2 オブジェクト・タイプ:
B
バッファー・プール
C
コレクション
D
データベース
E
特殊タイプ
F
ユーザー定義関数
変更の始まりH変更の終わり
変更の始まりグローバル変数変更の終わり
J
JAR
K
パッケージ
L
ロール
M
スキーマ
N
トラステッド・コンテキスト
O
ストアード・プロシージャー
P
アプリケーション・プラン
Q
シーケンス
R
表スペース
S
ストレージ・グループ
T
表
U
システム特権
V
ビュー
XAPLFLG1 3B 文字、1 バイト 入力 この許可 ID (XAPLUCHK) と関連した 2 次 ID が Db2 の許可検査に含まれている場合には、最上位ビット、ビット 8 (XAPLCHKS) はオンです。これがオフの場合は、この許可 ID しか検査されません。

これが表特権またはビュー特権 (SELECT、INSERT など) であり、かつ、表またはビューに対して指定された操作を行うためには SYSCTRL、SQLADM、システム DBADM、ACCESSCTRL、DATAACCESS、または SECADM 権限だけでは不十分な場合は、ビット 7 (XAPLUTB) はオンです。SYSCTRL、SQLADM、システム DBADM、ACCESSCTRL、DATAACCESS、または SECADM には、明示的に付与されていない限り、ユーザー・データにアクセスする特権はありません。

これが autobind である場合には、ビット 6 (XAPLAUTO) はオンです。

インストール・パラメーター DBADM CREATE AUTH が YES に設定されている場合は、ビット 5 (XAPLCRVW) はオンです。

特権が書き込み特権である場合は、ビット 4 (XAPLRDWR) はオンです。 特権が読み取り専用特権である場合は、ビット 4 はオフです。

ビット 3 (XAPLFSUP) はオンで、マテリアライズ照会表の作成時に、CRTVUAUTT 許可検査からのエラー・メッセージを抑止します。 このエラー・メッセージは、最終結果に影響しない中間検査によって発生します。

この処理が ROLE AS OBJECT OWNER 文節で定義されたトラステッド・コンテキストで行われる場合、ビット 2 (XAPLRAOO) はオンです。

許可検査に暗黙に作成されたデータベースが関係する場合、ビット 1 (XAPLIMPD) はオンです。

XAPLUCHK 3C アドレス、4 バイト 入力 Db2 が検査を実行する対象の許可 ID のアドレス。1 次、2 次、または何か他の ID とすることができます。 これは VARCHAR(128) フィールドです。
XAPLOBJN 40 アドレス、4 バイト 入力 特権が関連付けられるオブジェクトの非修飾名のアドレス。これは VARCHAR(128) フィールドで、次のいずれかの名前です。
名前
長さ
アプリケーション・プラン
8
バッファー・プール
8
コレクション
VARCHAR(128)
データベース
8
特殊タイプ
VARCHAR(128)
変更の始まり変数名変更の終わり
変更の始まりVARCHAR(128)変更の終わり
JAR
VARCHAR(128)
パッケージ
VARCHAR(128)
ロール
VARCHAR(128)
スキーマ
VARCHAR(128)
シーケンス
VARCHAR(128)
ストレージ・グループ
VARCHAR(128)
表
VARCHAR(128)
表スペース
8
トラステッド・コンテキスト
VARCHAR(128)
ユーザー定義関数
VARCHAR(128)
ビュー
VARCHAR(128)

特殊システム特権 (SYSADM、SYSCTRL など) の場合は、このフィールドが 2 進ゼロの場合があります。

XAPLOWNQ 44 アドレス、4 バイト 入力 オブジェクト所有者 (作成者) またはオブジェクト修飾子のアドレス。このパラメーターの内容は、検査される特権またはオブジェクトによって 異なります。これは VARCHAR(128) フィールドです。

このフィールドが適用されない場合は、2 進ゼロが入ります。

XAPLREL1 48 アドレス、4 バイト 入力 他の関連情報 1 のアドレス。このパラメーターの内容は、検査される特権またはオブジェクトによって 異なります。 これは VARCHAR(128) フィールドです。

このフィールドが適用されない場合は、2 進ゼロが入ります。

XAPLREL2 4C アドレス、4 バイト 入力 他の関連情報 2 のアドレス。このパラメーターの内容は、検査される特権によって異なります。これは VARCHAR(128) フィールドです。

このフィールドが適用されない場合は、2 進ゼロが入ります。

XAPLDBSP 50 アドレス、4 バイト 入力 データベース情報のアドレス。この情報は、CREATE VIEW および CREATE ALIAS の場合に渡されます。

このフィールドが適用されない場合は、2 進ゼロが入ります。

XAPLOWNR 54 アドレス、4 バイト 入力 オブジェクト所有者のアドレス。これは VARCHAR(128) フィールドです。

このフィールドが適用されない場合は、2 進ゼロが入ります。

XAPLROLE 58 アドレス、4 バイト 入力 トラステッド・コンテキストで操作する場合の、ユーザーのロールのアドレス。このフィールドが適用されない場合は、2 進ゼロが入ります。
XAPLOONM 5C アドレス、4 バイト 入力 他のオブジェクト名のアドレス
XAPLOOON 60 アドレス、4 バイト 入力 他のオブジェクト所有者のアドレス
XAPLBSCM 64 アドレス、4 バイト 入力 ビューまたは繰り返しビュー修飾子の基本表修飾子のアドレス
XAPLBNAM 68 アドレス、4 バイト 入力 ビューまたは繰り返しビュー名の基本表名のアドレス
XAPLBCOL 6C アドレス、4 バイト 入力 ビューまたは繰り返しビュー列名の基本表列名のアドレス
変更の始まりXAPLCLST**変更の終わり 変更の始まり70変更の終わり 変更の始まりアドレス、4 バイト変更の終わり 変更の始まり出力変更の終わり 変更の始まりRACLIST 処理されたクラス・リストのアドレス変更の終わり
変更の始まりXAPLCLNM**変更の終わり 変更の始まり74変更の終わり 変更の始まり符号付き 2 バイト整数変更の終わり 変更の始まり出力変更の終わり 変更の始まりRACLIST 処理された Db2 クラスの数変更の終わり
変更の始まりXAPLFLG3**変更の終わり 変更の始まり76変更の終わり 変更の始まり文字、1 バイト変更の終わり 変更の始まり出力変更の終わり 変更の始まりクラスが複数サブシステム・スコープ (XAPLMSSC) で定義されている場合はビット 8 (最上位ビット) がオン。

残りの 7 ビットは予約済み。

変更の終わり
XAPLRSV2 77 文字、42 バイト   予約
XAPLOOTP A1 文字、1 バイト 入力 その他のオブジェクト・タイプまたはビューの基本表の所有者
XAPLOOOT A2 文字、1 バイト 入力 その他のオブジェクト所有者タイプまたはビューの基本表の所有者タイプ
XAPLRSV3 A3 文字、1 バイト   予約済み
XAPLXBTS A4 タイム・スタンプ、10 バイト 入力 関数解決タイム・スタンプ。 このタイム・スタンプより前に受け取った許可は有効です。

関数とプロシージャーに適用されます。

XAPLONWT AE 文字、1 バイト 出力 UPDATE および REFERENCES 特権について出口ルーチンから Db2 が必要とする情報。
値
説明
' '
リクエスターには、表全体に対する特権がある。
*
リクエスターには、この列に対してだけの特権がある。
XAPLFLG2 AF 文字、1 バイト 入力 オブジェクトに行アクセス制御および列アクセス制御が関連付けられている場合 (XAPLSOBJ)、ビット 8 (最上位ビット) がオンです。

SEPARATE SECURITY システム・パラメーターが YES に設定されている場合 (XAPLSPSC)、ビット 7 がオンです。

SECADM 権限のみがカタログ表 (XAPLSCTB) にアクセスできる場合、ビット 6 がオンです。

パッケージ許可、ルーチン許可、または動的ステートメント・キャッシュに関係するステートメントの許可検査が実行される場合、ビット 5 (XAPLACAC) がオンです。

変更の始まりACEE FOR XAPLUCHK ID が XAPLACEE に設定されている場合はビット 4 (XAPLOWAC) がオン。変更の終わり

変更の始まりクラス名が複数サブシステム・スコープ (XAPLMSSC) で定義されている場合はビット 3 がオン。変更の終わり

変更の始まり残りの 2 ビットは予約済みです。変更の終わり

XAPLDIAG B0 文字、80 バイト 出力 問題の診断に役立てるために出口ルーチンが 戻す情報。

次の表には、ビュー作成用の許可を判別するためのデータベース情報が記載されています。このパラメーター・リストのアドレスは、XAPLREL2 に入っています。

表 2. アクセス制御許可ルーチンのパラメーター・リスト - データベース情報
名前 16 進オフセット データ・タイプ 入力または出力 説明
XAPLDBNP 0 アドレス 入力 次のデータベースに関する情報のアドレス。 X'00000000' は、次のデータベースが存在しないことを示します。
XAPLDBNM 4 文字、8 バイト 入力 データベース名
XAPLDBDA C 文字、1 バイト 出力

CREATE VIEW の出口ルーチンから Db2 が必要とする。

値 Y および EXPLRC1=0 は、フィールド XAPLUCHK のユーザー ID が、フィールド XAPLDBNM のデータベースに関してデータベース管理者権限を持っていることを示します。

XAPLUCHK が別の許可 ID 用のビューを作成できるかどうかを出口ルーチンがチェックする際に、 まず最初に SYSADM または SYSCTRL 権限を検査します。 検査が成功すれば、それ以上の検査は必要ありません。その理由は、ビューの所有者が、そのビューの基になっているすべての表およびビューに対する SELECT 特権を持っていなければならないという 要件を SYSCTRL 権限 (非ユーザー表の場合) または SYSADM 権限が満たしているためです。 これは、ブランク値または EXPLRC1=0 で示されます。

許可 ID が SYSADM または SYSCTRL 権限を持たない場合は、出口ルーチンは、ビューの基礎となっている表のデータベースごとに、ビューの作成者が DBADM を持っているかどうかを検査します。その理由は、基本表のデータベースに対する DBADM 権限は、そのデータベース内のすべての基本表に対してビュー所有者が SELECT 権限を持つという要件を満たしているためです。

XAPLDBIM D 文字、1 バイト 入力 値 'Y' は、データベースが暗黙的に作成されることを示します。
XAPLRSV5 E 文字、2 バイト なし 予約
変更の始まり
表 3. アクセス制御許可ルーチンのパラメーター・リスト - クラス・リスト配列情報
名前 16 進オフセット データ・タイプ 入力または出力 説明
XAPLCMEM** 0 文字、8 バイト 出力 Db2 クラス名
変更の終わり
XAPLOWNQ、XAPLREL1、および XAPLREL2 はオブジェクトをさらに限定する か、あるいは一定の特権に関する許可の判別で使用できる追加情報を提供する ことができます。XAPLOWNQ、XAPLREL1、および XAPLREL2 の内容と特権のリストを以下に示します。
表 4. ある種の特権に関する関連情報
特権 オブジェクト・タイプ (XAPLTYPE) XAPLOWNQ XAPLREL1 XAPLREL2 XAPLOWNR
0263 (USAGE) E スキーマ名のアドレス 特殊タイプ所有者のアドレス 2 進ゼロを含む 特殊タイプ所有者のアドレス
変更の始まり
0291 (READ)
0292 (WRITE)
変更の終わり
変更の始まりH変更の終わり 変更の始まりスキーマ名のアドレス変更の終わり 変更の始まりグローバル変数所有者のアドレス変更の終わり 変更の始まり2 進ゼロを含む変更の終わり 変更の始まりグローバル変数所有者のアドレス変更の終わり
0064 (EXECUTE)
0265 (START)
0266 (STOP)
0267 (DISPLAY)
F スキーマ名のアドレス ユーザー定義関数所有者のアドレス 2 進ゼロを含む ユーザー定義関数所有者のアドレス
0263 (USAGE) J スキーマ名のアドレス JAR 所有者のアドレス 2 進ゼロを含む JAR 所有者のアドレス
0064 (EXECUTE) K コレクション ID のアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0065 (BIND) K コレクション ID のアドレス パッケージ所有者のアドレス 2 進ゼロを含む パッケージ所有者のアドレス
0073 (DROP) K コレクション ID のアドレス 2 進ゼロを含む バージョン ID のアドレス 2 進ゼロを含む
0097 (COMMENT) K コレクション ID のアドレス パッケージ所有者のアドレス 2 進ゼロを含む パッケージ所有者のアドレス
0225 (COPY ON PKG) K コレクション ID のアドレス パッケージ所有者のアドレス 2 進ゼロを含む パッケージ所有者のアドレス
0228 (ALLPKAUT) K コレクション ID のアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0229 (SUBPKAUT) K コレクション ID のアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0252 (ALTERIN)
0097 (COMMENT)
0252 (DROPIN)
M スキーマ名のアドレス オブジェクト所有者のアドレス 2 進ゼロを含む オブジェクト所有者のアドレス
0064 (EXECUTE)
0265 (START)
0266 (STOP)
0267 (DISPLAY)
O スキーマ名のアドレス プロシージャー所有者のアドレス 2 進ゼロを含む プロシージャー所有者のアドレス
0065 (BIND) P プラン所有者のアドレス 2 進ゼロを含む 2 進ゼロを含む プラン所有者のアドレス
0097 (COMMENT) P プラン所有者のアドレス 2 進ゼロを含む 2 進ゼロを含む プラン所有者のアドレス
0061 (ALTER)
0263 (USAGE)
Q スキーマ名のアドレス シーケンス名のアドレス 2 進ゼロを含む 2 進ゼロを含む
0061 (ALTER) R データベース名のアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0073 (DROP) R データベース名のアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0087 (USE) R データベース名のアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0053 (UPDATE)
0054 (REFERENCES)
T 表スキーマのアドレス 列名のアドレス (適用される場合) データベース名のアドレス 表所有者のアドレス
0022 (CATMAINT
      CONVERT)
0050 (SELECT)
0051 (INSERT)
0052 (DELETE)
0055 (TRIGGER)
0056 (CREATE INDEX)
0061 (ALTER)
0073 (DROP)
0075 (LOAD)
0076 (CHANGE NAME
      QUALIFIER)
0097 (COMMENT)
0098 (LOCK)
0233 (ANY TABLE
      PRIVILEGE)
0251 (RENAME)
0275 (REFRESH)
T 表スキーマのアドレス 2 進ゼロを含む データベース名のアドレス 表所有者のアドレス
0020 (DROP ALIAS)
0104 (DROP SYNONYM)
T 表スキーマのアドレス 2 進ゼロを含む 2 進ゼロを含む 2 進ゼロを含む
0103 (ALTER INDEX)
0105 (DROP INDEX)
0274 (COMMENT ON
INDEX)
0283 (RENAME INDEX)
T 表スキーマのアドレス 2 進ゼロを含む データベース名のアドレス 索引所有者のアドレス
0227 (BIND AGENT) U パッケージ所有者のアドレス 2 進ゼロを含む 2 進ゼロを含む パッケージ所有者のアドレス
0015 (CREATE ALIAS) U 2 進ゼロを含む 2 進ゼロを含む データベース名のアドレス (別名が表に関するものである場合) 2 進ゼロを含む
0053 (UPDATE) V ビュー・スキーマのアドレス 列名のアドレス (適用される場合) ビューの基本表のデータベース名のアドレス (該当する場合) ビュー所有者のアドレス
0051 (INSERT)
0052 (DELETE)
V ビュー・スキーマのアドレス 2 進ゼロを含む ビューの基本表のデータベース名のアドレス (該当する場合) ビュー所有者のアドレス
0050 (SELECT)
0073 (DROP)
0097 (COMMENT)
0233 (ANY TABLE
PRIVILEGE)
V ビュー・スキーマのアドレス 2 進ゼロを含む 2 進ゼロを含む ビュー所有者のアドレス
0055 (TRIGGER) V ビュー・スキーマのアドレス 2 進ゼロを含む 2 進ゼロを含む ビュー所有者のアドレス
0061 (ALTER) V ビュー・スキーマのアドレス 2 進ゼロを含む 2 進ゼロを含む ビュー所有者のアドレス
データ・タイプとフィールド長のリストを以下に示します。
表 5. データ・タイプとフィールド長
リソース名またはその他 タイプ 長さ
データベース名 文字 8
変更の始まりグローバル変数名変更の終わり 変更の始まり文字変更の終わり 変更の始まりVARCHAR(128)変更の終わり
表名修飾子 文字 VARCHAR(128)
オブジェクト名修飾子 文字 VARCHAR(128)
列名 文字 VARCHAR(128)
コレクション ID 文字 VARCHAR(128)
プラン所有者 文字 VARCHAR(128)
パッケージ所有者 文字 VARCHAR(128)
パッケージ・バージョン ID 文字 VARCHAR(64)
スキーマ名 文字 VARCHAR(128)
特殊タイプの所有者 文字 VARCHAR(128)
JAR 所有者 文字 VARCHAR(128)
ユーザー定義関数の所有者 文字 VARCHAR(128)
プロシージャー所有者 文字 VARCHAR(128)
ビュー名修飾子 文字 VARCHAR(128)
シーケンス所有者 文字 VARCHAR(128)
シーケンス名 文字 VARCHAR(128)
プログラム固有のプログラミング・インターフェース情報の終了