Purpose
Performs basic problem determination
on the First Failure Data Capture (FFDC) utilities.
Syntax
/usr/sbin/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.