AIX命令参考大全,卷 2,d - h - errpt 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全,卷 2,d - h

errpt 命令

用途

生成一个记录下来的错误的报表。

语法

处理从错误日志得来的报表

errpt-a ] [  -A ] [  -c ] [  -d ErrorClassList ] [  -D ] [  -e EndDate ] [  -g ] [  -i File ] [  -I File ] [  -j ErrorID,ErrorID ] ] | [  -k ErrorID,ErrorID ] ] [  -J ErrorLabel,ErrorLabel ] ] | [  -K ErrorLabel,ErrorLabel ] ] [  -l SequenceNumber ] [  -m Machine ] [  -n Node ] [  -s StartDate ] [  -F FlagList ] [  -N ResourceNameList ] [  -P ] [  -R ResourceTypeList ] [  -S ResourceClassList ] [  -T ErrorTypeList ] [  -y File ] [  -z File ]

处理从错误记录模板资源库得来的报表

errpt-a ] [  -A ] [  -I File ] [  -t ] [  -d ErrorClassList ] [  -j ErrorID,ErrorID ] ] | [  -k ErrorID,ErrorID ] ] [  -J ErrorLabel,ErrorLabel ] ] |
-K ErrorLabel,ErrorLabel ] ] [  -F FlagList ] [  -P ] [  -T ErrorTypeList ] [  -y File ] [  -z File ]

描述

errpt 命令会从错误日志中的记录生成一个错误报表。它包含了所选符合特定标准的错误的标志。利用缺省的条件,您可以以错误发生及被记录相反的顺序显示错误日志的记录。利用 - c (并行)标志,您可以在错误发生时显示这些错误。如果 -i 标志没有同 errpt 命令一起使用的话,则 errpt 处理的错误日志文件就是在错误日志配置数据库中指定的那个。(要想查看在错误日志数据库中的信息,请使用 errdemon命令。)

缺省的总结报表对每个错误包含一行数据。您可以使用标志来生成不同格式的报表。

注意: errpt 命令不会执行对错误日志的分析,要想分析它请使用 diag 命令。然而,当错误日志分析被执行时,诊断程序会将诊断信息加回到错误日志中去。这种信息会在对应的错误日志记录的详细数据后面出现。

您可以使用设备应用程序在 基于 Web 的系统管理器中来改变设备的特征。(wsm) 您还可以使用系统管理界面工具(SMIT)smit errpt 快速路径来运行这个命令。

标志

-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
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 ErrorClassList 将错误报告限定到几种特定的错误记录类型,由有效的 ErrorClassList 变量指定:H (硬件),S (软件),0 (errlogger 命令消息)和 U (未确定)。在 ErrorClassList 变量中的错误记录可以用 , (逗号)隔开,或者用 " " (双引号)括起来并用 , (逗号)或者空格符隔开。
-D 整理重复的错误。用 -a 标志得到的详细错误报表会报告编号和第一次重复及最后一次重复的时间。请参阅 AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs 中的 Error Logging Overview

注: -D 标志与 -c-g-l-t-P 标志在一起无效。
-e EndDate 指定了所有的之前贴出的记录,包含 EndDate 变量,这里 EndDate 变量具有 mmddhhmmyy 的形式(月、日、小时、分钟和年)。
-g 显示未格式化的错误日志记录的 ASCII 表示。
该标志的输出格式如下:
el_sequence
错误记录戳记编号
el_label
错误标签
el_timestamp
错误日志记录的时间戳记
el_crcid
唯一的循环冗余检验(CRC)的错误标识符
el_machineid
机器标识变量
el_nodeid
节点标识变量
el_class
错误类
el_type
错误类型
el_resource
资源名称
el_rclass
资源类
el_rtype
资源类型
el_vpd_ibm
IBM 重要产品数据(VPD)
el_vpd_user
用户 VPD
el_in
设备的位置代码
el_connwhere
硬件连接标识(在特定设备中的位置,如插槽编号)
et_label
错误标签
et_class
错误类
et_type
错误类型
et_desc
错误描述
et_probcauses
可能的原因
et_usercauses
用户的原因
et_useraction
用户操作
et_instcauses
安装原因
et_instaction
安装操作
et_failcauses
故障原因
et_failaction
故障操作
et_detail_length
详细数据字段长度
et_detail_descid
详细数据标识符
et_detail_encode
详细数据输入格式的描述
et_logflg
日志标记
et_alertflg
可警告的错误标志
et_reportflg
错误报表标志
el_detail_length
详细数据输入长度
el_detail_data
详细数据输入
-F FlagList 根据该模板的 AlertLog 或者 Report 字段的值来选择错误记录模板。FlagList 变量可以用 , (逗号)隔开,或者在 " "(双引号)括起来并用 , (逗号)或者空格符隔开。-F 标志只能与 -t 标志一起使用。

FlagList 变量的有效值包括:

alert=0
Alert 字段设置成假时选择错误记录模板。
alert=1
Alert 字段设置成真时选择错误记录模板。
log=0
Log 字段设置成假时选择错误记录模板。
log=1
Log 字段设置成真时选择错误记录模板。
report=0
Report 字段设置成假时选择错误记录模板。
report=1
Report 字段设置成真时选择错误记录模板。
-i File 使用 File 变量指定的错误日志文件。如果该标志没有被指定的话,就会使用从错误日志配置数据库中得来的值。
-I File 使用由 File 指定的诊断日志文件。如果该标志没有被指定的话,会使用缺省的路径名 /var/adm/ras/diag_log
-j ErrorID[,ErrorID] 只包括由 ErrorID(错误标识符)变量指定的错误日志记录。ErrorID 变量可以用 ,(逗号)隔开,或者在 " " (双引号)中括起来,然后用 ,(逗号)或者空格符隔开。当它与 -t 标志结合在一起时,记录是在错误模板库中被处理的。(否则,记录就是在错误日志库中被处理。)
-J ErrorLabel 包括由 ErrorLabel 变量指定的错误日志记录。ErrorLabel 变量的值可以用逗号隔开,或者括在双引号内然后用逗号或者空格隔开。当它与 -t标志结合在一起时,记录就是在错误模板库中被处理。(否则,记录就是在错误日志库中被处理。)
-k ErrorID[,ErrorID] 将由 ErrorID 变量指定的错误日志记录排除在外。ErrorID 变量可以用 ,(逗号)隔开,或者在 " " (双引号)中括起来,然后用 ,(逗号)或者空格符隔开。当它与 -t 标志结合在一起时,记录是在错误模板库中被处理的。(否则,记录就是在错误日志库中被处理。)
-K ErrorLabel ErrorLabel 变量指定的错误日志记录排除在外。ErrorLabel 变量的值可以用逗号隔开,或者括在双引号内然后用逗号或者空格隔开。当它与 -t标志结合在一起时,记录就是在错误模板库中被处理。(否则记录就是在错误日志库中被处理的。)
-l SequenceNumber 选择由 SequenceNumber 变量指定的唯一的错误日志记录。这个标志被错误通知对象类的方法所使用。SequenceNumber 变量可以用 , (逗号)隔开,或者包括在 " " (双引号)中然后用 , (逗号)或者空格符隔开。
-m Machine 包括指定的 Machine 变量的错误日志记录。uname -m 命令会返回 Machine 变量的值。
-n Node 包括了指定的 Node 变量的错误日志记录 uname -n 命令会返回 Node 变量的值。
-N ResourceNameList 生成由 ResourceNameList 变量指定的资源名称的报表。ResourceNameList 变量是已经被探测到有错误的资源的名称的列表。对于软件错误 ResourceNameList 变量会列出已经被检测到有错误的资源的名称。对于硬件错误,它会列出设备或者系统组件的名称。这并不表示组件是错误的或者需要更换。相反,它被用来确定要用合适的诊断模块来分析错误。

ResourceNameList 变量的名称可以用 , (逗号)隔开,或者在 " " (双引号)中括起来并用 , (逗号)或者空格符隔开。

-P 只显示那些是前面的错误的重复的那些错误。-P 标志只用于由错误日志设备驱动程序生成的重复错误。这些错误是在由 errlg_duptime 错误记录属性指定的近似的时间间隔内发生的重复错误,该属性由 errdemon 守护进程 -t 标志所控制。-P 标志与 -D 标志一起是非法的。
-R ResourceTypeList 生成一个由 ResourceTypeList 变量指定的资源类型的报表。对于硬件错误,ResourceTypeList 变量就是设备类型。对于软件错误,它是 LPP 值。在 ResourceTypeList 变量中的项可以用 , (逗号)隔开,或者括在 " " (双引号)内并用 ,(逗号)或者空格符隔开。
-s StartDate 指定所有张贴的在StartDate 变量后面的记录,这里 StartDate 变量的形式为 mmddhhmmyy (月,日,小时,分和年)。
-S ResourceClassList 生成由 ResourceClassList 变量指定的资源类的报表。对于硬件错误,ResourceClassList 变量就是一个设备类。资源类必须用 ,(逗号)两两隔开,或者括在 " " (双引号)内并由 , (逗号)或空格符隔开。
-t 处理错误记录模板库而不是错误日志。-t 标志可以用来以报表的形式查看错误记录模板。
-T ErrorTypeList 将错误报表限定成由有效的 ErrorTypeList 变量指定的错误类型:INFOPENDPERFPERMTEMPUNKN。错误类型可以用 , (逗号)隔开,或者括在 " " (双引号)内,并用 ,或者空格符隔开。
-y File 使用由 File 变量指定的错误记录模板文件。当它与 -t 标志结合在一起时,记录就是在指定的错误模板库中被处理。(否则,记录就是在错误日志库中用指定的错误模板库处理。)
-z File 使用 File 变量指定的错误记录消息目录。当它与 -t 标志结合在一起时,记录就是在错误模板库中被处理的。(否则,记录就是在错误日志库中被处理。)

示例

  1. 要想显示一个完整的摘要报告,请输入:

    errpt
  2. 要想显示一个完整的详细报告,请输入:
    errpt  -a
  3. 要想显示一个错误标识符 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

文件

/etc/objrepos/SWservAt 包含了软件服务辅助属性对象类;即错误日志配置数据库。

相关信息

diag 命令,errclear 命令,errinstall 命令,errupdate 命令,uname 命令。

errsave内核服务。

errlog子例程。

AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs 中的 Error Logging Overview

AIX 5L Version 5.2 General Programming Concepts 中的 Examples of Detailed Error ReportsExample of a Summary Error Report

有关安装基于 Web 的系统管理器的信息,请参阅《AIX 5L V5.2 基于 Web 的系统管理器管理指南》中的『第 2 章:安装与系统需求』

[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]