In diesem Abschnitt wird erläutert, wie eine Nachricht über eine Zeitlimitüberschreitung bei Anforderung erstellt wird.
In diesem Beispiel wird das Format XML verwendet. Sie können jedoch auch jedes andere von einem installierten Parser unterstützte Format verwenden.
<TimeoutRequest>
<Action>SET | CANCEL</Action>
<Identifier>String (beliebige alphanumerische Zeichenfolge)</Identifier>
<StartDate>String (TODAY | yyyy-mm-dd)</StartDate>
<StartTime>String (NOW | hh:mm:ss)</StartTime>
<Interval>Integer (Sekunden)</Interval>
<Count>Integer (größer als 0 oder -1)</Count>
<IgnoreMissed>TRUE | FALSE</IgnoreMissed>
<AllowOverwrite>TRUE | FALSE</AllowOverwrite>
</TimeoutRequest>
- Action
- Legen Sie für dieses Element SET (Festlegen) oder CANCEL (Abbrechen) fest. Wenn Sie dieses Element übergehen oder einen anderen Wert festlegen, wird ein Fehler generiert. Wenn CANCEL festgelegt wird, wird nur noch die ID (Identifier) benötigt. Diese muss mit der ID der Zeitlimitüberschreitung bei Anforderung (TimeoutRequest) übereinstimmen, die abgebrochen werden soll.
- Identifier
- Geben Sie eine alphanumerische Zeichenfolge ein. Wenn Sie dieses Element übergehen, wird ein Fehler generiert.
- StartDate
- Legen Sie für dieses Element TODAY (Heute) oder ein Datum im Format JJJJ-MM-TT fest.
Der Standardwert ist TODAY.
- StartTime
- Legen Sie für dieses Element NOW (Jetzt) oder einen Zeitpunkt im Format hh:mm:ss fest. Der Standardwert ist NOW. StartTime wird als Ortszeit des Brokers betrachtet.
- Interval
- Legen Sie für dieses Element eine ganze Zahl fest, durch die die Anzahl der Sekunden zwischen den Weitergaben der Nachricht angegeben wird. Der Standardwert ist 0.
- Count
- Legen Sie für dieses Element einen ganzzahligen Wert größer O oder gleich -1 fest (hierdurch wird eine Zeitlimitüberschreitung bei Anforderung angegeben, die nie abläuft). Der Standardwert ist 1.
- IgnoreMissed
- Legen Sie für dieses Element TRUE (Wahr) oder FALSE (Falsch) fest, und steuern Sie damit, ob Zeitlimitüberschreitungen beim Stoppen des Brokers oder des Zeitlimitbenachrichtigungsflusses beim nächsten Start des Brokers bzw. des Zeitlimitbenachrichtigungsflusses verarbeitet werden. Der Standardwert ist TRUE. Bei dieser Einstellung werden verpasste Zeitlimitüberschreitungen vom TimeoutNotification-Knoten ignoriert, wenn der Broker oder der Nachrichtenfluss gestartet wird. Bei einem Wert FALSE werden die verpassten Zeitlimitüberschreitungen umgehend vom TimeoutNotification-Knoten verarbeitet, wenn der Nachrichtenfluss gestartet wird.
Die gespeicherten Zeitlimitüberschreitungen bleiben nur dann nach dem erneuten Start des Brokers oder des Zeitlimitbenachrichtigungsflusses bestehen, wenn Sie für die Eigenschaft Anforderungspersistenz des TimeoutControl-Knotens Ja oder Automatisch (wobei die ursprüngliche Anforderungsnachricht permanent ist) festlegen.
- AllowOverwrite
- Legen Sie für dieses Element TRUE oder FALSE fest, und geben Sie damit an, ob die aktuelle Zeitlimitüberschreitung bei Anforderung durch nachfolgende Zeitlimitüberschreitungen bei Anforderung mit übereinstimmendem Identifier überschrieben werden kann. Der Standardwert ist TRUE.
In der
Workbench wird eine vordefinierte Schemadefinition der Zeitlimitüberschreitung bei Anforderung bereitgestellt. Gehen Sie wie folgt vor, um die Definition zu prüfen bzw. in einer Nachrichtengruppe zu definieren:
- Erstellen Sie ein Nachrichtengruppenprojekt mit der Nachrichtengruppe, oder wählen Sie eines aus.
- Erstellen Sie eine neue Nachrichtendefinitionsdatei. (Verwenden Sie hierfür die Option Nachrichtendefinitionsdatei aus....)
- Wählen Sie IBM eigene Nachricht aus, und klicken Sie auf Nächste.
- Erweitern Sie die Baumstruktur für Nachrichtenbroker - Nachrichtendefinitionen von IBM.
- Wählen Sie den Eintrag für die Nachricht über die Zeitlimitüberschreitung bei Anforderung im Format 6.0.0.1\ibm\nodes\timeout\timeoutrequest.xsd aus.