fcdecode 命令

在线编辑

用途

将一个首次故障数据捕捉 (FFDC) 故障标识从它的标准格式转换为它的组成部件，并将信息以可读的格式显示在标准输出设备上。

语法

/opt/rsct/bin/fcdecode FFDC_Failure_ID [,FFDC_Failure_ID,...] | -h

描述

fcdecode 将 42 个字符长的 FFDC 故障标识解码到它的组成部件，并以可读的格式显示这些部件。 该命令的输出结果显示了来自 FFDC 故障标识中的以下信息：

  • 该报告所驻留的节点的网络地址（ASCII 格式）
  • 产生记录的时间，该时间以当前活动的时区设置来表示
  • 以下之一，取决于在哪里记录了该信息：
  • 如果记录是在该节点上的AIX®错误日志中存档，则是用于记录的AIX错误日志模板 ID，或
  • 如果信息记录归档在 FFDC 错误堆栈中且该 FFDC 错误堆栈驻留在此节点上，那么为包含该信息记录的 FFDC 错误堆栈文件名。
  • 建议使用的一个命令，该命令可用来获取与 FFDC 故障标识相关的特定报告。

标志

-h
在标准输出设备上显示帮助消息并退出。 不管指定什么选项，都不执行其他处理。

参数

FFDC_Failure_ID

对前面的 fcpushstk 和 fclogerr 命令调用所返回的一个 FFDC 故障标识，或是对前面的 fc_push_stack 子例程或 fc_log_error 子例程调用所返回的一个 FFDC 故障标识。 该标识指示创建了一个条目来报告一个故障或其他值得注意的异常事件。 可以提供一个以上的 FFDC 故障标识作为该命令的参数，但每一个标识必须用逗号（,）分隔，中间不能有空格。

退出状态

fcdecode 在结束后返回以下整数形式的状态代码之一：

0
成功解码了 FFDC 故障标识。
2
显示帮助信息，处理结束。
10
没有提供某个 FFDC 故障标识作为该命令的参数。
12
给该命令提供了无效或不支持的选项。
27
没有信息写入标准输出设备。 FFDC 故障标识参数不是一个有效参数。

示例

FFDC 故障标识由一个 base-64 数值表示，该数值按从右往左的顺序读入。 每一个点表示一个前导的零。 要将 FFDC 故障标识 .3Iv04ZVVfvp.wtY0xRXQ7....................解码为它的组成部件：

fcdecode .3Iv04ZVVfvp.wtY0xRXQ7....................

Information for First Failure Data Capture identifier
        .3Iv04ZVVfvp.wtY0xRXQ7....................
        Generated by the local system
        Generated Thu Sep 3 11:40:17 1998 EDT
        Recorded to the AIX Error Log using template 460bb505
        To obtain the AIX Error Log information for this entry, issue
        the following command on the local system:
        TZ=EST5EDT errpt -a -j 460bb505 -s 0903114098 │ more
        Search this output for an AIX Error Log entry that contains
        the following ERROR ID code:
         .3Iv04ZVVfvp.wtY0xRXQ7....................

该命令运行在另一个不同的节点上时，会有以下结果：

fcdecode .3Iv04ZVVfvp.wtY0xRXQ7....................

Information for First Failure Data Capture identifier
        .3Iv04ZVVfvp.wtY0xRXQ7....................
        Generated on a remote system with the following Internet address:
          9.114.55.125
        Generated Thu Sep 3 11:40:17 1998 EDT
        Recorded to the AIX Error Log using template 460bb505
        TZ=EST5EDT errpt -a -j 460bb505 -s 0903114098 │ more
        Search this output for an AIX Error Log entry that contains
        the following ERROR ID code:
         .3Iv04ZVVfvp.wtY0xRXQ7....................

实现细节

此命令是 Reliable Scalable Cluster Technology (RSCT) 文件集的一部分。