組み込みセッション変数
Db2 は、サーバーおよびアプリケーション・プロセスに関する情報を含むいくつかの組み込みセッション変数を提供します。 組み込みセッション変数の値を取得するには、組み込みセッション変数の名前を指定して GETVARIABLE 関数を呼び出します。
Db2 以下の組み込みセッション変数を提供します
- SYSIBM.APPLICATION_ENCODING_SCHEME
- SYSIBM.APPLICATION_ENCODING_SCHEME セッション変数には、DSNTIPF設置パネルの「APPLICATION ENCODING」フィールドで指定された値に対応する文字列が含まれています。 値はEBCDIC、ASCII、UNICODE、または1~65533であり、このセッション変数は決して空になることはありません。
- SYSIBM.COBOL_STRING_DELIMITER
- セッション変数 SYSIBM.COBOL_STRING_DELIMITER には、DSNTIPF インストールパネルの STRING DELIMITER フィールドで指定された値に対応する文字列が格納されます。 値は DEFAULT、"または'であり、このセッション変数は決して空になることはありません。
- SYSIBM.DATA_SHARING_GROUP_NAME
- SYSIBM.DATA_SHARING_GROUP_NAME セッション変数には、この Db2 サブシステム用のデータ共有グループの名前に対応する文字列が含まれています。 サブシステムがデータ共用グループに含まれていない場合は、NULL 値が戻されます。
- SYSIBM.DATE_FORMAT
- SYSIBM.DATE_FORMAT セッション変数には、 DSNTIP4 インストールパネルのDATE FORMATフィールドで指定された値に対応する文字列が含まれています。 値はISO、JIS、USA、EUR、またはLOCALであり、このセッション変数は決して空であってはなりません。
- SYSIBM.DATE_LENGTH
- SYSIBM.DATE_LENGTH セッション変数には、 DSNTIP4 インストールパネルのLOCAL DATE LENGTHフィールドで指定された値に対応する文字列が含まれています。 値は10~254、または出口なしの場合は0であり、このセッション変数は決して空になることはありません。
- SYSIBM.DECIMAL_ARITHMETIC
- セッション変数には、 DSNTIP4 インストールパネルの DECIMAL ARITHMETIC フィールドで指定された値に対応する文字列が含まれています。 値は DEC15、 DEC31、15、または31であり、このセッション変数は決してnullになることはありません。
- SYSIBM.DECIMAL_POINT
- セッション変数には、DSNTIPF インストールパネルの「DECIMAL POINT IS」フィールドで指定された値に対応する文字列が含まれています。 値は「.」です このセッション変数が NULL になることはありません。
- SYSIBM.DEFAULT_DECFLOAT_ROUND_MODE
- SYSIBM.DEFAULT_DECFLOAT_ROUND_MODE セッション変数には、DSNTIPF設置パネルのDECFLOAT ROUNDING MODEフィールドで指定された値に対応する文字列が含まれています。 このセッション変数が NULL になることはありません。
- SYSIBM.DEFAULT_SSID
- SYSIBM.DEFAULT_SSID セッション変数には、DSNTIPKのインストールパネルの「GROUP ATTACH」フィールド、またはDSNTIPMのインストールパネルの「SUBSYSTEM NAME」フィールドで指定された値に対応する文字列が含まれています。 このセッション変数が NULL になることはありません。
- SYSIBM.DEFAULT_LANGUAGE
- SYSIBM.DEFAULT_LANGUAGE セッション変数には、DSNTIPFインストールパネルのLANGUAGE DEFAULTフィールドで指定された値に対応する文字列が含まれています。 値はASM、C、CPP、IBMCOB、FORTRAN、または PL/I で、このセッション変数がNULLになることはありません。
- SYSIBM.DEFAULT_LOCALE_LC_CTYPE
- SYSIBM.DEFAULT_LOCALE_LC_CTYPE セッション変数には、DSNTIPFインストールパネルのLOCALE LC_CTYPEフィールドに指定された値に対応する文字列が含まれています。 このセッション変数が NULL になることはありません。
- SYSIBM.DISTRIBUTED_SQL_STRING_DELIMITER
- SYSIBM.DISTRIBUTED_SQL_STRING_DELIMITER セッション変数には、DSNTIPFのインストールパネルのDIST SQL STR DELIMTRフィールドに指定された値に対応する文字列が含まれています。 値は「、または'です。このセッション変数は、決して空になることはありません。
- SYSIBM.DSNHDECP_NAME
- SYSIBM.DSNHDECP_NAME セッション変数には、 DSNHDECPまたはユーザー指定のアプリケーションデフォルトモジュールがロードされたデータセットの完全修飾データセット名に対応する文字列が含まれています。 例えば、「DSN910.SDSNEXIT(DSNHDECP)」。 このセッション変数が NULL になることはありません。
- SYSIBM.DYNAMIC_RULES
- SYSIBM.DYNAMIC_RULES セッション変数には、 DSNTIP4 インストールパネルの「USE FOR DYNAMICRULES」フィールドで指定された値に対応する文字列が含まれています。 値はYESまたはNOであり、このセッション変数は決して空ではありません。
- SYSIBM.ENCODING_SCHEME
- SYSIBM.ENCODING_SCHEME セッション変数には、DSNTIPFインストールパネルの「DEF ENCODING SCHEME」フィールドで指定された値に対応する文字列が含まれています。 値はEBCDIC、ASCII、UNICODEのいずれかであり、このセッション変数は決して空になることはありません。
- SYSIBM.MIXED_DATA
- SYSIBM.MIXED_DATA セッション変数には、DSNTIPF設置パネルのMIXED DATAフィールドで指定された値に対応する文字列が含まれています。 値はYESまたはNOであり、このセッション変数は決して空ではありません。
- SYSIBM.NEWFUN
- SYSIBM.NEWFUN セッション変数には、 Db2 プリコンパイラまたは Db2 コプロセッサが受け入れる SQL 関数構文のデフォルトの最大レベルを表す文字列が含まれています。これは、 Db2 関数レベルに関係なくです。 NEWFUNオプションの詳細については、「SQL処理オプションの説明」 を参照してください。
- SYSIBM.PACKAGE_NAME
- SYSIBM.PACKAGE_NAME セッション変数には、現在実行中のパッケージの名前に対応する文字列が含まれています。 パッケージが現在実行されていない場合は、NULL 値が戻されます。 (この状態は、実行中のプランが 1 つ以上の DBRM に直接バインドされている場合に生じます)
- SYSIBM.PACKAGE_SCHEMA
- SYSIBM.PACKAGE_SCHEMA セッション変数には、現在実行中のパッケージのコレクションIDに対応する文字列が含まれています。 パッケージが現在実行されていない場合は、NULL 値が戻されます。
- SYSIBM.PACKAGE_VERSION
- SYSIBM.PACKAGE_VERSION セッション変数には、現在実行中のパッケージのバージョンに対応する文字列が格納されています。 パッケージが現在実行されていない場合は、NULL 値が戻されます。
- SYSIBM.PAD_NUL_TERMINATED
- SYSIBM.PAD_NUL_TERMINATED セッション変数には、 DSNTIP4 インストールパネルのPAD NUL-TERMINATEDフィールドで指定された値に対応する文字列が含まれています。 値はYESまたはNOであり、このセッション変数は決して空ではありません。
- SYSIBM.PLAN_NAME
- SYSIBM.PLAN_NAME セッション変数には、現在実行中のプランの名前に対応する文字列が含まれています。 このセッション変数が NULL になることはありません。
- SYSIBM.SECLABEL
- SYSIBM.SECLABEL セッション変数には、現在のユーザーIDに対して SECLABEL値が定義されている場合、その値に対応する文字列が含まれています。 RACF® 値が定義されていない場合は、NULL 値が戻されます。
- SYSIBM.SQL_STRING_DELIMITER
- SYSIBM.SQL_STRING_DELIMITER セッション変数には、DSNTIPFインストールパネルのSQL STRING DELIMITERフィールドで指定された値に対応する文字列が含まれています。 値は DEFAULT、"または'であり、このセッション変数は決して空になることはありません。
- SYSIBM.SSID
- SYSIBM.SSID セッション変数には、この Db2 サブシステム用の実際の Db2 サブシステム識別子に対応する文字列が含まれています。 このセッション変数が NULL になることはありません。
- SYSIBM.STANDARD_SQL
- SYSIBM.STANDARD_SQL セッション変数には、 DSNTIP4 インストールパネルのSTD SQL LANGUAGEフィールドで指定された値に対応する文字列が含まれています。 値はYESまたはNOであり、このセッション変数は決して空ではありません。
- SYSIBM.SYSTEM_NAME
- SYSIBM.SYSTEM_NAME セッション変数には、インストールパネルDSNTIPMのフィールドSUBSYSTEM NAMEで定義されているように、 Db2 for z/OS® サブシステムの名前に対応する文字列が含まれています。 このセッション変数が NULL になることはありません。
- SYSIBM.SYSTEM_ASCII_CCSID
- SYSIBM.SYSTEM_ASCII_CCSID セッション変数には、このシステムで使用されている ASCII CCSID を表す値が含まれています。 この情報は、インストール・パネル DSNTIPF で指定された ASCII CCSID に対応するコンマ区切りストリングとして戻されます。 戻される 3 つの値は、このシステム上で ASCII データ用に使用されている SBCS、 MIXED、およびグラフィックの CCSID に相当します。 MIXED またはグラフィックの CCSID の値が 65534 の場合、このシステムはその CCSID のデータの格納をサポートしないことを示しています。 このセッション変数が NULL になることはありません。
- SYSIBM.SYSTEM_EBCDIC_CCSID
- SYSIBM.SYSTEM_EBCDIC_CCSID セッション変数には、このシステムで使用されているEBCDIC CCSIDを表す値が格納されています。 この情報は、インストール・パネル DSNTIPF で指定された EBCDIC CCSID に対応するコンマ区切りストリングとして戻されます。 戻される 3 つの値は、このシステム上で EBCDIC データ用に使用されている SBCS、 MIXED、およびグラフィックの CCSID に相当します。 MIXED またはグラフィックの CCSID の値が 65534 の場合、このシステムはその CCSID のデータの格納をサポートしないことを示しています。 このセッション変数が NULL になることはありません。
- SYSIBM.SYSTEM_UNICODE_CCSID
- SYSIBM.SYSTEM_UNICODE_CCSID セッション変数には、このシステムで使用されているUnicode CCSIDを表す値が格納されています。 この情報は、インストール・パネル DSNTIPF で指定された UNICODE CCSID に対応するコンマ区切りストリングとして戻されます。 戻される 3 つの値は、このシステム上で Unicode データ用に使用されている SBCS、 MIXED、およびグラフィックの CCSID に相当します。 このセッション変数が NULL になることはありません。
- SYSIBM.TIME_FORMAT
- SYSIBM.TIME_FORMAT セッション変数には、 DSNTIP4 インストールパネルの「TIME FORMAT」フィールドで指定された値に対応する文字列が含まれています。 値はISO、JIS、USA、EUR、またはLOCALであり、このセッション変数は決して空であってはなりません。
- SYSIBM.TIME_LENGTH
- SYSIBM.TIME_LENGTH セッション変数には、 DSNTIP4 インストールパネルの「現地時間長さ」フィールドで指定された値に対応する文字列が含まれています。 値は8~254または0で、出口なしの場合は0です。このセッション変数は、決して空になることはありません。
- SYSIBM.VERSION
- SYSIBM.VERSION セッション変数には、 Db2 のバージョンを表す文字列が含まれています。プロダクト ID (PRDID) 値は、pppvvrrm 形式の 8 バイト文字の値です。ここで、ppp は 3 文字のプロダクト・コード、vv はバージョン、rr はリリース、m はモディフィケーション・レベルです。
Db2 13 for z/OS では、修正レベル(0~9またはA~Z)は特定の機能レベルを示します。 例えば:
- DSN13012V13R1M501 用。
- DSN13011V13R1M500 用。
- DSN13010V13R1M100 用。
詳細は、 Db2 for z/OS の「Product identifier (PRDID) values」 をご覧ください。
このセッション変数が NULL になることはありません。
GETVARIABLEコールの例
例えば、次のステートメントは、ホスト変数 hv1 の値を現在実行中のプランの名前に設定します。
SET :hv1 = GETVARIABLE('SYSIBM.PLAN_NAME'); GETVARIABLE関数に関する詳細は、 GETVARIABLEスカラー関数をご覧ください。