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 - Windows-, Linux- und UNIX-Systeme

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

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsilist--+---------------------------------------------+---->
             +- -a ----------------------------------------+   
             '-| 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-'         

Wenn Sie diesen Befehl ohne Parameter angeben, wird für den Broker, den Sie für die aktuelle Installation auf diesem Computer erstellt haben, eine Zusammenfassung für den Broker bereitgestellt.

Die aktuelle Installation wird der von Ihnen geöffneten Befehlskonsole (unter Windows) zugeordnet oder dem aktiven mqsiprofile (auf Linux- und UNIX-Systemen).

Parameter

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.
-a
(Optional) Listet alle auf dem lokalen Computer installierten Broker in allen Installationen auf.

Wenn Sie diese Option auf einem Computer angeben, auf dem ältere Versionen als Version 7.0 installiert sind, werden nur Broker für diese Versionen aufgelistet (falls vorhanden); bei diesen älteren Brokern entspricht der Detaillierungsgrad -d 0, selbst wenn Sie bei diesem Befehl einen anderen Detaillierungsgrad angegeben (oder den Standardwert übernommen) haben. Falls Sie Informationen zu anderen Komponenten wünschen, die Sie in früheren Versionen erstellt haben, müssen Sie den entsprechenden mqsilist-Befehl für diese Version ausführen.

Mit dieser Option können keine Informationen zu fernen Brokern und ihren Ressourcen aufgelistet werden.

-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.

Beispiele

Mit folgendem Beispielbefehl werden alle Broker aufgelistet, die in der aktuellen Installation erstellt wurden:
mqsilist -d0
Die folgenden Antworten werden generiert:
BIP8099I: Broker: MB8BROKER  -  MB8QMGR
BIP8099I: Broker: test  -  testqm

BIP8071I: Befehl wurde erfolgreich ausgeführt.
Mit folgendem Beispielbefehl werden die implementierten Objekte aufgelistet, die für die Anwendung myApplication in der Standardausführungsgruppe konfiguriert sind:
mqsilist MB8BROKER -e default -k myApplication
Mit folgendem Beispielbefehl werden die implementierten Objekte aufgelistet, die für die Bibliothek myEGLibrary, die in der Anwendung myApplication enthalten ist, in der Standardausführungsgruppe konfiguriert sind:
mqsilist MB8BROKER -e default -k myApplication -y myEGLibrary
Der folgende Beispielbefehl gibt ausführliche Informationen zur Anwendung myApplication in der Standardausführungsgruppe zurück:
mqsilist MB8BROKER -e default -k myApplication -d2
Mit dem folgenden Beispielbefehl werden alle implementierten Objekte zurückgegeben, die in der Anwendung myApplication konfiguriert sind:
mqsilist MB8BROKER -e default -k myApplication -r
Mit dem folgenden Beispielbefehl wird eine Zusammenfassung der Ausführungsgruppen, die auf einem bestimmten Broker definiert sind, angefordert. (Der Parameter -d ist nicht angegeben, sodass der Standardwert 1 verwendet wird.)
mqsilist MB8BROKER 
Die folgenden Antworten werden generiert:
BIP1286I: Ausführungsgruppe 'ello' auf Broker 'MB8BROKER' ist aktiv.

BIP8071I: Befehl wurde erfolgreich ausgeführt.
Ausführliche Informationen zu allen Ressourcen für Broker auf dem lokalen Computer anzeigen:
mqsilist -a -r -d2
Die folgenden Antworten werden generiert:
BIP1280I: Die Anzahl der Laufzeit-Installationen auf dieser Maschine lautet '1'.

 7.0.0.0 : C:\Programme\IBM\MQSI\7.0

===================================
BIP1284I: Der Broker 'MB7BROKER' auf WS-Manager 'MB7QMGR' ist aktiv.

Brokerversion: '7000' (build 'S000-L90708')
Plattform: 'Microsoft Windows'
Prozess-ID: '3116'
Kurzbeschreibung: ''
Ausführliche Beschreibung: ''

-----------------------------------
BIP1286I: Die Ausführungsgruppe 'ello' auf Broker 'MB7BROKER' ist aktiv.

Anzahl der Nachrichtenflüsse, die für die Ausführung aktiviert sind: '2'.
Anzahl der Anwendungen, die für die Ausführung aktiviert sind: '1'.
Prozess-ID: '4220'
UUID: '45ef67ac-2201-0000-0080-f364270ba85e'
Kurzbeschreibung: ''
Ausführliche Beschreibung: ''

--------
BIP1288I: Der Nachrichtenfluss 'simpleflow' in der Ausführungsgruppe 'ello' ist aktiv.

Zusätzliche Thread-Instanzen: '0'
Implementiert: '24/07/09 16:37' in Brokerarchivdatei 'C:\Documents and Settings\Matt\My Documents\BAR Files\test.bar'
Letzte Bearbeitung: '08/08/07 17:42'
Benutzerdefinierte Eigenschaftsnamen:
Schlüsselwörter:
  Author = 'Matt'
  Information = 'This flow simply removes messages from SYSTEM.DEFAULT.LOCAL.QUEUE'
  Usage = 'This usage is buried inside the CMF'
  VERSION = 'v1.1'
--------
BIP1288I: Der Nachrichtenfluss 'MyApplicationFlow' in Ausführungsgruppe 'ello' ist aktiv.

Zusätzliche Thread-Instanzen: '0'
Implementiert: '27/07/09 20:15' in Bar file 'C:\Documents and Settings\Matt\My Documents\BAR Files\overridden.bar'
Letzte Bearbeitung: '12/06/07 17:06'
Benutzerdefinierte Eigenschaftsnamen:
Schlüsselwörter:

--------
BIP1290I: Die Datei 'Swift_2002_MT103.dictionary' wird in Ausführungsgruppe 'ello' implementiert.

Implementiert: '27/07/09 16:47' in Brokerarchivdatei 'C:\Documents and Settings\Matt\My Documents\BAR Files\SWIFT.bar'
Letzte Bearbeitung: '06/09/05 15:17'.
Schlüsselwörter:

===================================
BIP1285I: Der Broker 'test' auf WS-Manager 'testqm' wurde gestoppt.

Starten Sie den Broker, um weitere Informationen zu erhalten.

BIP8071I: Befehl wurde erfolgreich ausgeführt.
Die folgende Antwort wird generiert, wenn es sich beim Broker um einen Broker mit mehreren Instanzen im Bereitschaftsmodus handelt:
BIP1280I: Die Anzahl der Laufzeit-Installationen auf dieser Maschine lautet '1'.

 7.0.0.0 : C:\Programme\IBM\MQSI\7.0

===================================
BIP1292I: Broker 'MIBROKER1' ist ein aus mehreren Instanzen bestehender Broker.
Die Brokerinstanz wird im Bereitschaftsmodus für mehrere Instanzen ausgeführt
Warteschlangenmanager ‘MIQMGR1'

Weitere Informationen stehen zur Verfügung, sobald die Brokerinstanz aktiv ist.

BIP8071I: Befehl wurde erfolgreich ausgeführt
Die folgende Antwort wird generiert, wenn es sich beim Broker um einen Broker mit mehreren Instanzen im aktiven Modus handelt:
BIP1280I: Die Anzahl der Laufzeit-Installationen auf dieser Maschine lautet '1'.

 7.0.0.0 : C:\Programme\IBM\MQSI\7.0

===================================
BIP1293I: Broker 'MIBROKER1' ist ein aus mehreren Instanzen bestehender Broker .
Die Brokerinstanz ist aktiv und wird für mehrere Instanzen ausgeführt
Warteschlangenmanager ‘MIQMGR1'

-----------------------------------
BIP1286I: Die Ausführungsgruppe 'default' auf Broker 'MIBROKER1' ist aktiv.

Anzahl der Nachrichtenflüsse, die für die Ausführung aktiviert sind: '1'.
Anzahl der Anwendungen, die für die Ausführung aktiviert sind: '1'.
Prozess-ID: '4876'
UUID: '45ef7be4-2203-0000-0080-b764270fa96c'
Kurzbeschreibung: ''
Ausführliche Beschreibung: ''

--------
BIP1288I: Der Nachrichtenfluss 'jmsflow' in der Ausführungsgruppe 'default' ist aktiv.

Zusätzliche Thread-Instanzen: '0'
Implementiert: '26/09/09 18:21' in Brokerarchivdatei 'C:\Documents and Settings\JDoe\My Documents\
  BAR Files\test.bar'
Letzte Bearbeitung: '24/09/09 12:16'
Benutzerdefinierte Eigenschaftsnamen:
Schlüsselwörter:
  Author = 'JDoe'
  Information = 'This flow runs a simple jms scenario'
  Usage = 'Takes JMS input and writes to an MQOutput node'
  VERSION = 'v2.3'
--------

BIP8071I: Befehl wurde erfolgreich ausgeführt.
Die folgende Antwort wird generiert, wenn es sich beim Broker um einen Broker mit mehreren Instanzen handelt, der als WebSphere MQ-Service gestartet wird:
BIP1296I: Beim Broker 'HABK1' handelt es sich um einen Broker mit mehreren Instanzen, der als WebSphere MQ-Service gestartet wird.
Der aus mehreren Instanzen bestehende WS-Manager 'HAQM1' wird gestoppt.
BIP1298I: Broker 'BK3' wird als WebSphere MQ-Service gestartet. 
Der WS-Manager 'QM3' wird gestoppt.
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 | an28310_