システム・モニター 手引きおよび解説書

SET EVENT MONITOR STATE

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) を示すものであってはなりません。

サンプル・プログラム

使用上の注意

次の例では、SMITHPAY というイベント・モニターが活動化されます。

      SET EVENT MONITOR SMITHPAY STATE = 1


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]