errpt 命令

用途

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

语法

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

errpt [ -@ wpar_name ] [ -a ] [ -A ] [ -c ] [ -d ErrorClassList ] [ -D ] [ -e EndDate ] [ -g ] [ -i 文件 ] [ -I 文件 ] [ -j ErrorID [ , 错误ID ] ] | [ -k ErrorID [ , 错误ID ] ] [ -J ErrorLabel [ , 错误标签 ] ] | [ -K ErrorLabel [ , 错误标签 ] ] [ -l SequenceNumber ] [ -m 机器 ] [ -n 节点 ] [ -s StartDate ] [ -F FlagList ] [ -N ResourceNameList ] [ -P ] [ -R ResourceTypeList ] [ -S ResourceClassList ] [ -T ErrorTypeList ] [ -y 文件 ] [ -z 文件 ]

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

errpt [ -a ] [ -A ] [ -I 文件 ] [ -t ] [ -d ErrorClassList ] [ -j ErrorID [ , 错误ID ] ] | [ -k ErrorID [ , 错误ID ] ] [ -J ErrorLabel [ , 错误标签 ] ] | [ -K ErrorLabel [ , 错误标签 ] ] [ -F FlagList ] [ -P ] [ -T ErrorTypeList ] [ -y 文件 ] [ -z 文件 ]

描述

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

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

注: 埃尔普特 命令不执行错误日志分析; 要进行分析，请使用 迪亚格 命令。然而，当错误日志分析被执行时，诊断程序会将诊断信息加回到错误日志中。这种信息会在对应的错误日志记录的详细数据后面出现。

可以使用系统管理界面工具 (SMIT) smit errpt 快速路径来运行该命令。

标志

- @wpar_name

为指定的 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 ErrorClassList

将错误报告限定到几种特定的错误记录类型，由有效的 ErrorClassList 变量指定： H （硬件），S （软件），0 （errlogger 命令消息）和 U （未确定）。在 ErrorClassList 变量中的错误记录可以用 , （逗号）隔开，或者用 " " （双引号）括起来并用 , （逗号）或者空格符隔开。

-D

整理重复的错误。使用一标志获取的详细错误报告将报告重复项的数目以及第一次和最后一次重复项。请参阅 常规编程概念: 编写和调试营销计划中的错误日志记录概述。

注: -D 标志与 -c， -g， -我， -t和 -P 标志一起使用时无效。

-e EndDate

指定了所有的之前贴出的记录，包含 EndDate 变量，这里 EndDate 变量具有 mmddhhmmyy 的形式（月、日、小时、分钟和年）。

-g

显示未格式化的错误日志记录的 ASCII 表示。该标志的输出格式如下所示：

el_序列: 错误记录戳记编号
el_标签: 错误标签
el_时间戳: 错误日志记录的时间戳记
el_crcid: 唯一的循环冗余检验 (CRC) 错误标识
埃勒机械公司: 机器标识变量
节点ID: 节点标识变量
el_class: 错误类
el_type: 错误类型
el_resource: 资源名称
el_rclass: 资源类
el_rtype: 资源类型
el_vpd_ibm: IBM® 重要产品数据 (VPD)
el_vpd_用户: 用户 VPD
el_in: 设备的位置代码
El_connwhere: 硬件连接标识（在特定设备中的位置，如插槽编号）
et_标签: 错误标签
et_class: 错误类
et_type: 错误类型
Et_desc: 错误描述
et_probcesses: 可能的原因
et_usercauses: 用户的原因
用户操作: 用户操作

et_instcauses: 安装原因
et_instaction: 安装操作
et_failcauses: 故障原因
et_failaction: 故障操作
et_detail_length: 详细数据字段长度
et_detail_descid: 详细数据标识
et_detail_编码: 详细数据输入格式的描述
et_logflg: 日志标志
et_alertflg: 可警告的错误标志
et_reportflg: 错误报表标志
el_detail_length: 详细数据输入长度
el_详细数据: 详细数据输入

-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。

-i 文件

使用由 File 变量指定的错误日志文件。如果该标志没有被指定的话，就会使用从错误日志配置数据库中得来的值。

-I 文件

使用由 File 指定的诊断日志文件。如果未指定此标志，那么将使用缺省路径名 /var/adm/ras/diag_log。

-j 错误ID [, 错误ID ]

只包括由 ErrorID（错误标识）变量指定的错误日志记录。 ErrorID 变量可以用 ,（逗号）隔开，或者在 " "（双引号）中括起来，然后用 ,（逗号）或者空格符隔开。当它与 -t 标志结合在一起时，记录是在错误模板库中被处理的。（否则，记录就是在错误日志库中被处理。）

-J ErrorLabel

包括由 ErrorLabel 变量指定的错误日志记录。 ErrorLabel 变量的值可以用 ,（逗号）隔开，或者括在 ""（双引号）内然后用 ,（逗号）或者空格隔开。当它与 -t 标志结合在一起时，记录就是在错误模板库中被处理的。（否则，记录就是在错误日志库中被处理。）

-k 错误ID [, 错误ID ]

将由 ErrorID 变量指定的错误日志记录排除在外。 ErrorID 变量可以用 ,（逗号）隔开，或者在 " "（双引号）中括起来，然后用 ,（逗号）或者空格符隔开。当它与 -t 标志结合在一起时，记录是在错误模板库中被处理的。（否则，记录就是在错误日志库中被处理。）

-K ErrorLabel

将 ErrorLabel 变量指定的错误日志记录排除在外。 ErrorLabel 变量的值可以用 ,（逗号）隔开，或者括在 ""（双引号）内然后用 ,（逗号）或者空格隔开。当它与 -t 标志结合在一起时，记录就是在错误模板库中被处理的。（否则记录就是在错误日志库中被处理的。）

-l SequenceNumber

选择由 SequenceNumber 变量指定的唯一的错误日志记录。此标志被错误通知对象类的方法所使用。 SequenceNumber 变量可以用 ,（逗号）隔开，或者在 " "（双引号）括起来并用 ,（逗号）或者空格符隔开。

-m 机器

包括指定的 Machine 变量的错误日志记录。 uname -m 命令会返回 Machine 变量的值。

-n 节点

包括了指定的 Node 变量的错误日志记录。 uname -n 命令会返回 Node 变量的值。

-N ResourceNameList

生成由 ResourceNameList 变量指定的资源名称的报表。 ResourceNameList 变量是已经被探测到有错误的资源的名称的列表。对于软件错误 ResourceNameList 变量会列示已经被检测到有错误的资源的名称。对于硬件错误，它会列示设备或者系统组件的名称。这并不表示组件是错误的或者需要更换。相反，它被用来确定要用合适的诊断模块来分析错误。

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

-P

只显示那些是前面的错误的重复的那些错误。 -P 标志只用于由错误日志设备驱动程序生成的重复错误。这些错误是在由 埃尔代明 守护程序 -t 标志控制的 errlg_duptime 错误日志记录属性指定的大致时间间隔内发生的重复项。 -P 标志与 -D 标志一起是非法的。

-R ResourceTypeList

生成一个由 ResourceTypeList 变量指定的资源类型的报表。对于硬件错误， ResourceTypeList 变量就是设备类型。对于软件错误，它是 LPP 值。在 ResourceTypeList 变量中的项可以用 ,（逗号）隔开，或者括在 " "（双引号）内并用 ,（逗号）或者空格符隔开。

-s StartDate

指定所有张贴在 StartDate 变量中和后面的记录，这里 StartDate 变量的形式为 mmddhhmmyy （月，日，小时，分和年）。

-S ResourceClassList

生成由 ResourceClassList 变量指定的资源类的报表。对于硬件错误， ResourceClassList 变量就是一个设备类。资源类必须用 ,（逗号）两两隔开，或者括在 " " （双引号）内并由 ,（逗号）或空格符隔开。

-t

处理错误记录模板库而不是错误日志。 -t 标志可以用来以报表的形式查看错误记录模板。

-T ErrorTypeList

将错误报表限定成由有效的 ErrorTypeList 变量指定的错误类型：INFO、PEND、PERF、PERM、TEMP 和 UNKN。错误类型可以用 ,（逗号）隔开，或者括在 " "（双引号）内，并用 ,（逗号）或者空格符隔开。

-y 文件

使用由 File 变量指定的错误记录模板文件。当它与 -t 标志结合在一起时，记录就是在指定的错误模板库中被处理。（否则，记录就是在错误日志库中用指定的错误模板库处理。）

-z 文件

使用 File 变量指定的错误记录消息目录。当它与 -t 标志结合在一起时，记录就是在错误模板库中被处理的。（否则，记录就是在错误日志库中被处理。）

安全性

RBAC 用户和可信 AIX 用户注意: 此命令可以执行特权操作。只有特权用户才能执行特权限定的操作。有关权限和特权的更多信息，请参阅安全中的 Privileged Command Database。要获取与此命令相关联的特权和权限的列表，请参阅 lssecattr 命令或 getcmdattr 子命令。

要运行 errpt 命令，如果在 errdemon 命令中启用了 errpt 限制，那么您必须具有以下附加权限:

aix.ras.error.errpt: 需要此参数才能运行 errpt 命令。

注: 缺省情况下， root 用户和系统组用户是特权用户。

示例

要想显示一个完整的摘要报告，请输入：
```
errpt
```
要想显示一个完整的详细报告，请输入：
errpt -a
要显示针对错误标识记录的所有错误的详细报告E19E094F，请输入:
errpt -a -j E19E094F
要想显示一个在过去 24 小时内记录下来的所有错误的详细报表，请输入：
errpt -a -s mmddhhmmyy
其中mmddhhmmyy字符串等于当前月份，日期，小时，分钟和年份，减去 24 小时。
要想列示为其日志为任何错误日志记录关闭的错误记录模板，请输入：
errpt -t -F log=0
要查看备用错误日志文件中的所有条目/var/adm/ras/errlog.alternate，请输入:
errpt -i /var/adm/ras/errlog.alternate
要查看备用错误日志文件中的所有硬件条目/var/adm/ras/errlog.alternate，请输入:
errpt -i /var/adm/ras/errlog.alternate -d H
要显示针对错误标签记录的所有错误的详细报告ERRLOG_ON，请输入:
errpt -a -J ERRLOG_ON
要想显示所有错误的详细报表并给重复错误进行分组，请输入：
```
errpt -aD
```
要显示 8 月份期间对于错误标签 DISK_ERR1 和 DISK_ERR2 记录下来的所有错误的详细报表，请输入：
```
errpt -a -J DISK_ERR1,DISK_ERR2 -s 0801000004 -e 0831235904"
```

文件

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