
REST サービス・クライアント情報の管理
Db2® DDF は、有効な HTTP REST サービス要求に関するクライアント情報を保管するために、特殊レジスターおよびグローバル変数を暗黙に定義します。クライアント情報は、アカウンティング・レコードに外部化され、-DISPLAY コマンドにより出力されます。
REST サービス要求を処理する際に、Db2 は、クライアント情報を以下の特殊レジスターに保管します。
- CURRENT CLIENT_ACCTNG
- <collectionID.serviceName> の形式の修飾サービス名と連結された HTTP REST GET/POST メソッドのストリングが含まれています。ストリングは、GET SYSIBMSERVICE.simpleSelect1 や POST SYSIBMSERVICE.simpleSelect1 のようになります。 ストリングの最大長は 255 文字で、<serviceName> は切り捨てられることがあります。
- CURRENT CLIENT_APPLNAME
- サービス要求内のサービス名ストリングの値が含まれています。サービス名ストリングの最大長は 128 文字です。
- CURRENT CLIENT_CORR_TOKEN
- スレッド用に生成される作業論理単位 ID (LUWID) ストリングの値 (サービス要求のコミット・カウントなし) が含まれています。 LUWID ストリングの最大長は 78 文字です。 この相関トークンを使用して、サービスによって使用されるダウンストリーム接続を関連付けることができます。
- CURRENT CLIENT_USERID
- 認証 ID ストリングの値が含まれています。認証 ID は、サービス要求の HTTP 接続を確立するために使用され、最大長は 128 文字です。
- CURRENT CLIENT_WRKSTNNAME
- 要求を発信する HTTP REST ヘッダー内のユーザー・エージェント・ストリングまたはクライアント・アプリケーション・ストリングの値が含まれています。 ユーザー・エージェント・ストリングの最大長は 255 文字です。
また、Db2 は、HTTP REST サービス要求に関する情報を以下の組み込みグローバル変数に保管します。
- SYSIBM.CLIENT_IPADDR
- クライアント IP アドレス・ストリングの値が含まれています。IP アドレスは、サービス要求の HTTP 接続を確立するために使用される Db2 サブシステムに関連付けられます。
