Befehl 'mqsistartmsgflow'

Unterstützte Plattformen

Zweck

Mit dem Befehl mqsistartmsgflow können Sie Nachrichtenflüsse starten.

Syntax

Parameter

-b Brokername
(Erforderlich) Name des Brokers, in dem die Nachrichtenflüsse gestartet werden sollen.

Werden die Parameter -e und -m nicht angegeben, werden alle Nachrichtenflüsse im Broker gestartet.

-e Ausführungsgruppe
(Optional) Name der Ausführungsgruppe, in der Nachrichtenflüsse gestartet werden.
-m Nachrichtenfluss
(Optional) Der Name des Nachrichtenflusses, der gestartet wird.

Sie können in einem Befehl nur jeweils einen Nachrichtenfluss angeben. Wird dieser Parameter nicht angegeben, werden alle Nachrichtenflüsse in der Ausführungsgruppe oder im Broker gestartet.

Bei Angabe dieses Parameters muss -e ebenfalls angegeben werden.

-n Datei_mit_Konfigurationsparametern
(Optional) Der Name der .configmgr-Datei, in der die Verbindungsparameter für den Konfigurationsmanager definiert sind.
Es handelt sich dabei um eine XML-Datei im Format .configmgr, die von der Eclipse-GUI gespeichert wird. Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Wenn Sie diese Datei unter z/OS verwenden, müssen Sie die Anweisung encoding="UTF-8" aus der ersten Zeile entfernen, damit die Anweisung wie folgt lautet:
<?xml version="1.0"?>
Außerdem müssen Sie den Wert für das Hostattribut entfernen, damit die Anweisung wie folgt lautet:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Anmerkung: Wenn Sie diesen Parameter nicht verwenden, müssen Sie die Parameter -i, -p und -q angeben.
-i IP-Adresse
(Optional) Der Hostname oder die IP-Adresse des Konfigurationsmanagers.

Wenn Sie diese Datei unter z/OS verwenden und eine Verbindung zum lokalen Host herstellen möchten, müssen Sie den Wert auf "" setzen.

-p Port
(Optional) Die Portnummer des Konfigurationsmanagers.
-q Warteschlangenmanager
(Optional) Der Name des WebSphere MQ-Warteschlangenmanagers, der vom Konfigurationsmanager verwendet wird.

Wenn Sie die Parameter -i, -p und -q nicht verwenden, müssen Sie den Parameter -n angeben.

-w Zeitlimit
(Optional) Die Zeit in Sekunden, die das Dienstprogramm auf die erfolgreiche Ausführung des Startbefehls wartet; der Standardwert beträgt 60 Sekunden.
-v Tracedateiname
(Optional) Mit diesem Parameter werden interne Tracedaten in die angegebene Datei geschrieben.

Autorisierung

Zum Starten von Nachrichtenflüssen benötigen Sie die entsprechenden Berechtigungen, die in der Zugriffssteuerungsliste (ACL) des Konfigurationsmanagers definiert sind.

Es sind dieselben Berechtigungen, wie sie zur Ausführung der entsprechenden Funktion im Message Brokers Toolkit benötigt werden. Eine Liste der Berechtigungen, die im Konfigurationsmanager definiert werden können, finden Sie unter ACL-Berechtigungen.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
0
(Success) Gibt die erfolgreiche Ausführung der Anforderung sowie den Status aller aktualisierten Nachrichtenflüsse an.
2
(Failure) Gibt an, dass mindestens ein Nachrichtenfluss aus irgendeinem Grund nicht den korrekten Status annehmen konnte.
98
Gibt an, dass keine Verbindung zum Konfigurationsmanager hergestellt werden konnte.
99
Gibt an, dass die an das Dienstprogramm übergebenen Argumente ungültig sind.

Beispiele

Es werden alle Nachrichtenflüsse im Broker B1 gestartet, der von dem Konfigurationsmanager gesteuert wird, dessen Verbindungsparameter in der Datei cm1.configmgr definiert sind. Die Steuerung wird an das aufrufende Programm zurückgegeben, wenn die Meldung erfolgt, dass alle Nachrichtenflüsse im Broker gestartet wurden, oder wenn die Standardwartezeit abgelaufen ist (je nachdem, was zuerst eintritt).

   mqsistartmsgflow –n cm1.configmgr –b B1

Es werden alle Nachrichtenflüsse im Broker B1 gestartet, der von dem Konfigurationsmanager gesteuert wird, dessen Verbindungsparameter in der Datei cm1.configmgr definiert sind. Die Steuerung wird an das aufrufende Programm zurückgegeben, wenn die Meldung erfolgt, dass alle Nachrichtenflüsse im Broker gestartet wurden, oder wenn zwei Minuten vorüber sind (je nachdem, was zuerst eintritt).

   mqsistartmsgflow –n cm1.configmgr –b B1 –w 120

Startet alle Nachrichtenflüsse im Broker B1, der vom Konfigurationsmanager gesteuert wird. Als Host des Konfigurationsmanager agiert der Warteschlangenmanager QM1, der sich auf dem lokalen Host 1414 befindet.

 mqsistartmsgflow –q QM1 –i localhost –p 1414 –b B1

Geben Sie den Befehl mqsistartmsgflow ein, um Verwendungshinweise anzuzeigen:

> mqsistartmsgflow
BIP1024I: Nachrichtenflüsse werden gestartet.

> Syntax:
mqsistartmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Befehlsoptionen:
'-n cfgParameterFileName' Datei (.configmgr) mit den Verbindungsparametern für den Konfigurationsmanager
'-i ipAddress' IP-Adresse oder Hostname des Konfigurationsmanagers
'-p port' Portnummer des Konfigurationsmanagers
'-q qMgr' Warteschlangenmanager des Konfigurationsmanagers
'-b brokerName' Name des Brokers, in dem die Nachrichtenflüsse gestartet werden sollen
'-e executionGroupName' Name der Ausführungsgruppe, in der die Nachrichtenflüsse gestartet werden sollen.
Falls dieser Parameter nicht angegeben wurde, werden alle Nachrichtenflüsse im Broker gestartet.
'-m flowName' Name des Nachrichtenflusses, der gestartet werden soll.
Falls dieser Parameter nicht angegeben wurde, werden alle Nachrichtenflüsse in der Ausführungsgruppe gestartet.
'-w timeoutValue' Wartezeit (in Sekunden), bevor die Nachrichtenflüsse gestartet werden (Standardwert = 60)
'-v traceFileName' Sendet den ausführlichen internen Trace an die angegebene Datei.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an26100_