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

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

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

fcteststk 命令

用途

测试“首次故障数据捕获错误堆栈(First Failure Data Capture Error Stack)”环境的存在。

语法

/usr/sbin/rsct/bin/fcteststk [-q] | [-h]



描述

fcteststk 可以被希望通过 FFDC 错误堆栈测试这些设备是否已被激活的任何应用程序调用。通过进行这种测试,应用程序可以避免收集故障信息时的性能负担,在 FFDC 环境 没有建立起来的情况。此接口主要通过库例程被提供,库例程对于它们的客户应用程序是否建立或者是否继承了 FFDC 环境 还不知道。

当进程希望从本身得到故障信息,创建的任何线程和任何派生进程记录到 FFDC 错误堆栈,FFDC 错误堆栈环境被进程建立了。当进程希望向 FFDC 错误堆栈文件记录故障信息的时候,只有当祖先进程之一要求进程这样做的时候,FFDC Error Stack 环境 才会被进程继承;在其它情况下,进程不会向 FFDC 错误堆栈中记录故障信息。进程使用 fcinit 建立或者继承“FFDC 错误堆栈环境”。

“FFDC 错误堆栈环境”保留一个 FFDC 错误堆栈文件,以便故障信息能够被记录在 /var/adm/ffdc/stacks 目录中的文件。这些文件采用 script_name.PID.date_and_time 的命名格式,这里 script_name 是脚本本身的名字PID 是脚本的进程标识,date_and_time 是脚本执行的日期和时间。无论何时脚本或者脚本的子进程向“FFDC 错误堆栈”中记录故障信息,它都将记录到这个文件中。

应用程序使用 fcpushstk 接口来向 FFDC 错误堆栈中记录故障信息。在记录这些信息之前,应用程序也许需要从各种不同的位置来收集信息,获得这些信息能影响应用程序的全面性能。如果 FFDC Error Stack 环境没有建立或者被继承,应用程序不必收集这些信息。为了避免这种性能影响,应用程序可以调用 fcteststk 来决定是否可以得到 FFDC Error Stack 环境如果可以得到就开始收集故障信息。如果 FFDC Error Stack 环境 不存在,那么应用程序可以避免收集这种信息。

FFDC 环境 存在的时候,使用fclogerr FFDC 接口的进程可以使用 fclogerr ,无论 FFDC 错误堆栈是否被 FFDC 环境 在使用。无论何时使用 fclogerr ,故障信息都会记录到 AIX 错误日志和 BSD 系统日志中,无论 FFDC 错误堆栈是否被保留。使用 fclogerr 接口记录信息的应用程序必须总是收集故障信息并记录它,无论 FFDC 错误堆栈是否被使用。

标志

-h 对这个命令显示用法消息。不执行进一步的处理。
-q 禁止从解释 FFDC 环境是否被建立的命令的输出。命令的用户将会被要求从决定是否为这个进程建立了 FFDC 环境的命令来检查退出状态。

参数

FFDC_Failure_ID

指定故障的 FFDC 故障标识来开始报告。fcreport 将会试图为故障获得故障信息,以及这个报告作为相关故障列出的任何故障。可能只有一个 FFDC 故障标识提供给了这个命令。

安全性

fcreport 使用 rsh 来获得也许驻留在远程节点上的故障报告。用户必须有足够的权限来执行这些用于远程节点的 rsh 命令。如果用户没有这个许可,只要它们在本地节点存在,fcreport 就只能追踪到相关故障的列表。

退出状态

0
存在 FFDC 错误堆栈环境。
2
显示帮助信息并结束进程。
12
没有进行处理。指定的选项无效。
15
用户没有及时在该点建立或者继承 FFDC 错误堆栈环境。
17
FFDC 错误堆栈环境很可能损坏并且应该被视为是不可用的。

示例

要检测应用程序的 FFDC 错误堆栈环境是否存在:

fcteststk -q
if (($? == 0))
then    # Collect failure information
         :
         :
    # Use fcpushstk to record failure info
         :
         :
fi

相关信息

命令:fcinitfcpushstk

子例程:fc_test_stack(请参考 RSCT First Failure Data Capture Programming Guide and Reference

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