mqsimode-Befehl

Mit dem Befehl mqsimode können Sie Betriebsmodus-Informationen konfigurieren und abrufen.

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Plattformen
  • Beginn der Änderungz/OS. Führen Sie diesen Befehl aus, indem Sie BIPMODE anpassen und übergeben. Weitere Informationen finden Sie im Abschnitt Inhalt der Broker-PDSEEnde der Änderung

Zweck

Mit dem Befehl mqsimode können Sie den Betriebsmodus eines Brokers ändern oder Informationen zu dem Modus abrufen, in dem der Broker gerade arbeitet.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsimode--| brokerSpec |--+---------------------+------------>
                             '- -o --Betriebsmodus-'   

>--+--------------------+--+----------------------+------------->
   '- -w --ZeitlimitSek-'  '- -v --Tracedateiname-'   

>--+--------------------------+--------------------------------><
   '- -x --Moduserweiterungen-'   

brokerSpec

|--+- Brokername -----------------+-----------------------------|
   +- -n --Brokerdateiname--------+   
   | .--------------------------. |   
   | V                          | |   
   '-----+- -i --IP-Adresse-+---+-'   
         +- -p --Port-------+         
         '- -q --WS-Manager-'         

Parameters

brokerSpec
(Erforderlich) Zur Identifizierung des Zielbrokers müssen Sie für diesen Befehl mindestens einen Parameter in einer der folgenden Formen angeben:
Brokername
Dieser Parameter gibt den Namen eines lokal definierten Brokers an. Diese Option kann nicht verwendet werden, wenn sich der Broker auf einem fernen Computer befindet.
-n Brokerdateiname
Dieser Parameter gibt den Namen einer Datei an, welche die Verbindungsdetails für einen lokalen oder fernen Broker enthält.

Verwenden Sie diese Option, wenn sich mehrere Benutzer mit demselben Broker verbinden möchten, oder wenn Sie erweiterte Verbindungsparameter wie beispielsweise SSL verwenden.

Klicken Sie zur Erstellung dieser Datei mit der rechten Maustaste auf den Broker imWebSphere Message Broker Explorer und wählen Sie *.broker-Datei exportieren aus. Wenn Sie dazu aufgefordert werden, navigieren Sie zu der Position, an der Sie die Datei speichern möchten, und geben Sie den Dateinamen ein; die Erweiterung .broker wird automatisch angehängt, wenn Sie auf Speichern klicken. Geben Sie bei der Festlegung dieses Parameters die Position (den Pfad) und den Dateinamen an. Bei der Ausführung dieses Befehls muss die Position unbedingt zugänglich sein.

Wenn Sie einen Befehl ausführen möchten, der SSL zur Verwaltung eines fernen Brokers über einen gesicherten Kanal verwendet, müssen Sie das Schlüsselspeicher- und Truststore-Kennwort für die Verbindung mithilfe der IBM_JAVA_OPTIONS-Umgebungsvariable angeben. Weitere Informationen finden Sie im Abschnitt Probleme bei der Befehlsausführung beheben.

-i IP-Adresse, -p Port, -q WS-Manager
Mit diesen Parametern werden die Verbindungsdetails für den Broker angegeben.

Nutzen Sie diese Option für Verbindungen mit fernen Brokern, die keine erweiterten Verbindungsparameter erfordern.

Bei Auswahl dieser Option müssen Sie mindestens einen dieser drei Parameter angeben. Die Reihenfolge ist dabei nicht relevant. Kein Parameter darf mehrmals angegeben werden.

Für die nicht angegebenen Parameter werden die Standardwerte übernommen:

  • -i IP-Adresse: Der Hostname oder die IP-Adresse des Computers, auf dem der Broker ausgeführt wird. Wenn Sie diesen Parameter nicht angeben, wird ein Wert verwendet, der den lokalen Computer repräsentiert.
  • -p Port: Der TCP-Port, auf dem der WS-Manager des Brokers empfangsbereit ist. Wenn Sie diesen Parameter nicht angeben, wird der Wert 1414 verwendet.
  • -q WS-Manager: Der Name des Broker-WS-Managers. Wenn Sie diesen Parameter nicht angeben, wird ein Wert verwendet, der den Standard-WS-Manager auf dem lokalen Computer repräsentiert.
-o Betriebsmodus
(Optional) Dieser Parameter legt den Modus des Zielbrokers fest. Gültige Werte sind advanced (vollständige Edition), standard (Standard Edition), express (Express Edition) und adapter (Remote Adapter Deployment Modus). Wenn Sie den Parameter -o nicht angeben, zeigt der Befehl den Modus an, in dem der Broker ausgeführt wird.
-x Moduserweiterungen
(Optional) Dieser Parameter verwendet eine durch Kommas getrennte Liste, um die Moduserweiterungen anzugeben, zu deren Nutzung der Broker berechtigt ist. Außerdem können Sie mit dem Parameter -x alle Moduserweiterungen inaktivieren (siehe Beispiele). In WebSphere Message Broker Version 7.0.0.2 ist diese Funktion nicht verfügbar.
-w ZeitlimitSekunden
(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 unterstützten Plattformen muss der Benutzer-ID, die diesen Befehl zur Modusabfrage ausführt, auf den Brokern, für die Verwaltungssicherheit aktiviert wurde, Leseberechtigung für die Sicherheitswarteschlange SYSTEM.BROKER.AUTH erteilt werden.

Auf allen unterstützten Plattformen muss der Benutzer-ID, die diesen Befehl zur Modusänderung ausführt, Lese- und Schreibberechtigung für die Sicherheitswarteschlange SYSTEM.BROKER.AUTH erteilt werden.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
0
Der Befehl wurde erfolgreich ausgeführt.
2
(Failure) Der Broker hat die Implementierungsanforderung empfangen, konnte sie jedoch nicht erfolgreich verarbeiten. Weitere Informationen finden Sie in den Nachrichten vom Dienstprogramm (oder im Administrationsprotokoll).
9
(Failure) Die Anforderung wurde an den Broker übergeben, jedoch wurde vor Ablauf des Zeitlimits keine Antwort empfangen.
10
(Failure) Die Anforderungsoperation wurde durch einen anderen Benutzer oder eine andere Anwendung abgebrochen, bevor sie vom Broker verarbeitet werden konnte.
98
Der Broker ist nicht aktiv.
99
Mindestens einer der von Ihnen angegebenen Parameter ist ungültig.

Beispiele

Befehl mqsimode unter Angabe des Parameters -o ausführen

Bei der Ausführung des Befehls mqsimode unter Angabe des Parameters -o für Broker BROKER1 wird der Modus aktualisiert und Sie erhalten einen Bericht mit allen Fehlern, die aufgetreten sind. Angenommen, der Broker soll mit dem folgenden mqsimode-Befehl in den Remote Adapter Deployment-Modus gesetzt werden und der Broker hat den folgenden Status:
  • Brokername1 ist der Name des Brokers.
  • Nachrichtenfluss ist der Name Ihres Nachrichtenflusses.
  • Ausführungsgruppe ist der Name Ihrer Ausführungsgruppe.
  • Mit dem Befehl wird für den Broker Brokername1 der Remote Adapter Deployment-Modus gesetzt, der Broker enthält aber einen Knotentyp-Knoten, der in diesem Modus nicht zulässig ist.
mqsimode BROKER1 –o adapter
Sie erhalten die folgenden Nachrichten:
BIP1044: Verbindung zum Warteschlangenmanager des Brokers wird hergestellt...
BIP1045: Verbindung zum Broker wird hergestellt...
BIP1805: Der Modus für den Broker 'Brokername1' wurde in 'adapter' geändert.
BIP1823: WARNUNG: Der Broker 'Brokername1' verfügt in der Ausführungsgruppe 'Ausführungsgruppe' 
 über einen Nachrichtenfluss namens 'Nachrichtenfluss', der mindestens einen Knoten enthält, der in 
 diesem Modus nicht gültig ist: Knotentyp.
BIP8229: Der Befehl wurde mit der folgenden Anzahl an Warnungen ausgeführt: 1.

Befehl mqsimode ohne Angabe des Parameters -o ausführen

Wenn Sie den Befehl mqsimode ohne den Parameter -o ausführen, erhalten Sie einen Bericht zu dem von Ihrem Broker verwendeten Modus, einen Bericht über alle Modusverstöße und einen Bericht über alle Moduserweiterungen, die erforderlich sind, jedoch nicht festgelegt wurden. Angenommen, der folgende mqsimode-Befehl soll ausgeführt werden und der Broker hat den folgenden Status:
  • Brokername ist der Name Ihres Brokers.
  • Ihr Broker befindet sich im Standard Edition Modus.
  • Für den Broker liegen keine Verstöße vor.
mqsimode Brokername
Sie erhalten die folgenden Nachrichten:
BIP1044: Verbindung zum Warteschlangenmanager des Brokers wird hergestellt...
BIP1807: Modusinformationen des Brokers 'Brokername' werden aufgespürt...
BIP1802: Der Broker 'Brokername' befindet sich im Modus 'standard'.
BIP8071: Befehl wurde erfolgreich ausgeführt.

Ausschalten aller Moduserweiterungen

Die Moduserweiterungen werden mit dem Befehl mqsimode unter Angabe des Parameters -x inaktiviert. In WebSphere Message Broker Version 7.0.0.2 ist diese Funktion nicht verfügbar:
mqsimode Brokername –x 
Dabei steht Brokername für den Namen Ihres Brokers.

Befehl mqsimode unter Angabe des Parameters -o in einem Broker ausführen, der eine ältere Version als V6.1 verwendet

Wenn Sie den Parameter -o für eine Broker ausführen, der auf einer Version vor V6.1 ausgeführt wird, erhalten Sie einen Bericht mit einer entsprechenden Nachricht. Hier ein Beispiel, in dem Brokername der Name des Brokers ist:
BIP1044: Verbindung zum Warteschlangenmanager des Brokers wird hergestellt...
BIP1045: Verbindung zum Broker wird hergestellt...
BIP1808: Der Broker 'Brokername' weist nicht die erforderliche Softwareversion für die
 Modusänderung auf.
 BIP8229: Der Befehl wurde mit der folgenden Anzahl an Warnungen ausgeführt: 1.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:21:12


ReferenzthemaReferenzthema | Version 8.0.0.1 | an67710_