runmqras

Zweck

Der Befehl runmqras wird verwendet, um Fehlerbehebungsinformationen von einer Maschine in einem einzigen Archiv zusammenzustellen. Sie können diesen Befehl verwenden, um Informationen zu einem Anwendungs-oder IBM MQ -Fehler zu sammeln, möglicherweise für die Übergabe an IBM , wenn Sie einen Fehler melden.

Die Ausführung ohne Anforderung zusätzlicher Diagnosebereiche (sections) ist als Ausgangspunkt für allgemeine Problemdiagnosen vorgesehen; Sie können jedoch über die Befehlszeile weitere Bereiche anfordern.

In diesen zusätzlichen Abschnitten werden je nach Typ des diagnostizierten Problems ausführlichere Informationen zusammengestellt. Wenn IBM Supportmitarbeiter andere Abschnitte als die Standardabschnitte benötigen, erhalten Sie entsprechende Informationen.

Der Befehl runmqras kann unter jeder beliebigen Benutzer-ID ausgeführt werden, stellt aber nur Informationen zusammen, die unter der Benutzer-ID manuell zusammengestellt werden können. Im Allgemeinen sollten Sie den Befehl beim Debugging von IBM MQ -Problemen unter der Benutzer-ID mqm ausführen, damit der Befehl Warteschlangenmanagerdateien und Befehlsausgaben zusammenstellen kann.

Ab IBM MQ 8.0.0Fixpack 9ruft der Befehl runmqras standardmäßig die Informationen zur Umgebungsvariablen ab. Dies gilt für Linux®, Solarisund AIX®.

Ab IBM MQ 8.0.0Fixpack 9ruft der Befehl runmqras standardmäßig eine Liste des Datenverzeichnisses des Warteschlangenmanagers ab. Dies gilt für verteilte Plattformen.

Schlüsselwörter und Parameter

Alle Parameter sind erforderlich, sofern sie in der Beschreibung nicht als optional bezeichnet werden.

In allen Fällen ist QMgrName der Name des Warteschlangenmanagers, für den der Befehl gilt.

-zipfile ZipFileName

Geben Sie den Dateinamen des zu erstellenden Archivs an.

Standardmäßig hat das Ausgabearchiv den Namen runmqras.zip.

-outputdir path

Das Verzeichnis, in dem die zu erstellende Ausgabedatei abgelegt wird.

Standardmäßig entspricht das Ausgabeverzeichnis dem Arbeitsverzeichnis.

-workdirectory path

Das Verzeichnis zum Speichern der Ausgabe von Befehlen, die während der Verarbeitung des Tools ausgeführt werden. Wird hier ein Verzeichnis angegeben, darf es entweder noch nicht vorhanden sein (dann wird es erstellt) oder es muss leer sein.

Wenn Sie den Pfad nicht angeben, wird auf UNIX-Systemenein Verzeichnis unter /tmp und unter Windowsunter %temp% verwendet, dessen Name mit runmqras beginnt und an das Datum und die Zeit angehängt wird.

-section SectionA, SectionB

Die optionalen Diagnosebereiche, zu denen genauere Informationen zusammengestellt werden sollen. Sie müssen ein Komma als Trennzeichen zwischen Abschnitten verwenden, ohne Leerzeichen. For example:

runmqras -qmlist ESBSTGAPPQMVH2 -section defs,trace,cluster -caseno TEST123

Standardmäßig wird ein generischer Dokumentationsbereich erfasst, wohingegen für spezielle Problemtypen auch genauere Informationen zusammengestellt werden können; zum Beispiel wird bei Angabe des Bereichsnamens trace der gesamte Inhalt des Traceverzeichnisses erfasst.

Die Standarderfassung wird mit dem Bereichsnamen nodefault inaktiviert.

Der IBM Support stellt Ihnen im Allgemeinen die zu verwendenden Abschnitte zur Verfügung. Beispiele für verfügbare Diagnosebereiche:

Alle

Erfasst sämtliche möglichen Informationen einschließlich aller Tracedateien und Diagnosen für die verschiedensten Problemtypen. Diese Option sollten Sie nur in besonderen Fällen verwenden, sie ist nicht für den allgemeinen Gebrauch gedacht.

Standard

IBM MQ -Protokolle, FDC-Dateien, Basiskonfiguration und Status.

Hinweis: Immer erfasst, wenn Sie nicht den Abschnittsnamen nodefaultverwenden. Einige Informationen zur aktuellen Umgebung (gespeichert in env.stdout unter Linux, UNIX und IBM iund in set.stdout unter Windows) und zu aktuellen Benutzergrenzwerten (gespeichert in mqconfig.stdout unter Linux und UNIX) können durch den Befehl runmqras geändert werden. Führen Sie gegebenenfalls die Befehle env, setoder mqconfig manuell in Ihrer Umgebung aus, um die tatsächlichen Werte zu überprüfen.

nodefault

Inaktiviert die Standarderfassung, andere explizit angegebene Bereiche werden aber erfasst.

trace

Es werden alle Tracdedateiinformationen sowie die Standardinformationen erfasst.

Hinweis: Die Traceerstellung wird nicht aktiviert.

defs

Es werden Warteschlangenmanagerdefinitionen und Statusinformationen erfasst.

Cluster

Es werden Clusterkonfigurations- und Warteschlangeninformationen erfasst.

dap

Es werden Transaktionsinformationen und Informationen zur Persistenz erfasst.

kernel

Es werden Informationen zum Warteschlangenmanagerkernel erfasst.

Protokollfunktion

Es werden Protokollinformationen zur Wiederherstellung erfasst.

Thema

Es werden Informationen zur Themenstruktur erfasst.

QMGR

Es werden alle Warteschlangenmanagerdateien erfasst: Warteschlangen, Protokolle und Konfigurationsdateien.

Verlust

Ab IBM MQ 8.0.0Fixpack 9werden Informationen zur Ressourcennutzung des IBM MQ -Prozesses erfasst.

Dieser Abschnitt gilt für Linux, HP-UX, Solarisund AIX.

mft

Ab IBM MQ 8.0.0Fixpack 8werden die mit dem Befehl fteRas abgerufenen Daten erfasst.

Hinweis: -section mft erfasst nur Informationen für die Standardtopologie des Koordinationswarteschlangenmanagers.

Weitere Informationen finden Sie unter Abschnittsnamen und Beschreibungenim technischen Hinweis von IBM zur Verwendung des Befehls IBM MQ runmqras zum Erfassen von Daten.

-qmlist QMA[,QMB]

Eine Liste mit den Namen der Warteschlangenmanager, für die der Befehl runmqras ausgeführt werden soll.

Dieser Parameter gilt nicht für ein Clientprodukt, da es keine Warteschlangenmanager gibt, von denen eine direkte Ausgabe angefordert werden kann.

Durch Übergabe einer durch Kommas getrennten Liste können Sie die Iteration für Warteschlangenmanager auf eine bestimmte Liste von Warteschlangenmanagern beschränken. Standardmäßig erfolgt die Iteration von Befehlen für alle Warteschlangenmanager.

-timeout secs

Das Standardzeitlimit für einen einzelnen Befehl, nach dessen Ablauf der Befehl nicht mehr auf die Beendigung wartet.

Standardmäßig wird ein Zeitlimit von 10 Sekunden verwendet. Bei Angabe von 0 wartet der Befehl unbegrenzt.

-demo

Die Ausführung erfolgt im Demonstrationsmodus, in dem keine Befehle verarbeitet und keine Dateien zusammengestellt werden.

Bei der Ausführung im Demonstrationsmodus können Sie sehen, welche Befehle verarbeitet und welche Dateien zusammengestellt worden wären. Die Ausgabedatei .zip enthält eine console.log-Datei, die genau dokumentiert, was verarbeitet und erfasst worden wäre, falls der Befehl normal ausgeführt werden soll.

-v

Erweitert die Menge an Informationen, die in der console.log-Datei protokolliert werden, die in der Ausgabe- .zip-Datei enthalten ist.

-ftp ibm/custom

Ermöglicht das Senden des zusammengestellten Archivs über eine FTP-Basisverbindung an ein fernes Ziel.

Am Ende der Verarbeitung kann das resultierende Archiv über Basis-FTP entweder direkt an IBModer an eine Site Ihrer Wahl gesendet werden. Wenn Sie die Option ibm auswählen, wird anonymes FTP verwendet, um das Archiv auf dem IBM ECuRep -Server bereitzustellen. Dieser Prozess ist identisch mit der manuellen Übergabe der Datei über FTP.

Beachten Sie bei Auswahl der Option ibm, dass Sie auch die Option pmrno angeben müssen und dass alle anderen FTP*-Optionen ignoriert werden.

-ftpserver -Server

Der Name eines FTP-Servers, mit dem eine Verbindung hergestellt werden soll, wenn eine benutzerdefinierte FTP-Option verwendet wird.

-ftpusername Benutzer-ID

Die Benutzer-ID für die Anmeldung beim FTP-Server, wenn eine benutzerdefinierte FTP-Option verwendet wird.

-ftppassword Kennwort

Das Kennwort für die Anmeldung beim FTP-Server, wenn eine benutzerdefinierte FTP-Option verwendet wird.

-ftpdirectory Pfad

Das Verzeichnis auf dem FTP-Server, in dem die resultierende .zip-Datei in verwendet wird, wenn eine angepasste FTP -Option verwendet wird.

-pmrno 12345,678,9AB

Eine gültige IBM PMR-Nummer (Problemsatznummer), der die Dokumentation zugeordnet werden soll.

Verwenden Sie diese Option, um sicherzustellen, dass Ihre PMR-Nummer der Ausgabe als Präfix vorangestellt wird, damit die an IBM gesendeten Informationen automatisch dem betreffenden Problemsatz zugeordnet werden.

-caseno caseNo

Eine gültige Salesforce -Fallnummer.

Verwenden Sie diese Option, um sicherzustellen, dass der Ausgabe Ihrer Fallnummer vorangestellt ist. Wenn die Informationen an IBM gesendet werden, werden die Informationen automatisch mit dieser Fallnummer verknüpft.

Hinweis: -caseno ist äquivalent zu -pmrno und beide sind optionale Parameter, aber es ist nicht zulässig, beide zusammen anzugeben.

-help

Stellt einen einfachen Hilfetext bereit.

-sub

Zeigt die Schlüsselwörter an, die in XML ersetzt werden.

Rückkehrcodes

Ein Rückgabecode ungleich null weist auf einen Fehler hin.