接続ルーチンおよびサインオン・ルーチンの予想される出力

Db2® は、出力値として、1 次 ID、SQL ID、および 2 次 ID を使用します。ユーザーのルーチンは、これらの ID を、SQL の短い ID の値に 設定することができます。

プログラム固有のプログラミング・インターフェース情報の開始
ID が 8 文字の基準を満たしていない場合、要求は失敗します。 したがって、必要な場合には、短い ID には末尾にブランクを追加して、基準を必ず満たしてください。

戻された値がブランクではない場合は、Db2 はその値を以下のように解釈します。

  • 1 次 ID が 1 次許可 ID になります。
  • 2 次 ID のリスト (最初のブランクのエントリーまで、または最大 1012 個のエントリーまで) が、2 次許可 ID のリストになります。2 次 ID リストに割り振られているスペースは、許可 ID の最大数が入る だけの大きさしかありません。 この数字はフィールド AIDLSCNT に含まれています。
    重要: 1012 個を超える 2 次許可 ID を使用できるようにすると、異常終了またはストレージ・オーバーレイが発生することがあります。
  • SQL ID が検査され、それが 1 次 ID と一致しているか、 または 2 次 ID のいずれかと一致しているかが調べられます。 一致していないと、接続またはサインオン処理は失敗します。そうでない場合には、妥当性検査済み ID が現行の SQL ID になります。

1 次 ID の戻り値がブランクである場合は、Db2 は以下のステップを実行します。

  • 接続処理では、Db2 のインストール時に定義された デフォルト ID (パネル DSNTIPP の UNKNOWN AUTHID) が、1 次許可 ID および現行 SQL ID として置き換わります。2 次 ID のリストは、ブランクに設定されます。
  • サインオン処理は異常終了します。1 次 ID のデフォルト値は存在しません。

SQL ID の戻り値がブランクの場合、Db2 はその値を 1 次 ID の値と等しいものにします。2 次 ID のリストがブランクの場合は、ブランクのままになります。 デフォルトの 2 次 ID は存在しません。

ユーザー・ルーチンは、出口パラメーター・リストのワード 5 に戻りコードを設定して、アクセスを許可または拒否することもできます (フィールド EXPLARC)。 この方法を使用し、接続をすべて拒否することができます。 このコードは、表 1に示す値のいずれかでなければなりません。
表 1. EXPLARC に指定できる戻りコード
値 意味
0 アクセスは許可され、処理は続行されます。
12 アクセスは拒否され、処理は終了します。
上記以外の値を指定すると、異常終了が起こります。
プログラム固有のプログラミング・インターフェース情報の終了