Mit dem Befehl mqsimode können Sie Betriebsmodus-Informationen konfigurieren und abrufen.
Mit dem Befehl mqsimode können Sie den Betriebsmodus eines Brokers ändern oder Informationen zu dem Modus abrufen, in dem der Broker gerade arbeitet.
>>-mqsimode--| brokerSpec |--+---------------------+------------> '- -o --Betriebsmodus-' >--+--------------------+--+----------------------+-------------> '- -w --ZeitlimitSek-' '- -v --Tracedateiname-' >--+--------------------------+-------------------------------->< '- -x --Moduserweiterungen-' brokerSpec |--+- Brokername -----------------+-----------------------------| +- -n --Brokerdateiname--------+ | .--------------------------. | | V | | '-----+- -i --IP-Adresse-+---+-' +- -p --Port-------+ '- -q --WS-Manager-'
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.
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:
Mit dem Kauf der Lizenz für die Standard Edition sind Sie dazu berechtigt, Broker entweder im Standardmodus oder im Scale-Modus auszuführen.
Wenn Sie zum Herstellen einer Verbindung zu einem fernen Broker die Parameter i, p und q angeben oder eine Verbindungsparameterdatei (.broker) verwenden, versucht der Befehl, WebSphere MQ Java™-Clientcode zu verwenden. Da diese Option unter z/OS nicht unterstützt wird, wird folgender Fehler ausgegeben:
BIP1046E: Verbindung zum Broker (Name) kann nicht hergestellt werden
Als Ursachencode wird MQRC_ENVIRONMENT_ERROR angegeben. Sie müssen einen lokalen WS-Manager angeben.
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: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: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:mqsimode Brokername –x
Dabei steht Brokername für den Namen Ihres Brokers.