mqsistartmsgflow-Befehl

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

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

Sie können einen einzelnen Nachrichtenfluss oder alle Nachrichtenflüsse in einer Ausführungsgruppe auf einem angegebenen Broker starten. Sie müssen zuvor die Nachrichtenflüsse in einer BAR-Datei auf dem Broker implementiert haben.

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"/>

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

-i IP-Adresse
(Optional) Dieser Parameter gibt den Hostnamen oder die IP-Adresse des Konfigurationsmanagers an.

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

-p Port
(Optional) Dieser Parameter ist die Portnummer des Konfigurationsmanagers.
-q Warteschlangenmanager
(Optional) Dieser Parameter gibt den Namen des WebSphere MQ-Warteschlangenmanagers an, 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) 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

Auf allen Plattformen muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, über die entsprechende Berechtigung verfügen, die in der Zugriffssteuerungsliste definiert ist, die wiederum für den Konfigurationsmanager definiert ist. Die erforderlichen Berechtigungen sind dieselben wie für die Ausführung der entsprechenden Funktion in Message Brokers Toolkit.

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 den Befehl ü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.
Zugehörige Tasks
Implementieren
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Alle Rechte vorbehalten.
Letzte Aktualisierung : 2009-02-17 15:49:54

an26100_