DEFINE COMPOSITE EVENT

説明

DEFINE COMPOSITE EVENT は、BTS に複合イベントを定義します。 複合イベントは、サブイベントと呼ばれるゼロ個以上のアトミック・イベントで構成されます。

DEFINE COMPOSITE EVENT は、サブイベントを含む論理式である述部 を定義します。 複合イベントの発生状況 (FIRED または NOTFIRED) は常にこの述部の値を反映します。 述部が真になると複合イベントが発生します。偽になると複合イベントの発生状況は NOTFIRED に戻ります。

複合イベントの述部のサブイベントに適用される論理演算子は、ブール演算子 AND または OR のいずれかです。 AND および OR を両方とも使用することはできません。

複合イベントが作成されたときにそれに追加されるサブイベントは、最大 8 つまで指定できます。 サブイベントを指定しない場合、複合イベントは 空 (つまり、サブイベントを含まない) として定義されます。

複合イベントが定義された後にその複合イベントにサブイベントを追加するには、ADD SUBEVENT コマンドを使用します。 ADD SUBEVENT を使用して追加できるサブイベントの数に制限はありません。

複合イベントからサブイベントを除去するには、REMOVE SUBEVENT コマンドを使用します。

オプション

AND

この複合イベントの述部に関連付けられるブール演算子が AND であることを指定します。 つまり、複合イベントは、そのサブイベントがすべて 発生した場合に発生します。

注: AND 演算子を使用する空の複合イベントの発生状況は、常に FIRED (true) です。

EVENT(data-value)

定義する複合イベントの名前 (1 から 16 文字) を指定します。 許容文字は A-Z a-z 0-9 $@ # です。 -および _. 先行ブランク文字と埋め込みブランク文字は許可されません。 指定された名前が 16 文字よりも短い場合は、16 文字になるまで末尾にブランクが埋め込まれます。

または

この複合イベントの述部に関連付けられるブール演算子が OR であることを指定します。 つまり、複合イベントは、そのサブイベントのいずれか が発生した場合に発生します。

注: OR 演算子を使用する空の複合イベントの発生状況は、常に NOTFIRED (false) です。

SUBEVENTn(data-value)

コンポジットの作成時に複合イベントに追加するサブイベントの名前 (1 から 16 文字) を指定します。 許容文字は A-Z a-z 0-9 $@ # です。 -および _. 先行ブランク文字と埋め込みブランク文字は許可されません。 指定された名前が 16 文字よりも短い場合は、16 文字になるまで末尾にブランクが埋め込まれます。

このオプションは 8 回まで指定できます。n は 1 から 8 の範囲内である必要があります。

指定するサブイベントは、DEFINE INPUT EVENT、DEFINE ACTIVITY、または DEFINE TIMER コマンドによって、現行アクティビティーにあらかじめ定義されている必要があります。 それらのサブイベントは、既存の複合イベントのサブイベントであってはいけません。

条件

111 EVENTERR

RESP2 値:

6

EVENT オプションで指定されているイベント名が無効です。

7

EVENT オプションで指定されているイベント名は、すでにこのアクティビティーに定義されています。

21 から 28

SUBEVENTn オプションで指定されているサブイベントのうちの 1 つ以上が存在していません。 RESP2 の値は、存在していない最初のサブイベントを示しています。

16 INVREQ

RESP2 値:

1

コマンドがアクティビティーの有効範囲外で発行されました。

31 から 38

SUBEVENTn オプションで指定されているサブイベント名のうちの 1 つ以上が無効です。 RESP2 値は、最初の無効なサブイベント名を示しています。