Befehl 'mqsilist' (Ressourcen auflisten)

Unterstützte Plattformen

Zweck

Auf Windows-Plattformen sowie auf Linux- und UNIX-Systemen können Sie mit dem Befehl mqsilist alle auf dem System installierten Komponenten, die für einen bestimmten Broker definierten Ausführungsgruppen oder alle in einer Ausführungsgruppe auf einem bestimmten Broker enthaltenen Nachrichtenflüsse auflisten.

Auf Windows-Plattformen sowie auf Linux- und UNIX-Systemen wird die Ausgabe in die Standardausgabe (stdout) übertragen.

An einer z/OS-Konsole wird bei Eingabe des Befehls list eine Liste aller Ausführungsgruppen, die für einen bestimmten Broker definiert wurden, oder aller Nachrichtenflüsse in der angegebenen Ausführungsgruppe eines bestimmten Brokers zurückgegeben.

Syntax

Windows-Plattformen, Linux- und UNIX-Systeme

Wird der Befehl ohne Angabe von Parametern abgesetzt, wird für jede auf diesem System erstellte Komponente eine Liste der Komponenten und Warteschlangenmanager angezeigt, und zwar in folgendem Format:
BIP8099I: Broker: Brokername - Warteschlangenmanager
BIP8099I: Konfigurationsmanager: Konfigurationsmanager - Warteschlangenmanager
BIP8099I: UserNameServer: UserNameServer - Warteschlangenmanager
BIP8071I: Befehl wurde erfolgreich ausgeführt

z/OS

Synonym: l

Wird der Befehl ohne Angabe von Parametern abgesetzt, wird eine Liste der Ausführungsgruppen angezeigt.

Der Befehl list wird nur für den Namen einer Brokertask eingegeben. Beispiel:
F MQP1BRK,list
Als Ausgabe wird eine Liste der Ausführungsgruppen und der Prozess-IDs in folgendem Format erstellt:
BIP8130I: Ausführungsgruppe: <Name> -<Prozess-ID> 
BIP8071I: Befehl wurde erfolgreich ausgeführt
Bei Angabe einer Ausführungsgruppe, wie beispielsweise:
F MQP1BRK, list e='exgrp1'		
wird wie folgt als Ausgabe eine Liste mit Nachrichtenflüssen erstellt:
BIP8131I: Nachrichtenfluss: <Nachrichtenflussname>
BIP8071I: Befehl wurde erfolgreich ausgeführt

Parameter

Windows-Plattformen, Linux- und UNIX-Systeme

-a
(Optional) Führt alle auf dem System installierten Komponenten auf.
Wenn Sie diese Option für Broker aus Vorgängerreleases anwenden, erhalten Sie folgende Nachricht:
BIP8221I: <Komponente>: <Komponentenname> (<Version>) - <Warteschlangenmanager>  
Brokername
(Optional) Der Name des Brokers, dessen Ressourcen aufgelistet werden sollen. Es muss sich hier um einen bereits eingesetzten Broker handeln. Als Ergebnis wird eine Liste der in diesem Broker konfigurierten Ausführungsgruppen und der Prozess-IDs (pid) angezeigt.

Alle Plattformen

-e egroup
(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.

Informationen zu Nachrichtenflussn können nur abgerufen werden, wenn der angegebene Broker aktiv ist.

Berechtigung

Auf Linux- und UNIX-Systemen muss die Benutzer-ID zur Gruppe mqbrkrs gehören.

Auf Windows-Plattformen muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, zur Gruppe mqbrkrs gehören, wenn ein Brokername und das Attribut -e angegeben werden.

Antworten

  • BIP8013 Komponente nicht vorhanden
  • BIP8020 Auf die Datenbank kann nicht zugegriffen werden
  • BIP8029 Broker nicht konfiguriert
  • BIP8038 Nicht unterstützte Befehlsoption
  • BIP8039 Ausführungsgruppe nicht verfügbar
  • BIP8040 Es kann keine Verbindung zur Datenbank hergestellt werden
  • BIP8158 Ungültiges Befehlsformat (nur unter z/OS)
  • BIP8159 Unbekannter Parameter "..." (nur z/OS)

Beispiele

Windows-Plattformen, Linux- und UNIX-Systeme:
mqsilist WBRK_BROKER -e DefaultEG
mqsilist DatabaseInstanceMgr
z/OS
F MQP1BRK,list e='exgrp1'
Zugehörige Tasks
Komponenten prüfen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an07250_