fcfilter 命令

用途

在一个文件或标准输入中发现并显示任何一个首次故障数据捕捉 (FFDC) 故障标识。 可能指定了多个文件。

语法

/opt/rsct/bin/fcfilter[file_name] [. . . ]

描述

该命令扫描作为参数列示的任何文件，以获得首次故障数据捕捉 (FFDC) 故障标识。 如果没有提供一个文件名作为参数，该命令从标准输入中搜索 FFDC 故障标识。 如果检测到一个故障标识，fcfilter 在标准输出中该行显示标识。

脚本程序能使用 fcfilter 命令获取子进程通过标准错误设备返回的 FFDC 故障标识。

如果 fcfilter 在输入中检测到多个 FFDC 故障标识，该命令将显示所有被发现的 FFDC 故障标识，在每一输出行中显示一个。

参数

file_name

用于搜索一个 FFDC 故障标识的文件名。 可能提供多个文件。 如果没有给出文件名，那么 fcfilter 从标准输入中读入。

退出状态

fcfilter 在结束时返回以下整数形式的状态代码：

0

fcfilter 结束执行。 该退出状态并不一定表示检测到了任何的 FFDC 故障标识。

> 0

fcfilter 被一个信号所中断或停止。 退出状态是一个整数信号值，正是该信号停止了该命令的运行。

示例

FFDC 故障标识由一个 base-64 数值表示，该数值按从右往左的顺序读入。 每一个点表示一个前导的零。 要获得 mycmd 命令运行所产生的所有 FFDC 故障标识的列表：

 mycmd 2> /tmp/errout
 fcfilter /tmp/errout
/.00...JMr4r.p9E.xRXQ7....................
/.00...JMr4r.pMx.xRXQ7....................

要获得来自父脚本程序中一个子进程的 FFDC 故障标识，该脚本程序可如下使用 fcfilter 命令：

RESULTS=$(mychild 2> /tmp/errout)
if (($? != 0))               # mychild ended in failure, get FFDC ID
then
    cat /tmp/errout │ fcfilter │ read FIRST_FFDCID
else
    rm -f /tmp/errout
fi

实现细节

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