MQ-Aktivität 'Nachricht senden'

Mithilfe der MQ-Aktivität Nachricht senden wird während der Ausführung eine Nachricht an die angegebene Warteschlange gesendet.

Anmerkung: Sie müssen einen Endpunkt für die MQ-Aktivität erstellt haben, bevor die Aktivität konfiguriert werden kann.
Die Task Konfigurieren hat drei Abschnitte:

Nach der Ausführung der Tasks Konfigurieren führen Sie die in Eingaben zuordnen beschriebenen Schritte für die Aktivität aus.

Anmerkung: Die maximale Nachrichtengröße beträgt 100 MB.

Details der Warteschlange und der Nachricht

Geben Sie die Details der Warteschlange und der Nachricht in den Feldern an, die in der nachfolgenden Tabelle beschrieben werden. Erforderliche Felder sind mit einem Stern gekennzeichnet.
Feld Beschreibung
Name der Warteschlange * Gibt den Namen der Warteschlange an, in die die Nachrichten eingereiht werden.
Datentyp der Nutzdaten Gibt den Datentyp der Nachrichtennutzdaten (Binär oder Zeichenfolge) an.
Nachrichtentyp Datagramm - Wählen Sie diese Option aus, wenn die Nachricht gesendet werden soll und keine Antwort benötigt wird.

Anforderung - Wählen Sie diese Option aus, wenn die Nachricht eine Antwort erhalten soll. Stellen Sie sicher, dass die Eigenschaft 'An Warteschlange antworten' für Anforderungsnachrichten definiert wird.

Antwort - Wählen Sie diese Option aus, wenn die Nachricht eine Antwort auf eine vorherige Anforderung ist.

An Warteschlange antworten Gibt die Warteschlange an, an die die Antwort für Anforderungsnachrichten gesendet werden soll.
An Warteschlangenmanager antworten Gibt den Namen des Warteschlangenmanagers an, zu dem die Warteschlange (die im Feld An Warteschlange antworten angegeben ist) gehört.
Persistent
  • Wahr - Nachrichten werden in Warteschlangen wiederhergestellt, wenn der Warteschlangenmanager ausfällt.
  • Falsch - Nachrichten können aus der Warteschlange verloren gehen, wenn der Warteschlangenmanager ausfällt.
  • Standard - Nachrichten verwenden die Persistenzeinstellung für die Warteschlange (dies ist die Standardeinstellung).
Priorität Gibt die Priorität der Nachricht an.Standardmäßig nimmt die Nachrichtenpriorität den Standardwert für die Priorität der Warteschlange an. Wenn die Warteschlange Prioritäten zum Ordnen von Nachrichten verwendet und diese Nachricht eine bestimmte festgelegte Priorität haben sollte, wählen Sie Angeben aus und geben die Priorität ein. Prioritäten können Werte aus dem Bereich von 1 (niedrigste Priorität) bis 9 (höchste Priorität) haben.
Anmerkung: Die Priorität sollte den maximalen Prioritätswert, der für die MQ-Warteschlange festgelegt ist, nicht überschreiten. Überprüfen Sie diese Information bei Ihrem MQ-Systemadministrator.
Ablaufzeit der Nachricht Die Dauer (in Sekunden), die die Nachrichten in der Warteschlange verbleiben, bevor sie ablaufen. Der Standardwert ist Nie, sodass sichergestellt ist, dass die Nachricht zugestellt wird und in der Warteschlange wartet, bis sie abgerufen wird, unabhängig davon, wie lange dies dauert.

Wenn Nachrichten für diese Warteschlange ablaufen und nach einer bestimmten Dauer verworfen werden sollen, wählen Sie Angeben aus und geben die maximale Anzahl Sekunden ein, die die Nachricht in der Warteschlange behalten werden soll.

Schemafragment für MQRFH2-Header Gibt an, ob ein MQRFH2-Header in die Nachricht eingeschlossen ist. Wenn die Nachricht eine XML-Nachricht ist und einen MQRFH2-Header einschließt, wählen Sie dieses Kontrollkästchen aus und klicken auf [...]. Suchen Sie im Dialogfenster Nach Schematypelement suchen das XML-Schema heraus, das den Header definiert, wählen Sie das Element 'NameValueData' in diesem XML-Schema aus und klicken Sie auf OK. Das Schemafragment ist das Element 'NameValueData' mit allen seinen untergeordneten Elementen.
Anmerkung: Das XML-Schema, das den Header definiert, muss zunächst erstellt und in das Projekt geladen werden, bevor es ausgewählt werden kann. Weitere Informationen finden Sie in XML-Schema für einen MQRFH2-Header definieren und laden.

Zustellregeln

Feld Beschreibung
Nachrichten zustellen Die folgenden Optionen sind hier verfügbar:
  • Mindestens einmal: Gibt an, dass die Nachricht mindestens einmal zugestellt wird, jedoch mehrmals zugestellt werden kann. Verbindungsfehler oder Fehler der Integrationseinheit können dazu führen, dass Nachrichten mehrmals abgerufen und verarbeitet werden. Diese Zustelloption wird in der Regel dann verwendet, wenn das empfangende System doppelte Nachrichten erkennen oder tolerieren kann.
  • Höchstens einmal: Gibt an, dass die Nachricht nur einmal oder keinmal zugestellt wird. Verbindungsfehler oder Fehler der Integrationseinheit können dazu führen, dass Nachrichten verloren gehen. Diese Zustelloption wird in der Regel dann verwendet, wenn das empfangende System keine doppelten Nachrichten, jedoch verlorene Nachrichten tolerieren kann.

Wiederholungsoptionen

Konfigurieren Sie die Wiederholungsoptionen für das Herstellen einer Verbindung zu einem MQ Server. In der folgenden Tabelle werden die Wiederholungsoptionen für die Verbindung zu einem MQ Server beschrieben:

Wiederholungsoptionen Beschreibung
1) ___ Sekunden zwischen den einzelnen Wiederholungen warten. Die Dauer (in Sekunden), die die Integrationseinheit wartet, bevor sie erneut versucht, den Warteschlangenmanager zu kontaktieren, um eine Nachricht an den MQ Server zu senden.
2) Verbindungsherstellung ___ mal versuchen, bevor ein Fehler zurückgegeben wird. Gibt die maximale Anzahl der Male an, die die Integrationseinheit versucht, den Warteschlangenmanager zu kontaktieren, um eine Nachricht an den MQ Server zu senden, bevor sie einen Fehler ausgibt und die Verarbeitung des aktuellen Orchestrierungsjobs stoppt.

Wenn Sie eine Orchestrierung implementieren, die eine MQ-Aktivität Nachricht senden enthält, und die Integrationseinheit keine Verbindung zum Warteschlangenmanager des angegebenen MQ Server herstellen kann, protokolliert die Integrationseinheit die Fehler als Warnungen im System- und Orchestrierungsprotokoll, bis die maximale Wiederholungsanzahl erreicht wird. Wenn die Wiederholungsanzahl erreicht wird, protokolliert die Integrationseinheit einen Fehler im System- und Orchestrierungsprotokoll und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

Wenn Sie zum Beispiel die Wiederholungsanzahl auf den Wert 3 setzen, werden der erste, zweite und dritte Verbindungsfehler als Warnung im Systemprotokoll aufgezeichnet. Die Integrationseinheit protokolliert den vierten Fehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

Eingaben zuordnen

Sie müssen Eingabeparameter für diese Aktivität zuordnen. Die folgenden Parameter sind erforderlich und müssen zugeordnet werden, damit die Konfiguration vollständig ist. Alle anderen Parameter sind optional. Weitere Informationen finden Sie in Zuordnung erstellen.
Erforderliche Eingabeparameter:
payload (Nutzdaten)

Zum Anzeigen der optionalen Eingabeparameter im Fenster An Aktivität des Fensters Eingaben zuordnen wählen Sie die Optionen Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü aus oder klicken mit der rechten Maustaste in das Fenster An Aktivität und wählen die Option Optionale Parameter anzeigen aus. Wenn die Option Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü nicht auswählbar ist, klicken Sie auf einen Knoten im Fenster Eingaben zuordnen, um diese Option zu aktivieren.