接続ルーチンおよびサインオン・ルーチン内のセッション変数

Db2® には、デフォルトのセッション変数が用意されています。さらに、接続出口ルーチンおよびサインオン出口ルーチンは、さらに最大 10 個のセッション変数をサポートします。 ユーザーは、このような追加のセッション変数を定義することにより、GETVARIABLE 関数を使用してアプリケーションに情報を提供することができます。

プログラム固有のプログラミング・インターフェース情報の開始
セッション変数構造: 接続出口ルーチンおよびサインオン出口ルーチンは、セッション変数構造 (DSNDSVS) を指し示します。 DSNDSVS は、セッション配列内のエントリーの最大数、セッション配列内の実際のエントリー数、およびセッション変数配列を指すポインターを指定します。 セッション変数の実際の数のデフォルト値は、ゼロです。

セッション変数の定義: セッション変数を定義するには、セッション変数配列 (DSNDSVA) を使用して、名前と値のペアの形式で最大 10 個のセッション変数をリストします。 接続出口ルーチンおよびサインオン出口ルーチン内で設定するセッション変数は、SESSION スキーマ内で定義されます。 出口ルーチンがセッション変数配列に与える値は、前の値と置き換わります。

例: 次のセッション変数配列には、6 つのセッション変数がリストされています。
表 1. セッション変数配列の例
名前 値
default_database DATAXM
default_driver PZN4Y7
ロケーション (location) Kyoto
member_of GROUP_42
filename report.txt
account_number A1-X142783
非修飾名は VARCHAR(128) として定義され、値は VARCHAR(255) として定義されます。 出口ルーチンでは、これらの値を Unicode CCSID 1208 で指定する必要があります。
プログラム固有のプログラミング・インターフェース情報の終了