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

fcdispfid 命令

用途

在标准错误设备上显示首次故障数据捕捉故障标识符（FFDC 故障标识符）。

语法

/usr/sbin/rsct/bin/fcdispfid [ -q ]FFDC_Failure_ID | -h

描述

脚本程序使用该命令，在标准错误设备上显示一个 FFDC 故障标识符的值。之所以提供这个接口的目的，是因为脚本程序除了通过退出状态码、信号、标准输出和标准错误以外，没有一种机制将数据传递回它的客户。在这种环境中要实现将一个 FFDC 故障标识符传递回一个客户的任务，fcdispfid 使用 XPG/4 编目消息号 2615-000 在标准错误设备上显示信息。脚本程序的客户能够捕捉标准错误信息，搜索特定的消息号以及从脚本程序中获得 FFDC 故障标识符。

脚本程序必须指示该脚本产生的任何 FFDC 故障标识符将被引导到脚本用户文档中的标准错误设备中去。缺省情况下，不能以为客户知道这种行为。

标志

-h

向标准输出设备上显示帮助信息并退出。不管指定的选项，不执行其它的处理。

-q

隐藏该命令产生的警告消息。如果没有提供该命令选项，当检测到一个无效的 FFDC 故障标识符时，该命令将显示消息。

参数

FFDC_Failure_ID

指定一个 FFDC 故障标识符。 这是调用前一个 fcpushstk 命令或 fclogerr 命令所返回的一个标识符，并指示创建了一个条目来报告脚本遇到的一个故障。使用 FFDC 消息 2615-000 将该标识符写到标准错误设备上。

退出状态

0

显示到标准错误的 FFDC 故障标识符。

2

显示帮助信息并结束进程。

12

没有信息写到标准错误设备上。指定的选项无效。

27

没有信息写到标准错误设备上。FFDC_Failure_ID 参数不像是一个有效格式。

示例

通过标准输出设备将一个 FFDC 故障标识符显示给客户：

   FID=$(fclogerr -e FFDC_ERROR -t ERRID_SP_FFDCEXMPL_ER -i /usr/lpp/ssp/inc/
myprog.h -r myprog -s myprog.ksh -p $LINEPOS -v "1.1" -l PSSP -d $MINUSDOPTS -x
$MINUSXOPTS -y $MINUSYOPTS -b "myprog Configuration Failure - Exiting")
    RC=$?
    if ((RC == 0))
    then
         fcdispfid $FID
         return 1
    else
         :
    fi

相关信息

命令：fcdecode、fcfilter、fclogerr、fcpushstk、fcreport 和 fcstkrpt

子例程：RSCT 首次故障数据捕捉编程指南和参考大全中的 fc_display_fid