システム・モニター 手引きおよび解説書
SET EVENT MONITOR STATE ステートメントは、イベント・モニターを活動化、
または非活動化します。 イベント・モニターの現行の状態
(活動状態または非活動状態) を、 EVENT_MON_STATE
組み込み関数を使用して判別できます。 SET EVENT MONITOR STATE
ステートメントは、トランザクションの制御下にはありません。
効力範囲
このステートメントはアプリケーション・プログラムに組み込むこともできますし、
あるいは動的 SQL ステートメントを使って発行することもできます。
このステートメントは、動的に準備できる実行可能ステートメントです。 ただし、 バインド・オプション DYNAMICRULES BIND が適用されると、
このステートメントは動的に準備できません (SQLSTATE 42509)。
許可
このステートメントの許可 ID は、 少なくとも SYSADM または DBADM
権限を保持している必要があります (SQLSTATE 42815)。
コマンド構文
>>-SET--EVENT--MONITOR--event-monitor-name--STATE--------------->
.-=-.
>----+---+--+-0-------------+----------------------------------><
+-1-------------+
'-host-variable-'
コマンド・パラメーター
- event-monitor-name
- 活動化、または非活動化するイベント・モニターを指定します。
この名前は、カタログ (SQLSTATE 42704)
の中に存在しているイベント・モニターを指定するものでなければなりません。
- new-state
- new-state は整数定数で指定することも、
実行時に適切な値が入るホスト変数の名前で指定することもできます。
以下のものを指定できます。
- 0
- 指定したイベント・モニターを非活動化することを示します。
- 1
- 指定したイベント・モニターを活動化することを示します。
イベント・モニターは活動状態になっていてはなりません。 そうでないと、警告
(SQLSTATE 01598) が出されます。
- host-variable
- データ・タイプは INTEGER です。 指定する値は 0 か 1 でなければなりません
(SQLSTATE 42815)。 host-variable が関連する標識変数を持つ場合、
その標識変数はヌル値 (SQLSTATE 42815) を示すものであってはなりません。
サンプル・プログラム
- 定義できるイベント・モニターの数には制限がありませんが、
同時に活動状態にできるイベント・モニターの数は 32 に制限されています (SQLSTATE
54030)。
- イベント・モニターを活動化させるためには、
イベント・モニターが作成されたトランザクションはコミットされていなければなりません
(SQLSTATE 55033)。 この規則により、(1 つの作業単位の中で)
イベント・モニターを作成し、 モニターを活動化した後で、
トランザクションのロールバックを行うということを避けることができます。
- イベント・モニター・ファイルの数またはサイズが、 CREATE EVENT MONITOR
ステートメントの MAXFILES または MAXFILESIZE に指定されている値を超過すると、
エラー (SQLSTATE 54031) が生じます。
- イベント・モニターの宛先パス (CREATE EVENT MONITOR
ステートメントで指定されている)
がすでに別のイベント・モニターで使用されている場合、 エラー (SQLSTATE 51026)
が生じます。
使用上の注意
- イベント・モニターを活動化すると、
このイベント・モニターに関連したカウンターがすべてリセットされます。
次の例では、SMITHPAY というイベント・モニターが活動化されます。
SET EVENT MONITOR SMITHPAY STATE = 1
[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]