WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Befehl mqsilist - z/OS

Mit dem Befehl mqsilist können Sie die installierten Broker und ihre implementierten Ressourcen auflisten.

Syntax

z/OS-Befehl - BIPLIST

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsilist--+--------------------------------------------+----->
             '-| brokerSpec |--+------------------------+-'   
                               '- -e--Ausführungsgruppe-'     

>--+--------------------------+--+----------------------+------->
   '- -d --Detaillierungsgrad-'  '- -k --Anwendungsname-'   

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

>--+-----------------------+-----------------------------------><
   '- -y --Bibliotheksname-'   

brokerSpec

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

z/OS-Konsolenbefehl

Synonym: l

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-+-list-+--+-----------+--+--------+--+----------------+-----><
   '-l----'  '- e=egName-'  '- r=yes-'  '- d=detailLevel-'   

Wenn Sie diesen Befehl ohne Parameter angeben, wird eine Liste der Ausführungsgruppen angezeigt.

Parameter

brokerSpec
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.
-n Brokerdateiname
Dieser Parameter gibt den Namen einer Datei an, welche die Verbindungsdetails für einen lokalen 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.

-i IP-Adresse, -p Port, -q WS-Manager
Mit diesen Parametern werden die Verbindungsdetails für den Broker angegeben. Wenn Sie einen WS-Manager angeben, muss dieser auf dem lokalen Computer definiert sein.

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.
Sie können keine Verbindung zu einem fernen WS-Manager unter z/OS herstellen; siehe Abschnitt Nutzungshinweis.
-d Detaillierungsgrad
(Optional) Geben Sie den gewünschten Detaillierungsgrad an; der Standardwert lautet 1.
  • 0 liefert nur den Brokernamen und die Namen der zugehörigen WS-Manager (diese Informationen sind mit denjenigen in den früheren Versionen identisch).

    Bitte berücksichtigen Sie, dass die Ausführungsgruppen beim Start eine PID 0 aufweisen können.

  • 1 liefert eine einzeilige Zusammenfassung jeder Ressource.
  • 2 liefert detaillierte Informationen zu jeder Ressource.
-e Ausführungsgruppe
(Optional) Wählt eine Ausführungsgruppe in einem Broker aus. Geben Sie die Bezeichnung der Ausführungsgruppe an, deren Nachrichtenflüsse aufgelistet werden sollen. Der Befehl gibt eine Liste der Nachrichtenflüsse zurück, die der angegebenen Ausführungsgruppe im Broker zugeordnet sind.

Der angegebene Broker muss für jede Nachrichtenfluss-Information aktiv sein, die zurückgegeben wird.

-k Name_der_Anwendung_oder_des_Service
(Optional) Dieser Parameter listet die implementierten Objekte auf, die für eine Anwendung oder einen Service konfiguriert sind. Bei Angabe dieses Parameters müssen Sie auch mit dem Parameter -e eine Ausführungsgruppe angeben.
-r
(Optional) Führen Sie den Befehl rekursiv aus; zeigt Informationen zu den Unterkomponenten an.
-v Tracedateiname
(Optional) Dieser Parameter sendet interne Debug-Trace-Informationen an die angegebene Datei.
-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.
-y Bibliotheksname
(Optional) Dieser Parameter listet die implementierten Objekte auf, die für eine Bibliothek konfiguriert sind. Bei Angabe dieses Parameters müssen Sie auch mit dem Parameter -e eine Ausführungsgruppe angeben. Mit diesem Parameter kann auch der Parameter -k verwendet werden. Damit kann der Inhalt einer bestimmten Bibliothek in der durch -k angegebenen Anwendung aufgelistet werden.

Nutzungshinweis

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.

Beispiele

Fordern Sie mit dem Konsolbefehl eine Zusammenfassung der Ausführungsgruppen für den Broker an. (Da der Parameter d= nicht angegeben ist, wird der Standardwert 1 übernommen.)
F MQP1BRK,list 
Die folgenden Antworten werden generiert:
BIP1286I: Die Ausführungsgruppe 'ello' auf Broker 'MQP1BRK' ist aktiv.

BIP8071I: Befehl wurde erfolgreich ausgeführt.
Mit dem Konsolbefehl können Sie die Nachrichtenflüsse in der angegebenen Ausführungsgruppe auflisten:
F MQP1BRK,list e='exgrp1'		
Die Antworten werden in folgendem Format generiert:
BIP1288I: Der Nachrichtenfluss 'simpleflow' in der Ausführungsgruppe 'ello' ist aktiv.

BIP8071I: Befehl wurde erfolgreich ausgeführt
Mit dem Konsolbefehl können die implementierten Objekte aufgelistet werden, die für die Bibliothek myEGLibrary, die in der Anwendung myApplication enthalten ist, in der Standardausführungsgruppe konfiguriert sind:
F MB8BROKER,list e='default' k='myApplication' y='myEGLibrary'

Im Abschnitt Befehl mqsilist - Windows-, Linux- und UNIX-Systeme finden Sie Beispiele zur Ausführung des Befehls mit BIPLIST und zu den generierten Antworten.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:49


ReferenzthemaReferenzthema | Version 8.0.0.5 | an28320_