Befehl "errpt"

Online bearbeiten

Zweck

Generiert einen Bericht protokollierter Fehler.

Syntax

Bericht aus dem Fehlerprotokoll verarbeiten

errpt [ -@ wpar_name ] [ -a ] [ -A ] [ -c ] [ -d ErrorClassList ] [ -D ] [ -e EndDate ] [ -g ] [ -i Datei ] [ -I Datei ] [ -j ErrorID [ , Fehler-ID ] ] | [ -k ErrorID [ , Fehler-ID ] ] [ -J ErrorLabel [ , Fehlerbezeichnung ] ] | [ -K ErrorLabel [ , Fehlerbezeichnung ] ] [ -l SequenceNumber ] [ -m Maschine ] [ -n Knoten ] [ -s StartDate ] [ -F FlagList ] [ -N ResourceNameList ] [ -P ] [ -R ResourceTypeList ] [ -S ResourceClassList ] [ -T ErrorTypeList ] [ -y Datei ] [ -z Datei ]

Bericht aus dem Repository für Fehlerdatensatzvorlagen verarbeiten

errpt [ -a ] [ -A ] [ -I Datei ] [ -t ] [ -d Fehlerklassenliste ] [ -j Fehler-ID [ ,Fehler-ID ] ] | [ -k Fehler-ID [ ,Fehler-ID ] ] [ -J Fehlerbezeichnung [ ,Fehlerbezeichnung ] ] | [ -K Fehlerbezeichnung [ ,Fehlerbezeichnung ] ] [ -F Flagliste ] [ -P ] [ -T Fehlertypenliste ] [ -y Datei ] [ -z Datei ]

Beschreibung

Der Befehl errpt generiert einen Fehlerbericht aus Einträgen in einem Fehlerprotokoll. Es enthält Flags zur Auswahl von Fehlern, die bestimmten Kriterien entsprechen. Mit der Standardbedingung können Sie Fehlerprotokolleinträge in der umgekehrten Reihenfolge anzeigen, in der sie aufgetreten sind und aufgezeichnet wurden. Das Flag -c (concurrent, gleichzeitig) bewirkt, dass Fehler angezeigt werden, sobald sie auftreten. Wenn das Flag -i nicht mit dem Befehl errpt verwendet wird, ist die von errpt verarbeitete Fehlerprotokolldatei die in der Konfigurationsdatenbank für Fehlerprotokolle angegebene. (Zum Anzeigen der Informationen in der Konfigurationsdatenbank des Fehlerprotokolls verwenden Sie den Befehl Errdemon .)

Der Standardzusammenfassungsbericht enthält eine Datenzeile für jeden Fehler. Sie können Flags verwenden, um Berichte mit anderen Formaten zu generieren.

Anmerkung: Der Befehl Errpt führt keine Fehlerprotokollanalyse durch. Verwenden Sie für die Analyse den Befehl Diag . Wenn die Fehlerprotokollanalyse durchgeführt wird, kann die Diagnose jedoch Diagnoseinformationen in das Fehlerprotokoll einfügen. Diese Informationen werden im Anschluss an die detaillierten Daten des entsprechenden Fehlerprotokolleintrags angezeigt.

Sie können zum Ausführen dieses Befehls auch den SMIT-Direktaufruf (System Management Interface Tool) smit errpt verwenden.

Flags

-@WPAR-Name
Wählt die Fehlereinträge für den angegebenen WPAR-Namen aus.
-a
Zeigt Informationen zu Fehlern in der Fehlerprotokolldatei im detaillierten Format an. Wenn dieses Flag in Kombination mit dem Flag -t verwendet wird, werden alle Informationen aus der Vorlagendatei angezeigt.
-A
Zeigt eine gekürzte Version des mit dem Flag -a erzeugten detaillierten Berichts an. Das Flag -A kann nicht zusammen mit den Flags -a, -g und -t angegeben werden. Bei den berichteten Informationen handelt es sich um den Kennsatz, das Datum und die Uhrzeit, den Typ, den Ressourcennamen, die Beschreibung und die Detaildaten. Die Beispielausgabe dieses Flags hat folgendes Format:
LABEL:           STOK_RCVRY_EXIT
Date/Time:       Tue Dec 14 15:25:33 
Type:            TEMP
Resource Name:   tok0
Description
PROBLEM RESOLVED
Detail Data
FILE NAME
line: 273 file: stok_wdt.c
SENSE DATA
0000 0000 0000 0000 0000 0000 
DEVICE ADDRESS
0004 AC62 25F1
-c
Formatiert alle Fehlereinträge gleichzeitig, d. h, zu dem Zeitpunkt, zu dem sie protokolliert werden, und zeigt sie an. Die vorhandenen Einträge in der Protokolldatei werden in der Reihenfolge angezeigt, in der sie protokolliert wurden.
-d ErrorClassList
Beschränkt den Fehlerbericht auf bestimmte Typen von Fehlerdatensätzen, die mit der gültigen Variablen Fehlerklassenliste angegeben werden: H (Hardware), S (Software), 0 (Nachrichten des Befehls errlogger) und U (Unbestimmt). Die Fehlerdatensätze in der Variablen Fehlerklassenlistse können durch Kommas (,= voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden.
-D
Konsoliert doppelt vorhandene Fehler. Der mit dem Flag -a abgerufene detaillierte Fehlerbericht enthält die Anzahl und die Uhrzeiten des ersten und letzten Vorkommens des Fehlers. Siehe Fehlerprotokollierung-Übersicht in Allgemeine Programmierkonzepte: Programme schreiben und debuggen.
Anmerkung: Das Flag -D ist mit den Flags -c, -g, -l, -t.und -P nicht gültig.
-e EndDate
Gibt alle Datensätze an, die bis zu dem mit der Variablen Enddatum angegebenen Datum einschließlich veröffentlicht wurden, wobei die Variable Enddatum das Format mmddhhmmyy (Monat, Tag, Stunde, Minute und Jahr) hat.
-g
Zeigt die ASCII-Darstellung von unformatierten Fehlerprotokolleinträgen an. Die Ausgabe dieses Flags hat folgendes Format:
el_sequenz
Eindeutige Nummer im Fehlerprotokoll
el_bezeichnung
Fehlerbezeichnung
el_zeitmarke
Zeitmarke des Fehlerprotokolleintrag
El_crcid
Eindeutige CRC-Fehler-ID (Cyclic Redundancy Check, zyklische Blockprüfung)
ID der el_Maschine
Maschinen-ID
El_Knoten-ID
Knoten-ID
el_klasse
Fehlerklasse
Eltyp
Fehlertyp
el_ressource
Ressourcenname
el_rklasse
Ressourcenklasse
el_rtyp
Ressourcentyp
el_vpd_ibm
IBM® Vital Product Data (VPD)
el_vpd_benutzer
Benutzer-VPD
El_in
Positionscode einer Einheit
'el_connwhere'
Hardwareverbindungs-ID (Position in einer bestimmten Einheit, z. B. Steckplatznummer)
Et_Label
Fehlerbezeichnung
et_klasse
Fehlerklasse
Typ
Fehlertyp
Et_Beschreibung
Fehlerbeschreibung
et_probcauses
Mögliche Ursachen
'et_usercauses'
Benutzerursachen
Aktion 'et_useraction'
Benutzeraktionen
et_instcauses
Installationsursachen
et_instaction
Installationsaktionen
et_Fehlerursachen
Fehlerursachen
Aktion 'et_failaction'
Fehlerbehebungsaktionen
'et_detail_length'
Feldlänge für Detaildaten
et_detail_descid
Detaildaten-IDs
et_detail_codieren
Beschreibung des Eingabeformulars für Detaildaten
Et_logflg
Protokollflag
Et_alertflg
Flag für alertfähige Fehler
Berichtsflg
Flag für Fehlerbericht
el_detail_länge
Eingabelänge für Detaildaten
el_Detail_Daten
Detaildateneingabe
-F FlagList
Wählt Fehlerdatensatzvorlagen entsprechend dem Wert derAlert,LogoderReportFeld der Vorlage. Die Datensätze in der Variablen Flagliste können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden. Das Flag -F kann nur zusammen mit dem Flag -t verwendet werden.

Die gültigen Werte für die Variable Flagliste sind im Folgenden beschrieben:

alert=0
Wählt Fehlerdatensatzvorlagen mit demAlertFeld auf ' False' gesetzt.
alert=1
Wählt Fehlerdatensatzvorlagen mit demAlertFeld auf 'True' gesetzt.
log=0
Wählt Fehlerdatensatzvorlagen mit demLogFeld auf ' False' gesetzt.
log=1
Wählt Fehlerdatensatzvorlagen mit demLogFeld auf 'True' gesetzt.
report=0
Wählt Fehlerdatensatzvorlagen mit demReportFeld auf ' False' gesetzt.
report=1
Wählt Fehlerdatensatzvorlagen mit demReportFeld auf 'True' gesetzt.
-i Datei
Verwendet die mit der Variablen Datei angegebene Fehlerprotokolldatei. Wenn Sie dieses Flag nicht angeben, wird der Wert aus der Konfigurationsdatenbank für Fehlerprotokolle verwendet.
-I Datei
Verwendet die mit der Variablen Datei angegebene Diagnoseprotokolldatei. Wenn Sie dieses Flag nicht angeben, wird der Standardpfadname, /var/adm/ras/diag_log, verwendet.
-j Fehler-ID [, Fehler-ID ]
Schließt nur die mit der Variablen Fehler-ID angegebene Fehlerprotokolleinträge ein. Die Datensätze in der Variablen Flagliste können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden. Wennd dieses Flag in Kombination mit dem Flag -t verwendet wird, werden Einträge aus dem Fehlervorlagenrepository verarbeitet. (Andernfalls werden Einträge aus dem Fehlerprotokollrepository verarbeitet.)
-J ErrorLabel
Schließt die mit der Variablen Fehlerbezeichnung angegebenen Fehlerprotokolleinträge ein. Die Werte für die Variable Fehlerbezeichnung können durch Kommas getrennt oder in doppelte Anführungszeichen eingeschlossen und durch Kommas oder Leerzeichen getrennt werden. Wenn dieses Flag in Kombination mit dem Flag -t verwendet wird, werden Einträge aus dem Fehlervorlagenrepository verarbeitet. (Andernfalls werden Einträge aus dem Fehlerprotokollrepository verarbeitet.)
-k Fehler-ID [, Fehler-ID ]
Schließt die mit der Variablen Fehler-ID angegebenen Fehlerprotokolleinträge aus. Die Datensätze in der Variablen Flagliste können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden. Wennd dieses Flag in Kombination mit dem Flag -t verwendet wird, werden Einträge aus dem Fehlervorlagenrepository verarbeitet. (Andernfalls werden Einträge aus dem Fehlerprotokollrepository verarbeitet.)
-K ErrorLabel
Schließt die mit der Variablen Fehlerbezeichnung angegebenen Fehlerprotokolleinträge aus. Die Werte für die Variable Fehlerbezeichnung können durch Kommas getrennt oder in doppelte Anführungszeichen eingeschlossen und durch Kommas oder Leerzeichen getrennt werden. Wenn dieses Flag in Kombination mit dem Flag -t verwendet wird, werden Einträge aus dem Fehlervorlagenrepository verarbeitet. (Andernfalls werden Einträge aus dem Fehlerprotokollrepository verarbeitet.)
-l SequenceNumber
Wählt einen mit der Variablen Folgenummer angegebenen Fehlerprotokolleintrag aus. Dieses Flag wird von Methoden in der Objektklasse für Fehlernachrichten verwendet. Die Datensätze in der Variablen Folgenummer können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden.
-m Maschine
Schließt Fehlerprotokolleinträge für die mit der Variablen Maschine angegebene Maschine ein. Der Befehl uname -m gibt den Wert der Variablen Maschine zurück.
-n Knoten
Schließt Fehlerprotokolleinträge für die angegebene Knoten variableein. Der Befehl uname -n gibt den Wert der Variablen Knoten zurück.
-N ResourceNameList
Generiert einen Bericht über die mit der Variablen Ressourcennamensliste angegebenen Ressourcennamen. Die Variable Ressourcennamensliste ist eine Liste mit Namen von Ressourcen, für die Fehler erkannt wurden. Für Softwarefehler listet die Variable Ressourcennamensliste die Namen von Ressourcen auf, für die Fehler erkannt wurden. Für Hardwarefehler werden die Namen von Einheiten oder Systemkomponenten aufgelistet. Das Flag zeigt nicht an, dass die Komponente fehlerhaft ist oder ersetzt werden muss. Es wird vielmehr dazu verwendet, die geeigneten Diagnosemodule zu bestimmen, die zum Analysieren des Fehlers verwendet werden sollen.

Die mit der Variablen Ressourcennamensliste angegebenen Namen können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden.

-P
Zeigt nur Fehler an, die Duplikate des vorherigen Fehlers sind. Das Flag -P gilt nur für doppelte Fehler, die vom Einheitentreiber für das Fehlerprotokoll generiert werden. Diese Fehler sind Duplikate, die innerhalb des ungefähren Zeitintervalls aufgetreten sind, ds mit dem Fehlerprotokollierungsattribut errlg_duptime angegeben wird, das vom Flag -t des Dämons errdemon gesteuert wird. Das Flag -P kann nicht zusammen mit dem Flag -D angegeben werden.
-R ResourceTypeList
Generiert einen Bericht über die mit der Variablen Ressourcentypliste angegebenen Ressourcentypen. Bei Hardwarefehlern ist die Variable Ressourcentypliste ein Einheitentyp. Bei Softwarefehlern ist es der Wert LPP. Die mit der Variablen Ressourcentypliste angegebenen Einträge können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden.
-s StartDate
Gibt alle Datensätze an, die ab dem mit der Variablen Startdatum angegebenen Datum veröffentlicht wurden, wobei die Variable Startdatum das Format mmddhhmmyy (Monat, Tag, Stunde, Minute und Jahr) hat.
-S ResourceClassList
Generiert einen Bericht über die mit der Variablen Ressourcenklassenliste angegebenen Ressourcenklassen. Bei Hardwarefehlern ist die Variable Ressourcenklassenliste eine Einheitenklasse. Die angegebenen Ressourcenklassen können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden.
-t
Verarbeitet das Fehlerdatensatzvorlagenrepository anstelle des Fehlerprotokolls. Mit dem Flag -t können Fehlerdatensatzvorlagen in Berichtsform angezeigt werden.
-T ErrorTypeList
Begrenzt den Fehlerbericht auf Fehlertypen, die mit den gültigen Variablen Fehlertypliste angegeben werden: INFO, PEND, PERF, PERM, TEMP und UNKN. Die angegebenen Fehlertypen können durch Kommas (,) voneinander getrennt oder in doppelte Anführungszeichen (" ") eingeschlossen und durch Kommas (,) oder Leerzeichen voneinander getrennt werden.
-y Datei
Verwendet die mit der Variablen Datei angegebene Vorlagendatei für Fehlerdatensätze. Wenn dieses Flag in Kombination mit dem Flag -t verwendet wird, werden Einträge aus dem angegebenen Fehlervorlagenrepository verarbeitet. (Andernfalls werden Einträge aus dem Fehlerprotokollrepository unter Verwendung des angegebenen Fehlervorlagenrepositorys verarbeitet.)
-z Datei
Verwendet den mit der Variablen Datei angegebenen Nachrichtenkatalog für das Fehlerprotokoll. Wenn dieses Flag in Kombination mit dem Flag -t verwendet wird, werden Einträge aus dem Fehlervorlagenrepository verarbeitet. (Andernfalls werden Einträge aus dem Fehlerprotokollrepository verarbeitet.)

Sicherheit

Hinweis für Benutzer von RBAC und Trusted AIX : Dieser Befehl kann privilegierte Operationen ausführen. Privilegierte Operationen können nur von privilegierten Benutzern ausgeführt werden. Weitere Informationen zu Berechtigungen und Privilegien finden Sie unter "Privileged Command Database" in der Veröffentlichung Sicherheit. Eine Liste der Berechtigungen und Autorisierungen, die diesem Befehl zugeordnet sind, finden Sie in den Beschreibungen des Befehls lssecattr und des Unterbefehls getcmdattr.
Sie müssen zum Ausführen des Befehls errpt die folgenden zusätzlichen Berechtigungen haben, wenn die errpt-Einschränkung im Befehl errdemon aktiviert wurde:
aix.ras.error.errpt
Für die Ausführun des Befehls errpt erforderlich.
Anmerkung: Standardmäßig sind Root-und Systemgruppenbenutzer privilegierte Benutzer.

Beispiele

  1. Geben Sie Folgendes ein, um einen vollständigen Zusammenfassungsbericht anzuzeigen:
    errpt
  2. Geben Sie Folgendes ein, um einen vollständigen detaillierten Bericht anzuzeigen:
    errpt  -a
  3. Zum Anzeigen eines detaillierten Berichts aller Fehler, die für die Fehler-ID protokolliert wurdenE19E094F, geben Sie Folgendes ein:
    errpt  -a  -j E19E094F
  4. Geben Sie Folgendes ein, um einen detaillierten Bericht aller in den letzten 24 Stunden protokollierten Fehler anzuzeigen:
    errpt  -a  -s mmddhhmmyy
    Dabei ist diemmddhhmmyyZeichenfolge entspricht dem aktuellen Monat, Tag, Stunde, Minute und Jahr minus 24 Stunden.
  5. Geben Sie Folgendes ein, um Fehlerdatensatzvorlagen aufzulisten, für die die Protokollierung für alle Fehlerprotokolleinträge inaktiviert ist:
    errpt  -t  -F log=0
  6. Alle Einträge aus der alternativen Fehlerprotokolldatei anzeigen/var/adm/ras/errlog.alternate, geben Sie Folgendes ein:
    errpt  -i /var/adm/ras/errlog.alternate
  7. Alle Hardwareeinträge aus der alternativen Fehlerprotokolldatei anzeigen/var/adm/ras/errlog.alternate, geben Sie Folgendes ein:
    errpt  -i /var/adm/ras/errlog.alternate -d H
  8. Zum Anzeigen eines detaillierten Berichts aller Fehler, die für die Fehlerbezeichnung protokolliert wurdenERRLOG_ON, geben Sie Folgendes ein:
    errpt  -a  -J ERRLOG_ON
  9. Geben Sie Folgendes ein, um einen detaillierten Bericht über alle Fehler und Gruppenduplikatfehler anzuzeigen:
    errpt -aD
  10. Geben Sie Folgendes ein, um einen detaillierten Bericht aller Fehler anzuzeigen, die für die Fehlerbezeichnungen DISK_ERR1 und DISK_ERR2 im Monat August protokolliert wurden:
    errpt -a -J DISK_ERR1,DISK_ERR2 -s 0801000004 -e 0831235904"

Dateien

/etc/objrepos/SWservAt
Enthält die Objektklasse für die Attribute der Software-Service-Hilfe, d. h. die Konfigurationsdatenbank für Fehlerprotokolle.