errpt コマンド

オンライン編集

目的

ログに記録されたエラーのレポートを生成します。

構文

エラー・ログからレポートを処理する

エラー [ -@ WPAR 名 ] [  -a 値 ] [  -A ] [  「-c」 ] [  -d 年 ErrorClassリスト ] [  -D ] [  -e (E) EndDate ] [  - ] [  I ファイル ] [  -I (I) ファイル ] [  -j (J) ErrorID [ ,ErrorID ] ] | [  -k (K) ErrorID [ ,ErrorID ] ] [  -J ErrorLabel [ ,ErrorLabel ] ] | [  -K (K) ErrorLabel [ ,ErrorLabel ] ] [  - SequenceNumber ] [  -m (M) マシン ] [  N ノード ] [  -s StartDate ] [  -F (R) FlagList ] [  -N (N) ResourceNameリスト ] [  -P ] [  -R ResourceTypeリスト ] [  -S (S) ResourceClassリスト ] [  -T (T) ErrorTypeリスト ] [  -y (Y) ファイル ] [  -z ファイル ]

エラー・レコード・テンプレート・リポジトリーからのレポートを処理する

エラー [  -a 値 ] [  -A ] [  -I (I) ファイル ] [  T ] [  -d 年 ErrorClassリスト ] [ -j (J) ErrorID [ ,ErrorID ] ] | [  -k (K) ErrorID [ ,ErrorID ] ] [  -J ErrorLabel [ ,ErrorLabel ] ] | [  -K (K) ErrorLabel [ ,ErrorLabel ] ] [  -F (R) FlagList ] [  -P ] [  -T (T) ErrorTypeリスト ] [  -y (Y) ファイル ] [  -z ファイル ]

説明

errpt コマンドは、エラー・ログ内のエントリーからエラー・レポートを作成します。 errpt コマンドには、特定の基準に一致するエラーを選択するためのフラグが含まれています。 デフォルト条件を使用すると、エラー・ログ・エントリーを、発生時に記録したのとは逆の順序で表示することができます。 -c (concurrent) フラグを使用すると、エラーを発生した時点の状態で表示することができます。 errpt コマンドで -i フラグを使用しなければ、errpt によって処理されるエラー・ログ・ファイルは、エラー・ログ構成データベースで指定したファイルになります。 (エラー・ログ構成データベースの情報を表示するには、 エルデモン コマンドを使用します。)

デフォルトの要約レポートには、エラーごとに 1 行ずつデータが入っています。 フラグを使用すると、別のフォーマットでレポートを生成できます。

注: エラー コマンドはエラー・ログ分析を実行しません。分析するには、 ディアグ コマンドを使用します。 ただし、エラー・ログ分析を実行すると、診断によっては、 診断情報が再びエラー・ログに追加される場合があります。 このような情報は、それに対応するエラー・ログ・エントリーの明細データに続けて表示されます。

System Management Interface Tool (SMIT) の smit errpt 高速パスを使用して、このコマンドを実行できます。

フラグ

-@WPAR 名
指定された WPAR 名についてエラー・エントリーを選択します。
-a
エラー・ログ・ファイル内のエラー情報を詳細なフォーマットで表示します。 - t フラグと一緒に使用すると、テンプレート・ファイルのすべての情報が表示されます。
-A
-a フラグが作成する明細レポートの簡易バージョンを表示します。 -A フラグは、-a、-g、 または -t フラグと同時には使用できません。 報告される項目は、ラベル、日時、型、リソース名、説明、および明細データです。 このフラグの出力例は次のような形式になります。
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
各エラー・エントリーを同時に (つまりログの時点で) フォーマットして表示します。 ログ・ファイル内の既存のエントリーは、記録された順に表示されます。
-d ErrorClassリスト
エラー・レポートを、 有効な ErrorClassList 変数で指定したタイプのエラー・レコードに制限します。 この変数は、H (ハードウェア)、S (ソフトウェア)、 0 (errlogger コマンド・メッセージ)、 および U (不定) です。 ErrorClassList 変数のエラー・レコードは、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。
-D
重複するエラーを統合します。 詳細エラー・レポートは、 -a フラグで得られ、 重複の数および、最初と最後の時刻を報告します。 プログラミングの一般概念: プログラムの作成とデバッグの エラー・ロギングの概要 を参照してください。
注: -D フラグは、 「-c」、 -、 -、 T、および -P の各フラグと一緒に使用することはできません。
-e EndDate
EndDate 変数と同時か、これよりも前に追加されたすべてのレコードを指定します。この場合、 EndDate 変数のフォーマットは、mmddhhmmyy (月、日、時、分、年) です。
-g
フォーマットされていないエラー・ログ・エントリーの ASCII 表現を表示します。 このフラグの出力は次のフォーマットになります。
エレメント・シーケンス
エラー・ログ・スタンプ番号
ラベルの表示
エラー・ラベル
エレメント・タイム・スタンプ
エラー・ログ・エントリーのタイム・スタンプ
el_crcid
固有の巡回冗長検査 (CRC) エラー ID
el_machineid
マシン ID 変数
ノード ID
ノード ID 変数
エレメント・クラス
エラー・クラス
エレメント・タイプ
エラー・タイプ
El_ リソース
リソース名
el_rclass
リソース・クラス
el_rtype
リソース・タイプ
el_vpd_ibm
IBM® 重要プロダクト・データ (VPD)
el_vpd_user
ユーザー VPD
El_ イン
デバイスのロケーション・コード
EL_CONwhere
ハードウェア接続 ID (スロット番号など、特定のデバイス上の位置)
ラベルの設定
エラー・ラベル
クラスの設定
エラー・クラス
et_type
エラー・タイプ
et_desc
エラーの説明
et_prob根本原因
推定原因
ユーザー原因の設定
ユーザー原因
et_useraction
ユーザー処置
et_inst起因
インストール原因
インストールの設定
インストール処置
失敗の原因
障害原因
失敗の設定
障害処置
詳細の長さの設定
詳細データ・フィールド長
et_detail_descid
詳細データ ID
et_detail_encode
詳細データ入力フォーマットの記述
ログ・フラグの設定
ログ・フラグ
アラート・フラグの設定
警告可能なエラー・フラグ
レポート・フラグの設定
エラー・レポート・フラグ
詳細の長さ
詳細データ入力長
詳細データ (el_detail_data)
詳細データ入力
-F FlagList
以下の値に従ってエラー・レコード・テンプレートを選択します。Alert,Log、またはReportテンプレートのフィールド。 FlagList 変数は、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。 -F フラグは、-t フラグと一緒に使用する必要があります。

FlagList 変数の有効な数値は次のとおりです。

alert=0
以下を含むエラー・レコード・テンプレートを選択します。Alertフィールドは False に設定されます。
alert=1
以下を含むエラー・レコード・テンプレートを選択します。Alertフィールドを True に設定します。
log=0
以下を含むエラー・レコード・テンプレートを選択します。Logフィールドは False に設定されます。
log=1
以下を含むエラー・レコード・テンプレートを選択します。Logフィールドを True に設定します。
report=0
以下を含むエラー・レコード・テンプレートを選択します。Reportフィールドは False に設定されます。
report=1
以下を含むエラー・レコード・テンプレートを選択します。Reportフィールドを True に設定します。
ファイル
File 変数で指定したエラー・ログ・ファイルを使用します。 このフラグを指定しないと、エラー・ログ構成データベースからの値が使用されます。
- ファイル
File で指定した診断ログ・ファイルを使用します。 このフラグを指定しない場合は、デフォルトのパス名、 /var/adm/ras/diag_log が使用されます。
-j ErrorID[,ErrorID]
ErrorID (エラー ID) 変数で指定したエラー・ログ・エントリーだけを指定します。 ErrorID 変数は、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。 -t フラグと組み合わせると、エントリーはエラー・テンプレート・リポジトリーから処理されます。 (その他の場合、エントリーはエラー・ログ・リポジトリーから処理されます。)
-J ErrorLabel
ErrorLabel で指定したエラー・ログ・エントリーを指定します。 ErrorLabel 変数は、コンマで区切るか、または二重引用符で囲んでコンマまたはブランクで区切ることができます。 -t フラグと組み合わせると、エントリーはエラー・テンプレート・リポジトリーから処理されます。 (それ以外の場合、エントリーはエラー・ログ・リポジトリーから処理されます。)
-k ErrorID[,ErrorID]
ErrorID (エラー ID) 変数で指定したエラー・ログ・エントリーを除外します。 ErrorID 変数は、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。 -t フラグと組み合わせると、エントリーはエラー・テンプレート・リポジトリーから処理されます。 (その他の場合、エントリーはエラー・ログ・リポジトリーから処理されます。)
-K ErrorLabel
ErrorLabel 変数で指定したエラー・ログ・エントリーを除外します。 ErrorLabel 変数は、コンマで区切るか、または二重引用符で囲んでコンマまたはブランクで区切ることができます。 -t フラグと組み合わせると、エントリーはエラー・テンプレート・リポジトリーから処理されます。 (それ以外の場合、エントリーはエラー・ログ・リポジトリーから処理されます。)
-l SequenceNumber
SequenceNumber 変数で指定した、独自のエラー・ログ・エントリーを選択します。 このフラグは、エラー通知オブジェクト・クラス内の方式によって使用されます。 SequenceNumber 変数は、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。
-m マシン (-m)
指定した Machine 変数に関するエラー・ログ・エントリーを指定します。 uname -m コマンドは、Machine 変数の値を戻します。
ノード
指定された Node 変数のエラー・ログ項目を組み込みます。 uname -n コマンドは、Node 変数の値を戻します。
-N ResourceNameリスト
ResourceNameList 変数で指定したリソース名に関するレポートを作成します。 ResourceNameList 変数は、エラーを検出したリソース名のリストです。 ソフトウェア・エラーの場合、ResourceNameList 変数は、 エラーを検出したリソース名を表示します。 ハードウェア・エラーの場合は、 デバイス名またはシステム・コンポーネントの名前を表示します。 これは、コンポーネントに欠陥があるとか、置換が必要であることを示しているのではありません。 むしろ、エラー分析のために適切な診断モジュールを決定するのに使用されます。

ResourceNameList 変数の名前は、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。

-P
直前のエラーと重複するエラーだけを表示します。 -P フラグは、 エラー・ログ・デバイス・ドライバーが生成する重複エラーにのみ適用されます。 これらのエラーは、errdemon デーモンの、 -t フラグが制御する、 errlg_duptime エラー・ロギング属性により指定された、 おおよその時間間隔内に発生した重複エラーです。 -P フラグは、-D フラグと同時には使用できません。
-R ResourceTypeリスト
ResourceTypeList 変数で指定したリソース・タイプに関するレポートを作成します。 ハードウェア・エラーの場合、ResourceTypeList 変数はデバイス・タイプです。 ソフトウェア・エラーの場合、これは LPP 値です。 ResourceTypeList 変数の項目は、それぞれ、 , (コンマ) で区切るか、あるいは、 " " (二重引用符) で囲んで , (コンマ) またはスペース文字で区切ることができます。
-s StartDate
StartDate 変数と同時か、 それよりも後に追加されたすべてのレコードを指定します。 この場合、StartDate 変数の形式は、 mmddhhmmyy (月、日、時、年) です。
-S ResourceClassリスト
ResourceClassList 変数で指定したリソース・クラスに関するレポートを作成します。 ハードウェア・エラーの場合、ResourceClassList 変数はデバイス・クラスです。 リソース・クラスは、それぞれ、 , (コンマ) で区切るか、あるいは、 "" (二重引用符) で囲んで , (コンマ) またはスペース文字で区切る必要があります。
-t
エラー・ログの代わりにエラー・レコード・テンプレート・リポジトリーを処理します。 -t フラグを使用すれば、レポート形式でエラー・レコード・テンプレートを表示できます。
-T ErrorTypeリスト
エラー・レポートを、有効な ErrorTypeList 変数 ( INFO、 PEND、 PERF、 PERM、 TEMP、および UNKN) で指定されたエラー・タイプに制限します。 エラー・タイプは、それぞれ、, (コンマ) で区切るか、あるいは、 "" (二重引用符) で囲んで , またはスペース文字で区切ることができます。
- ファイル
File 変数で指定したエラー・レコード・テンプレート・ファイルを使用します。 -t フラグと組み合わせると、エントリーは指定したエラー・テンプレート・リポジトリーから処理されます。 (それ以外の場合、指定したエラー・テンプレート・リポジトリーが使用され、エントリーはエラー・ログ・リポジトリーから処理されます。)
-z ファイル
File 変数で指定したエラー・ログ・メッセージ・カタログを使用します。 -t フラグと組み合わせると、エントリーはエラー・テンプレート・リポジトリーから処理されます。 (それ以外の場合、エントリーはエラー・ログ・リポジトリーから処理されます。)

セキュリティー

RBAC ユーザーおよび Trusted AIX ユーザーへの注意: このコマンドは特権操作を実行できます。 特権命令を実行できるのは特権ユーザーのみです。 権限および特権について詳しくは、「 セキュリティ」の「特権コマンド・データベース」を参照してください。 このコマンドに関連した特権および権限のリストについては、lssecattr コマンドまたは getcmdattr サブコマンドの項を参照してください。
errdemon コマンドで errpt 制限が有効になっている場合に errpt コマンドを実行するには、以下の追加権限が必要です。
aix.ras.error.errpt
errpt コマンドを実行するために必要です。
注: デフォルトでは、root ユーザーとシステム・グループ・ユーザーは特権ユーザーです。

例

  1. 完全な要約レポートを表示するには、次のように入力します。
    errpt
  2. 完全な詳細レポートを表示するには、次のように入力します。
    errpt  -a
  3. エラー ID についてログに記録されたすべてのエラーの詳細報告書を表示します。E19E094F次のように入力します。
    errpt  -a  -j E19E094F
  4. 過去 24 時間以内にログに記録されたすべてのエラーの詳細なレポートを表示するには、次のように入力します。
    errpt  -a  -s mmddhhmmyy
    ここで、mmddhhmmyyストリングは、現在の月、日、時、分、および年から 24 時間を引いた値に等しくなります。
  5. エラー・ログ・エントリーに対してログ記録がオフにされているエラー・レコード・テンプレートを表示するには、次のように入力します。
    errpt  -t  -F log=0
  6. 代替エラー・ログ・ファイルのすべての項目を表示する/var/adm/ras/errlog.alternate次のように入力します。
    errpt  -i /var/adm/ras/errlog.alternate
  7. 代替エラー・ログ・ファイルからすべてのハードウェア項目を表示する/var/adm/ras/errlog.alternate次のように入力します。
    errpt  -i /var/adm/ras/errlog.alternate -d H
  8. エラー・ラベルについてログに記録されたすべてのエラーの詳細レポートを表示します。ERRLOG_ON次のように入力します。
    errpt  -a  -J ERRLOG_ON
  9. すべてのエラーおよびグループ重複エラーの詳細レポートを表示するには、次のように入力します。
    errpt -aD
  10. 8 月中のエラー・ラベル DISK_ERR1 および DISK_ERR2 に関してログに記録されたすべてのエラーの詳細レポートを表示するには、次のように入力します。
    errpt -a -J DISK_ERR1,DISK_ERR2 -s 0801000004 -e 0831235904"

ファイル

/etc/objrepos/SWservAt
エラー・ログ構成データベースであるソフトウェア保守援助プログラム属性オブジェクト・クラスが入っています。