Zeitlimitsteuerungsknoten

Dieses Thema enthält folgende Abschnitte:

Zweck

Der Zeitlimitsteuerungsknoten empfängt eine Eingabenachricht, die eine Zeitlimitanforderung enthält. Eine Beschreibung der Nachricht über eine Zeitlimitanforderung finden Sie unter Nachricht über eine Zeitlimitanforderung. Der Knoten prüft die Anforderung, speichert die Nachricht und gibt die (unveränderte) Nachricht an den nächsten Knoten im Nachrichtenfluss weiter.

Der Zeitlimitsteuerungsknoten wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für den Zeitlimitsteuerungsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Der Zeitlimitsteuerungsknoten und der Zeitlimitbenachrichtigungsknoten werden gemeinsam in einem Nachrichtenfluss für eine Anwendung verwendet, bei der Ereignisse zu einem bestimmten Zeitpunkt oder in regelmäßigen Abständen auftreten müssen.

Die folgenden Beispiele unterstützen Sie bei der Verwendung des Zeitlimitknotens in einem Nachrichtenfluss:
  1. Sie müssen jeden Tag um Mitternacht einen Stapeljob ausführen.
  2. Jede Stunde müssen Informationen zu Wechselkursen an Banken gesendet werden.
  3. Sie möchten bestätigen, dass wichtige Transaktionen innerhalb eines bestimmten Zeitraums verarbeitet werden, und Sie möchten andere angegebene Aktionen ausführen, um eine Warnung auszugeben, wenn eine Transaktion nicht innerhalb dieses Zeitraums verarbeitet wurde.

Jeder Zeitlimitbenachrichtigungsknoten kann mit mehreren Zeitlimitsteuerungsknoten paarweise verbunden sein. Zeitlimitanforderungen, die von diesen Zeitlimitsteuerungsknoten verarbeitet werden, werden alle von demselben Zeitlimitbenachrichtigungsknoten verarbeitet. Dieser Fall tritt ein, wenn für den Zeitlimitbenachrichtigungsknoten und die einzelnen Zeitlimitsteuerungsknoten eine identische eindeutige Kennung verwendet wird.

Ausführliche Informationen zur Verwendung der Knoten zur Verarbeitung der Zeitlimitüberschreitung finden Sie im Beispielprogramm 'Timeout Processing'.

Zeitlimitsteuerungsknoten konfigurieren

Wenn Sie eine Instanz des Zeitlimitsteuerungsknotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren.

Klicken Sie in der Editoransicht mit der rechten Maustaste auf den Knoten, und klicken Sie auf Eigenschaften. Daraufhin werden die Basiseigenschaften des Knotens angezeigt.

Die eindeutige Kennung ist die einzige obligatorische Eigenschaft. Sie besitzt keinen Standardwert.

Die Basiseigenschaften des Knotens werden wie folgt konfiguriert:

  • Geben Sie unter Eindeutige Kennung eine im Broker eindeutige Kennung an. Diese Kennung sollte mit der gleichen Eigenschaft in dem Zeitlimitbenachrichtigungsknoten übereinstimmen, mit dem sie paarweise verbunden ist. Die maximale Länge dieser Kennung beträgt 12 Zeichen.
  • Geben Sie unter Position anfordern die Position der Information zur Zeitlimitanforderung in der eingehenden Nachricht an. Diese Adresse kann sich an jeder beliebigen Stelle in der Baumstruktur für Eingabenachrichten befinden. Wenn Sie für diese Eigenschaft keinen Wert angeben, wird InputLocalEnvironment.TimeoutRequest übernommen. Eine Beschreibung der Nachricht über eine Zeitlimitanforderung finden Sie unter Nachricht über eine Zeitlimitanforderung.
  • Geben Sie für Permanenz anfordern einen Wert an. Durch diese Eigenschaft wird festgelegt, ob eingehende Zeitlimitanforderungen einen Neustart des Brokers oder Nachrichtenflusses, in dem der paarweise mit diesem Zeitlimitsteuerungsknoten verbundene Zeitlimitbenachrichtigungsknoten enthalten ist, überdauern. Geben Sie Ja an, wenn die eingehende Anforderung bestehen bleiben soll. Geben Sie andernfalls Nein an. Bei Angabe von Automatisch wird die Persistenzeinstellung im Ordner 'Eigenschaften' der eingehenden Nachricht verwendet. Automatisch ist der Standardwert dieser Eigenschaft.

Konfigurieren Sie jetzt die Nachrichteneigenschaft des Knotens:

  • Geben Sie unter Position für gespeicherte Nachricht die Position für den Teil der Anforderungsnachricht an, den Sie für die Übergabe durch den paarweise damit verbundenen Zeitlimitbenachrichtigungsknoten speichern möchten. Wenn Sie keinen Wert angeben, wird die gesamte Nachricht gespeichert. Sie können jede beliebige gültige Position in der Nachrichtenbaumstruktur angeben. Wenn Sie die gesamte Nachricht speichern möchten, müssen Sie unter Nachrichtendomäne, Nachrichtengruppe, Nachrichtenart oder Nachrichtenformat keine Werte angeben.
  • Wählen Sie unter Nachrichtendomäne aus der Dropdown-Liste den Namen des von Ihnen verwendeten Parsers aus. Beim erneuten Erstellen der gespeicherten Nachricht für die Übergabe wird dieser Wert zusammen mit den entsprechenden Werten unter Nachrichtengruppe, Nachrichtenart und Nachrichtenformat vom paarweise verbundenen Zeitlimitbenachrichtigungsknoten verwendet. Wenn Sie die gesamte Nachricht gespeichert haben, indem Sie das Feld Position für gespeicherte Nachricht leer gelassen haben, dürfen Sie hier keine Werte angeben. Wenn Sie Teile der Anforderungsnachricht speichern möchten, müssen Sie hier Werte angeben, durch die das gespeicherte Fragment der Anforderungsnachricht so wiedergegeben wird, wie wenn es sich dabei um die gesamte Nachricht handeln würde. Dies geschieht bei der Verarbeitung durch den Zeitlimitbenachrichtigungsknoten. Sie können einen der folgenden Namen auswählen:
    • MRM
    • XML
    • XMLNS
    • XMLNSC
    • JMSMap
    • JMSStream
    • MIME
    • BLOB (Binary large object)
    • IDOC
  • Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie die korrekte Nachrichtengruppe aus der Dropdown-Liste in Nachrichtengruppe.

    Lassen Sie bei XML-, XMLNS-, XMLNSC-, JMS-, MIME- und BLOB-Parsern das die Option Nachrichtengruppe leer.

  • Wenn Sie den MRM-Parser verwenden, wählen Sie aus der Dropdown-Liste unter Nachrichtenart den entsprechenden Nachrichtentyp aus. Diese Liste wird mit Nachrichten aufgefüllt, die in der von Ihnen ausgewählten Nachrichtengruppe definiert sind.

    Lassen Sie bei XML-, XMLNS-, XMLNSC-, JMS-, IDOC-, MIME- und BLOB-Parsern die Option Nachrichtenart leer.

  • Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie aus der Dropdown-Liste unter Nachrichtenformat das entsprechende Format der Nachricht aus. Diese Liste enthält alle physischen Formate, die Sie für diese Nachrichtengruppe definiert haben.

    Lassen Sie bei XML-, XMLNS, XMLNSC, JMS, MIME- und BLOB-Parsern die Option Nachrichtenformat leer.

Klicken Sie nach beendeter Konfiguration auf Übernehmen. Dadurch werden die Änderungen am Zeitlimitsteuerungsknoten vorgenommen, und der Eigenschaftendialog bleibt geöffnet. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Terminals und Eigenschaften

In der nachfolgenden Tabelle werden die Terminals des Zeitlimitsteuerungsknotens beschrieben.

Terminal Beschreibung
Eingangsterminal Eingabeterminal, das eine Nachrichtenbaumstruktur für die Verarbeitung akzeptiert (darin enthalten ist die Prüfung der Zeitlimitanforderung, die in der Nachrichtenbaumstruktur unter Position anfordern angegeben ist) und diese der Steuerwarteschlange hinzufügt.
Fehlerterminal Das Ausgabeterminal, an das die Eingabenachricht weitergegeben wird, wenn während der Verarbeitung in diesem Knoten ein Fehler auftritt. Wenn dieses Terminal nicht mit einem anderen Knoten verbunden ist, werden die Fehlerdaten wieder an den vorherigen Knoten im Nachrichtenfluss übergeben.
Ausgabe Das Ausgabeterminal, an das eingehende Nachrichten nach einer erfolgreichen Verarbeitung einer Zeitlimitanforderung unverändert weitergegeben werden. Wenn dieses Terminal nicht mit einem anderen Knoten verbunden ist, erfolgt keine Weitergabe. Wenn die Weitergabe der Nachricht fehlschlägt, wird die Nachricht an das Fehlerterminal weitergegeben.

In der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).

In der nachfolgenden Tabelle werden die Basiseigenschaften des Zeitlimitsteuerungsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Eindeutige Kennung Ja Ja Keine Dies ist die einzige obligatorische Eigenschaft für den Knoten. Ihr Wert muss im Broker eindeutig sein. Die entsprechende Eigenschaft des paarweise damit verbundenen Zeitlimitbenachrichtigungsknotens muss den gleichen Wert haben. Die maximale Länge dieser Kennung beträgt 12 Zeichen.
Position anfordern Nein Nein Keine Mit dieser Eigenschaft wird beschrieben, wo die Daten der Zeitlimitanforderung zu finden sind. Hierbei muss es sich um eine gültige Position in der Nachrichtenbaumstruktur handeln. Dieser Wert wird während der Laufzeit über eine Auswertung geprüft. Wurde keine Anforderungsposition angegeben, wird der Wert 'LocalEnvironment.TimeoutRequest' vorausgesetzt. Eine Beschreibung der Nachricht über eine Zeitlimitanforderung finden Sie unter Nachricht über eine Zeitlimitanforderung.
Permanenz anfordern Nein Nein Automatisch Durch diese Eigenschaft wird festgelegt, ob eine eingehende Zeitlimitanforderung den Neustart eines Brokers oder Nachrichtenflusses überdauert. Gültige Werte für diese Eigenschaft sind Automatisch, Ja oder Nein. Wenn für den Wert Automatisch festgelegt wurde, wird im Eigenschaftenordner der eingehenden Nachricht die Einstellung 'Permanenz' verwendet.

In der nachfolgenden Tabelle werden die Nachrichteneigenschaften des Zeitlimitsteuerungsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Position für gespeicherte Nachricht Nein Nein Keine Die Position für den Teil der Anforderungsnachricht, den Sie für die Übergabe durch den paarweise mit diesem Knoten verbundenen Zeitlimitbenachrichtigungsknoten speichern möchten.
Nachrichtendomäne Nein Nein Keine Die Domäne, die für die Syntaxanalyse der gespeicherten Nachricht zur Zeitlimitanforderung durch den Zeitlimitbenachrichtigungsknoten verwendet wird.
Nachrichtengruppe Nein Nein Keine Der Name oder die ID der Nachrichtengruppe, in der die gespeicherte Nachricht über eine Zeitlimitanforderung definiert ist.
Nachrichtenart Nein Nein Keine Der Name der gespeicherten Nachricht über eine Zeitlimitanforderung.
Nachrichtenformat Nein Nein Keine Der Name des physischen Formats der gespeicherten Nachricht über eine Zeitlimitanforderung.

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Zeitlimitsteuerungsknotens beschrieben.

Eigenschaft M C Standardwert Beschreibung
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.
Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac20800_