MON_GET_CF_WAIT_TIME 表関数 - クラスター・キャッシング・ファシリティー・コマンドの待ち時間の取得

MON_GET_CF_WAIT_TIME 表関数は、クラスター・キャッシング・ファシリティー (CF) コマンドの合計時間測定を戻します。

この機能によって返される時間測定には、 CF との間のネットワーク・トランスポート時間と、 CF内のコマンドの実行時間が含まれます。

許可

このルーチンを実行するには、以下のいずれかの権限が必要です。

ルーチンに対する EXECUTE 特権
DATAACCESS 権限
DBADM 権限
SQLADM 権限

デフォルトの PUBLIC 特権

なし

構文

表関数パラメーター

スキーマは SYSPROC です。

member: 現在接続しているデータベースと同じインスタンス内の有効なメンバーを指定する、タイプ INTEGER の入力引数。現在のデータベース・メンバーの場合は -1、すべてのアクティブ・メンバーの場合は -2 を指定します。 NULL 値を指定した場合は、-1 が暗黙的に設定されます。

戻される情報

表 1. MON_GET_CF_WAIT_TIME 関数で戻される情報
列名	データ・タイプ	説明または対応するモニター・エレメント
メンバー	SMALLINT	member - データベース・メンバー
HOSTNAME	VARCHAR(255)	hostname - ホスト名 : モニター・エレメント
ID	SMALLINT	ID-識別
CF_CMD_NAME	VARCHAR(128)	CF コマンドの名前。
TOTAL_CF_REQUESTS	BIGINT	このコマンドに対する CF 内の要求の総数。
TOTAL_CF_WAIT_TIME_MICRO	BIGINT	このコマンドの CF での合計待ち時間 (マイクロ秒単位)。

表 2. MON_GET_CF_WAIT_TIME 関数によってモニターされる CF コマンドのリスト
CF コマンド名または別名	説明
DeletePage	CFからページを削除します。
DeletePageList	CFからページのリストを削除します。
DeleteSA	CF内のスマート・アレイ (SA) から項目を削除します。
DeleteSAList	CF内の SA から項目のリストを削除します。
DeregisterPage	CFからページの登録を取り消します。
DeregisterPageList	CFからページのリストを登録解除します。
GetAndIncLFS	CF内のログ・フラッシュ・シーケンス (LFS) 番号を取得して増分します。
GetLFS	CFから LFS を取得します。
GetLSN	CFからログ・シーケンス番号 (LSN) を取得します。
GetNotification	CF内のグローバル・ロック・マネージャー (GLM) から通知メッセージを取得するために発行されたコマンドを返します。
GetStatus	CFからユーザー制御構造フィールドを取得します。
GetUDF	ユーザー・データ・フィールドを使用して、 CF から最も古いページを取得します。
GLMDump	CFから GLM 構造のダンプを要求します。
InitNotify	CF内の GLM 構造からメッセージ通知を初期化するために発行されたコマンドを返します。
MemberUD	CFのメンバーごとのユーザー・データ・フィールドにアクセスします。
ReadAndRegister \| RAR	CFから単一ページを読み取ります。
ReadAndRegisterMultiple \| RARM	CFから複数ページを読み取ります。
ReadCastoutClass	CFからキャストアウトできるキャストアウト・クラス内のページのリストを読み取ります。
ReadCCInfo	CFから、キャストアウト・クラスの範囲に関するキャストアウト情報を読み取ります。
ReadForCastout	CF からデータを読み取って、キャストアウトできるようにします。
ReadForCastoutMultiple	CF 内のキャストアウト・キューをスキャンして、適格な項目を探します。このコマンドは、ReadCastoutClass コマンドと ReadForCastout コマンドの組み合わせです。
ReadForCastoutMultipleList	CF 内のキャストアウト・キューをスキャンして、適格な項目を探します。このコマンドは、指定されたリストに対する ReadCastoutClass コマンドと ReadForCastout コマンドの組み合わせです。
ReadLocks	CFの GLM 構造に定義されているロックを読み取ります。
ReadSA	CF内の SA からアグリゲート値を読み取ります。
ReadSAList	CF内のすべての SA 変数または特定の SA 変数のすべての値を読み取ります。
ReleaseCastoutLocks	CF内のページのキャストアウト・ロックを解放します。
RecordLockState \| RLS	ロック状態を 2 次 CFに記録します。
RecordLockStateAsync	ロック状態を 2 次 CFに非同期で記録します。
RecordLockStateMultiple \| RLSN	複数のロック状態を 2 次 CFに記録します。
RegisterPageList	ページのリストを CFに登録します。
SetLFS	CFで LFS 番号を設定します。
SetLSN	CFで LSN を設定します。
SetLockState \| SLS	ロック状態を CFに設定します。
SetLockStateAsync	ロック状態を CFに非同期で設定します。
SetLockStateMultiple \| SLSN	複数のロック状態を CFに設定します。
SetLockStateMultipleAsync	CFに対して複数のロック状態を非同期に設定します。
SetStatus	CFのユーザー制御構造フィールドを設定します。
TestPageValidity	ローカル・ページが CFで有効かどうかをテストします。
TryInstant	CFからインスタント・ロックを取得するために発行されたコマンドを返します。
WriteAndRegister \| WAR	単一ページ・イメージを CFに送信します。
WriteAndRegisterMultiple \| WARM	複数ページのイメージを CFに送信します。
WriteSA	SA に値を書き込み、 CF内のアグリゲート値を取得します。
WriteSAList	CFに 1 つ以上の SA 変数を書き込みます。

使用上の注意

Db2® pureScale® 環境でこの関数を発行した場合にのみ、データが返されます。

この表関数は、コマンドごとおよびメンバーごとに 1 行のデータを戻します。

値はメンバーのインスタンス・レベルで提供され、メンバーがインスタンス・レベルで CF に接続されているため、メンバーに対してアクティブなデータベースの数には依存しません。

戻り列の TOTAL_CF_REQUESTS と TOTAL_CF_WAIT_TIME_MICRO で戻される値は、クラスターの開始以降に計算されます。値を再設定することはできません。これらは読み取り専用です。

TOTAL_CF_WAIT_TIME_MICRO 列の戻り値を TOTAL_CF_REQUESTS 列で戻される数値で除算することにより、平均時間を計算できます。

例

特定の CF( db2nodes.cfg ファイルで番号 128 として識別される) でページ登録解除が発生する率を調べるには、特定の時間の長さの値を比較する必要があります。開始するには、次のステートメントを発行します。

SELECT TOTAL_CF_WAIT_TIME_MICRO AS DEREG_T1,
   TOTAL_CF_REQUESTS AS DEREG_RQ1
   FROM TABLE (MON_GET_CF_WAIT_TIME( -1 ))
   WHERE CF_CMD_NAME = 'DeregisterPage' and ID = '128'

この照会は、比較の初期値を戻します。その後、 CF が追加ページを登録解除するまで 10 秒待ちます。

更新された値を取得するには、次のステートメントを発行します。

SELECT TOTAL_CF_WAIT_TIME_MICRO AS DEREG_T2,
   TOTAL_CF_REQUESTS AS DEREG_RQ2
   FROM TABLE (MON_GET_CF_WAIT_TIME( -1 ))
   WHERE CF_CMD_NAME = 'DeregisterPage' and ID = '128'

最後に、以下の数式を使用して、 CF がページを登録解除する速度を計算します。

                  (DEREG_RQ2 - DEREG_RQ1)
DEREG_PAGE_RATE = -----------------------
                   (DEREG_T2 - DEREG_T1)