MON_GET_QUEUE_STATS 表関数 - しきい値キュー統計を戻す

MON_GET_QUEUE_STATS 関数は、すべてのアクティブ・メンバーについて、 1 つまたはすべてのしきい値キューの基本統計を戻します。 この関数は、キューごとに 1 行の統計を戻します。

許可

次の権限のうち少なくとも 1 つが必要です。
  • ルーチンに対する EXECUTE 特権
  • DATAACCESS 権限
  • DBADM 権限
  • SQLADM 権限
  • WLMADM 権限

デフォルトの PUBLIC 特権

None.

構文

Read syntax diagramSkip visual syntax diagram MON_GET_QUEUE_STATS ( predicate , domain , threshold_name , threshold_id )

スキーマは SYSPROC です。

ルーチン・パラメーター

述部
統計を取得する対象のキューを指定する、タイプ VARCHAR(27) の入力引数。
CONCDBC
並行データベース・コーディネーター・アクティビティーしきい値キューの統計を取得します。
DBCONN
データベース・メンバー接続総数しきい値キューの統計を取得します。
SCCONN
サービス・クラス・メンバー接続総数しきい値キューの統計を取得します。
この引数が NULL または空ストリングである場合は、他の基準を満たすすべてのキューの統計が取得されます。

指定された値は、SYSCAT.THRESHOLDS ビューの THRESHOLDPREDICATE 列の値に対応します。

ドメイン
しきい値ドメインを指定する、タイプ VARCHAR (18) の入力引数。
DB
データベース。
SB
サービス・サブクラス。
SP
サービス・スーパークラス。
WA
ワーク・アクション・セット。
この引数が NULL または空ストリングである場合は、他の基準を満たすすべてのキューの統計が取得されます。

指定された値は、SYSCAT.THRESHOLDS ビューの DOMAIN 列の値に対応します。

しきい値名
統計を取得する特定のしきい値の名前を指定するタイプ VARCHAR (128) の入力引数。 指定された名は、SYSCAT.THRESHOLDS ビューの SYSCAT.THRESHOLDS 列の値に対応します。 この引数が NULL または空ストリングの場合、他の基準を満たすすべてのしきい値の統計が取得されます。
しきい値 ID
統計を取得する特定のしきい値の ID を指定するタイプ INTEGER の入力引数。 指定された ID は、SYSCAT.THRESHOLDS ビューの THRESHOLDID 列の値に対応します。 引数が NULL または -1の場合、他の基準を満たすすべてのしきい値の統計が取得されます。

戻される情報

表 1. MON_GET_QUEUE_STATS ルーチンによって戻される情報
列名 データ・タイプ 説明
THRESHOLD_PREDICATE VARCHAR(27) threshold_predicate しきい値述部 : モニター・エレメント
THRESHOLD_DOMAIN VARCHAR(18) threshold_domain しきい値ドメイン : モニター・エレメント
THRESHOLD_NAME VARCHAR(128) threshold_name しきい値名 : モニター・エレメント
THRESHOLD_ID INTEGER thresholdid しきい値 ID : モニター・エレメント
DBPARTITIONNUM SMALLINT dbpartitionnum - データベース・パーティション番号 : モニター・エレメント
SERVICE_SUPERCLASS_NAME VARCHAR(128) service_superclass_name サービス・スーパークラス名 : モニター・エレメント
SERVICE_SUBCLASS_NAME VARCHAR(128) service_subclass_name サービス・サブクラス名 : モニター・エレメント
WORK_ACTION_SET_NAME VARCHAR(128) work_action_set_name 作業アクション・セット名 : モニター・エレメント
WORK_CLASS_NAME VARCHAR(128) work_class_name 作業クラス名 : モニター・エレメント
WORKLOAD_NAME VARCHAR(128) workload_name ワークロード名 : モニター・エレメント
LAST_RESET TIMESTAMP last_reset 最後のリセット・タイム・スタンプ : モニター・エレメント
QUEUE_SIZE_TOP INTEGER queue_size_top キュー・サイズの最上位 : モニター・エレメント
QUEUE_TIME_TOTAL BIGINT queue_time_total キュー時間の合計 : モニター・エレメント
QUEUE_ASSIGNMENTS_TOTAL BIGINT queue_assignments_total キュー割り当ての合計 : モニター・エレメント
QUEUE_SIZE_CURRENT INTEGER キュー内の接続またはアクティビティーの数。
QUEUE_TIME_LATEST BIGINT 最後の接続またはアクティビティーがキューをそのままにしておくためにキューで費やした時間。 単位はミリ秒です。
QUEUE_EXIT_TIME_LATEST TIMESTAMP 最後の接続またはアクティビティーがキューをそのままにしておいた時間。
THRESHOLD_CURRENT_CONCURRENCY INTEGER しきい値に従って現在実行中の接続またはアクティビティーの数。
THRESHOLD_MAX_CONCURRENCY INTEGER しきい値によって現在実行中の接続またはアクティビティーの最大数。
メンバー SMALLINT member - データベース・メンバー・モニター・エレメント

使用上の注意

この関数は、(1 つ以上のキューの) メンバー全体のデータ集約は行いません。 ただし、例で示された SQL 照会を使用すると、データを集約することができます。

例

  • 以下の照会は、システム上のすべてのキューの基本統計を、すべてのメンバーにわたって表示します。
      SELECT substr(THRESHOLD_NAME, 1, 6) THRESHNAME,
       THRESHOLD_PREDICATE,
       THRESHOLD_DOMAIN,
       MEMBER MEMB,
       QUEUE_SIZE_TOP,
       QUEUE_TIME_TOTAL,
       QUEUE_ASSIGNMENTS_TOTAL QUEUE_ASSIGN 
  FROM table(MON_GET_QUEUE_STATS('', '', '', -1)) as QSTATS
    出力例:
    THRESHNAME THRESHOLD_PREDICATE         THRESHOLD_DOMAIN   MEMB QUEUE_SIZE_TOP QUEUE_TIME_TOTAL QUEUE_ASSIGN
---------- --------------------------- ------------------ ---- -------------- ---------------- ------------
LIMIT1     CONCDBC                     DB                    0             12          1238540          734
LIMIT2     SCCONN                      SP                    0              4           741249           24
LIMIT3     DBCONN                      DB                    0              7           412785          128