ここで使用するフォーマットは XML ですが、インストールされているパーサーでサポートされる任意のフォーマットを使用することができます。
<TimeoutRequest>
<Action>SET | CANCEL</Action>
<Identifier>String (any alphanumeric string)</Identifier>
<StartDate>String (TODAY | yyyy-mm-dd)</StartDate>
<StartTime>String (NOW | hh:mm:ss)</StartTime>
<Interval>Integer (seconds)</Interval>
<Count>Integer (greater than 0 or -1)</Count>
<IgnoreMissed>TRUE | FALSE</IgnoreMissed>
<AllowOverwrite>TRUE | FALSE</AllowOverwrite>
</TimeoutRequest>
- Action
- このエレメントを SET または CANCEL のどちらかに設定します。
このエレメントを省略した場合や、異なる値に設定した場合、エラーが生成されます。
CANCEL に設定した場合、必須となる他のエレメントは ID だけであり、これは取り消される TimeoutRequest の ID と一致する必要があります。
- Identifier
- 英数字ストリングを入力します。
このエレメントを省略した場合、エラーが生成されます。
- StartDate
- このエレメントは、TODAY に設定するか、または yyyy-mm-dd 形式で指定される日付に設定します。
デフォルト値は TODAY です。
- StartTime
- このエレメントは、NOW に設定するか、または hh:mm:ss 形式で指定される時刻に設定します。
デフォルト値は NOW です。
StartTime は、ブローカーの現地時間であると想定されます。
- Interval
- このエレメントは、メッセージを伝搬する間隔を秒数で指定する整数に設定します。
デフォルト値は 0 です。
- Count
- このエレメントは、0 より大きい整数値に設定するか、または -1 (有効期限が切れないタイムアウト要求を指定する) に設定します。
デフォルト値は 1 です。
- IgnoreMissed
- このエレメントは、TRUE または FALSE に設定します。これは、ブローカーまたはタイムアウト通知フローの停止中に発生したタイムアウトを、ブローカーまたはタイムアウト通知フローが次に開始されるときに処理するかどうかを制御します。
デフォルト値は TRUE であり、これは実施されなかったタイムアウトがブローカーまたはメッセージ・フローの開始時に TimeoutNotification ノードによって無視されることを示します。
この値を FALSE に設定すると、実施されなかったタイムアウトはすべて、フローの開始時に TimeoutNotification ノードによって即時に処理されます。
保管されたタイムアウトをブローカーまたはタイムアウト通知フローの再始動の後も持続させるには、TimeoutControl ノードの「 要求の持続性 」プロパティーを「はい」または「自動」 (元の要求メッセージが持続するものである場合) に設定する必要があります。
- AllowOverwrite
- このエレメントは、TRUE または FALSE に設定します。これは、Identifier の一致する後続のタイムアウト要求がこのタイムアウト要求を上書きできるかどうかを指定します。
デフォルト値は TRUE です。
タイムアウト要求メッセージの定義済みスキーマ定義は、
ワークベンチに備わっています。
定義を検討したり、それをメッセージ・セット内に定義するには、以下のステップを行います。
- メッセージ・セットを含むメッセージ・セット・プロジェクトを作成または選択します。
- 新規のメッセージ定義ファイルを作成します (「メッセージ定義ファイルの作成元...」オプションを使用します)。
- 「IBM 提供メッセージ」を選択し、「次へ」をクリックします。
- 「メッセージ・ブローカーの IBM 提供メッセージ定義」のツリーを展開します。
- タイムアウト要求メッセージの項目を選択します。これは、6.0.0.1¥ibm¥nodes¥timeout¥timeoutrequest.xsd の形式で示されます。