fccheck Command

Purpose

Performs basic problem determination on the First Failure Data Capture (FFDC) utilities.

Syntax

/opt/rsct/bin/fccheck [ -q ] | [ -h ]

Description

fccheck performs basic problem determination for the First Failure Data Capture utilities. The command checks for the following conditions and information on the local node:

  • Checks if FFDC Error Stack usage has been disabled in the current process environment.
  • Obtains the IP address that would be currently used by FFDC to identify the local node.
  • Checks if /var/adm/ffdc/stacks is available, and if so, how much space is available in the file system where the directory resides. Checks to see if there is insufficient space to create FFDC Error Stacks.
  • Checks if /var/adm/ffdc/dumps is available, and if so, how much space is available in the file system where the directory resides.

Results of these tests are displayed to standard output unless the "quiet" option has been specified. fccheck sets an exist status value to indicate the most severe condition it detected during the execution of its tests.

Flags

-h
Displays help and usage information to standard output. No other processing is performed.
-q
Specified "quiet" mode. The command does not display the results of each test to standard output. The exit status of the command must be used to determine the results of the tests. If more than one condition was detected, the exit status will reflect the most severe condition detected by fccheck.

Exit Status

The following integer exit status codes can be generated by this command:

0
All conditions tested by fccheck were found to be in normal operational parameters.
2
Help information successfully displayed. No further processing is performed.
12
No checking performed. Invalid option specified to this command.
19
The directory /var/adm/ffdc/stacks is not mounted or does not exist.
20
Cannot access or examine one or more directories in the path /var/adm/ffdc/stacks. Permissions may have been changed on one or more of the directories in this path to prevent access.
24
Cannot access or examine one or more directories in the path /var/adm/ffdc/dumps. Permissions may have been changed on one or more of the directories in this path to prevent access.
32
The directory /var/adm/ffdc/dumps is not mounted or does not exist.
40
Insufficient space is available in the /var/adm/ffdc/stacks directory to create FFDC Error Stacks on the local node.
41
Unable to obtain file system information from the operating system. This indicates a potential problem with the operating system itself.
42
FFDC Error Stack creation and usage has been disabled in this process environment.

Examples

To check for possible problems with the FFDC utilities on the local node:

fccheck
fccheck Status: All tests completed

If the local node had disabled the creation of FFDC Error Stacks, fccheck would indicate this as a problem:

fccheck

fccheck Status: Creation and use of FFDC Error Stacks has been expressly 
disabled in the current execution environment. Any processes created in 
the current execution environment cannot create their own FFDC Error Stacks 
or inherit use of existing FFDC Error Stacks.

fccheck Status: All checks completed. Examine the previous status output for 
possible FFDC problem conditions and take the recommended actions listed in 
these messages. 

Implementation Specifics

This command is part of the Reliable Scalable Cluster Technology (RSCT) fileset.