Befehl 'mqsistartmsgflow'

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPSTMF anpassen und übergeben; weitere Informationen erhalten Sie unter Inhalt der Konfigurationsmanager-PDSE

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 Konfigurationsparameterdatei
(Optional) Dieser Parameter gibt den Namen der .configmgr-Datei an, in der die Verbindungsparameter für den Konfigurationsmanager definiert sind.
Es handelt sich dabei um eine XML-Datei im Format .configmgr, die von der Workbench gespeichert wird; z. B.:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr crlNameList="" domainName="" host="winmvsd0" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
Wenn Sie diese Datei unter z/OS verwenden, müssen Sie die Anweisung encoding="UTF-8" aus der ersten Zeile sowie den Wert für das Host-Attribut entfernen, damit die Anweisung wie folgt lautet:
<?xml version="1.0"?>
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
-i IP-Adresse
(Optional) Dieser Parameter gibt den Hostnamen oder die IP-Adresse des Konfigurationsmanagers an. Erfolgt keine Angabe, wird der Standardwert "" für eine Verbindung mit lokaler Bindung verwendet.
-p Port
(Optional) Dieser Parameter ist die Portnummer des Konfigurationsmanagers. Erfolgt keine Angabe, wird der Standardwert 1414 verwendet.
-q Warteschlangenmanager
(Optional) Dieser Parameter gibt den Namen des WebSphere MQ-Warteschlangenmanagers an, der vom Konfigurationsmanager verwendet wird. Erfolgt keine Angabe, wird der Standardwert "" verwendet.
-w Zeitlimit
(Optional) Dieser Parameter gibt die Zeit in Sekunden an, die das Dienstprogramm auf die erfolgreiche Ausführung des Befehlswartet; der Standardwert beträgt 60 Sekunden.
-v Tracedateiname
(Optional) Dieser Parameter sendet interne Debug-Trace-Informationen an die angegebene Datei.

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 Broker 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 Konfigurationsparameterdatei | ([-i IP-Adresse] [-p Port] [-q Warteschlangenmanager]))
 -b Brokername [-e Ausführungsgruppe [-m Nachrichtenfluss]] [-w Zeitlimit]
[-v Tracedateiname]
Befehlsoptionen:
'-n Konfigurationsparameterdatei' Datei (.configmgr) mit den Verbindungsparametern für den Konfigurationsmanager
'-i IP-Adresse' IP-Adresse oder Hostname des Konfigurationsmanagers
'-p Port' Portnummer des Konfigurationsmanagers
'-q Warteschlangenmanager' Warteschlangenmanager des Konfigurationsmanagers
'-b Brokername' Name des Brokers, in dem die Nachrichtenflüsse gestartet werden sollen
'-e Ausführungsgruppe' 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 Nachrichtenfluss' Name des Nachrichtenflusses, der gestartet werden soll. 
Falls dieser Parameter nicht angegeben wurde, werden alle Nachrichtenflüsse in der Ausführungsgruppe gestartet.
'-w Zeitlimit' Wartezeit (in Sekunden), bevor die Nachrichtenflüsse gestartet werden (Standardwert = 60)
'-v Tracedateiname' Sendet den ausführlichen internen Trace an die angegebene Datei.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an26100_