ACTIVE_DB_CONNECTIONS 表関数
ACTIVE_DB_CONNECTIONS 表関数は、DRDA、DDM、および Db2® Mirror 接続ごとに 1 つの行を含む結果表を戻します。 これらの接続の場合、指定されたジョブには、アプリケーション・リクエスターまたはアプリケーション・サーバー・ロールのいずれかがあります。
リモート・システムで接続がアクティブではなくなった場合でも、この表関数の結果に表示される可能性があります。 この場合、ERROR 列の値は YES になります。
権限: 呼び出し元は、指定された job-nameを実行しているユーザー・プロファイルと同じユーザー・プロファイルであるか、呼び出し元が *JOBCTL 特殊権限を持っているか、QIBM_DB_SQLADM または QIBM_DB_SYSMON 機能使用 ID に対して許可されている必要があります。
- ジョブ名
- 接続情報が戻される対象の修飾ジョブ名が入っている式。 特殊値 '*' は現行ジョブを示します。
この関数の結果は、以下の表に示された形式の行を含むテーブルです。 列はすべて NULL 可能です。
| 列名 | データ・タイプ | 説明 |
|---|---|---|
| CONNECTION_USAGE | VARCHAR(21) | 接続のローカル・サーバー (ジョブ名) 側の接続使用量。
|
| REMOTE_HOST_NAME | VARCHAR(255) | この接続のリモート・システムの名前。 |
| REMOTE_JOB_NAME | VARCHAR(28) | ジョブ名に接続されているリモート・ジョブの修飾ジョブ名。 リモート・サーバーが IBM® iでない場合は、NULL 値が入ります。 |
| REMOTE_USER | VARCHAR(255) | リモート接続のユーザー名。 |
| CLIENT_RDB | VARCHAR(18) | アプリケーション・リクエスターの RDB 名。 接続が DDM ファイル操作にのみ使用される場合は、NULL 値を入れることができます。 |
| SERVER_RDB | VARCHAR(18) | アプリケーション・サーバーの RDB 名。 接続が DDM ファイル操作にのみ使用される場合は、NULL 値を入れることができます。 |
| CONNECTION_TIME | TIMESTAMP | 接続が確立されたときのタイム・スタンプ。 |
 接続時間 (UTC) |
TIMESTAMP | 接続が確立されたときのタイム・スタンプ (協定世界時 (UTC))。 |
| CONNECTION_TYPE | VARCHAR(11) | ジョブ名と REMOTE_JOB_NAME の間で確立された接続のタイプ。
|
| NRG_NAME | VARCHAR(15) | この接続に使用されるネットワーク冗長グループ (NRG)。 CONNECTION_TYPE が DB2® MIRROR でない場合は、NULL 値が入ります。 |
| CLIENT_PORT | INTEGER | クライアント・ホスト・ポート番号。 |
| CLIENT_ADDRESS | VARCHAR(45) | クライアントの IP アドレス。 これは、IPv6 アドレス・フォーマットで表示されます。 |
| SERVER_PORT | INTEGER | サーバー・ホストのポート番号。 |
| SERVER_ADDRESS | VARCHAR(45) | サーバーの IP アドレス。 これは、IPv6 アドレス・フォーマットで表示されます。 |
| SNA_DEVICE_NAME | VARCHAR(10) | リモート・ロケーションとの通信に使用される装置の名前。 CONNECTION_TYPE が SNA でない場合は、NULL 値が入ります。 |
| SNA_MODE_NAME | VARCHAR(8) | ローカル・ロケーションとリモート・ロケーション間の通信に使用するモードの名前。 CONNECTION_TYPE が SNA でない場合は、NULL 値が入ります。 |
| SNA_LOCAL_LOCATION_NAME | VARCHAR(8) | RDB が存在するシステムに対してこのシステムが識別されるローカル・ロケーション名を示します。 CONNECTION_TYPE が SNA でない場合は、NULL 値が入ります。 |
| SNA_REMOTE_LOCATION_NAME | VARCHAR(8) | リモート・ファイルのあるリモート・ロケーションの名前。 CONNECTION_TYPE が SNA でない場合は、NULL 値が入ります。 |
| SNA_REMOTE_NETWORK_ID | VARCHAR(8) | RDB が存在するシステムのリモート・ネットワーク ID を示します。 CONNECTION_TYPE が SNA でない場合は、NULL 値が入ります。 |
SNA_TRANSACTION_PROGRAM_
名前 |
VARCHAR(19) | RDB ディレクトリー項目に指定されたトランザクション・プログラム名 (TPN) を示します。 値は、X'aabbcc' の形式の 16 進数ストリングとして戻されます。 CONNECTION_TYPE が SNA でない場合は、NULL 値が入ります。 |
| SSL | VARCHAR(3) | この接続が SSL を使用するかどうかを示します。
|
| THREE_PART_NAMING | VARCHAR(3) | この接続が、3 つの部分から成る名前を持つ SQL ステートメントを使用して確立されたかどうかを示します。
CONNECTION_USAGE が APPLICATION SERVER の場合は、NULL 値が入ります。 |
| XA | VARCHAR(3) | この接続が XA に使用されるかどうかを示します。
CONNECTION_USAGE が APPLICATION SERVER の場合は、NULL 値が入ります。 |
| ACTIVATION_GROUP_NUMBER | BIGINT | 接続を行うジョブの活動化グループ番号。 CONNECTION_USAGE が APPLICATION SERVER の場合は、NULL 値が入ります。 |
| ACTIVATION_GROUP_NAME | VARCHAR(10) | 接続を行うジョブの活動化グループ名。 活動化グループに名前がない場合、または CONNECTION_USAGE が APPLICATION SERVER である場合は、NULL 値が入ります。 |
| THREAD_ID | BIGINT | 接続用のスレッド ID。 CONNECTION_USAGE が APPLICATION SERVER の場合は、NULL 値が入ります。 |
| スコープ | VARCHAR(16) | 接続の有効範囲。
CONNECTION_USAGE が APPLICATION SERVER の場合は、NULL 値が入ります。 |
| COMMIT_PROTOCOL | VARCHAR(9) | この接続に使用されるコミットメント制御プロトコル。
CONNECTION_USAGE が APPLICATION SERVER の場合は、NULL 値が入ります。 |
| REMOTE_CLASS | VARCHAR(255) | リモート・サーバーのクラス。 一般的な値は以下のとおりです。
|
| REMOTE_RELEASE | VARCHAR(255) | リモート・サーバーのリリース・レベル。 |
| ERROR | VARCHAR(3) | 接続が現在エラー状態であるかどうかを示します。 例えば、通信障害が発生しました。
|
| サスペンド処理開始 |
TIMESTAMP |
このジョブの最新の Db2 Mirror 延期状態変更処理が開始されたときのタイム・スタンプ (協定世界時 (UTC))。 状態変更処理が完了しても、タイム・スタンプはクリアされません。 このジョブで前に中断状態の変更が発生していない場合は、NULL 値が入ります。 |
| suspend_処理終了 |
TIMESTAMP |
このジョブの最新の Db2 Mirror 延期状態変更処理が終了したときのタイム・スタンプ (協定世界時 (UTC))。 状態変更処理が完了しても、タイム・スタンプはクリアされません。 このジョブで前に中断状態の変更が発生していない場合は、NULL 値が入ります。 |
例
- 特定のジョブに対してアクティブなすべての接続をリストします。
SELECT * FROM TABLE (QSYS2.ACTIVE_DB_CONNECTIONS('900239/DBADMIN/QPADEV000F'));