fcclear Command

Purpose

Removes FFDC Error Stacks and detail data files from the local node.

Syntax

/opt/rsct/bin/fcclear -h | [ -d filename [,filename,...] ] [ -D filename [,filename,...] ] [ -f FFDC_Failure_ID [,FFDC_Failure_ID,...] ] [ -F FFDC_Failure_ID [,FFDC_Failure_ID,...] ] [ -s file_name[,filename,...] ] [ -S file_name [,filename,...] ] [ -t days ] ]

Description

fcclear is used to remove FFDC Error Stack files that are no longer needed for problem determination efforts from the local node. Specific FFDC Error Stack files can be removed, as well as FFDC Error Stack files containing the records of specific FFDC Failure Identifiers. Individual entries within an FFDC Error Stack cannot be removed.

Using the -t option, fcclear can be used to remove FFDC Error Stack files older than a specific number of days. To use fcclear in an automatic fashion to clean out unneeded FFDC Error Stacks, see the cron command for automating the execution of commands.

To remove all FFDC Error Stacks from the local node, specify a value of zero (0) for the number of days option argument.

Flags

-d
Removes detail data files by specifying a list of one or more detail data file names. These file names may be absolute path names, or relative to the /var/adm/ffdc/dumps directory. These files are removed if they exist on the local node. Files on remote nodes cannot be removed through this command. If more than one file name is provided, they must be separated by a comma (,) without any intervening white space.
-D
Preserves detail data files by specifying a list of one or more detail data file names. These file names may be absolute path names, or relative to the /var/adm/ffdc/dumps directory. These files are retained if they exist on the local node. Files on remote nodes cannot be retained through this command. If more than one file name is provided, they must be separated by a comma (,) without any intervening white space.
-f
Removes FFDC Error Stack files by specifying a list of one or more FFDC Failure Identifiers. The FFDC Error Stacks associated with these FFDC Error Identifiers are located and removed if they are present on the local node. FFDC Error Stacks on remote nodes will not be removed. If more than one FFDC Failure Identifier is supplied, they must be separated by a comma (,) with no intervening white space.
-F
Preserves FFDC Error Stack files by specifying a list of one or more FFDC Failure Identifiers. The FFDC Error Stacks associated with these FFDC Error Identifiers are located and retained if they are present on the local node. FFDC Error Stacks on remote nodes will not be retained. If more than one FFDC Failure Identifier is supplied, they must be separated by a comma (,) with no intervening white space.
-h
Displays help and usage information to the standard output device. No other processing is performed.
-s
Removes FFDC Error Stack files by specifying a list of one or more FFDC Error Stack file names. These file names can be absolute path names or file names relative to the /var/adm/ffdc/stacks directory. These files are removed if they exist on the local node. FFDC Error Stacks on remote nodes cannot be removed through this command. If more than one file name is provided, each must be separated by a comma (,) without any intervening white space.
-S
Removes FFDC Error Stack files by specifying a list of one or more FFDC Error Stack file names. These file names can be absolute path names or file names relative to the /var/adm/ffdc/stacks directory. These files are removed if they exist on the local node. FFDC Error Stacks on remote nodes cannot be removed through this command. If more than one file name is provided, each must be separated by a comma (,) without any intervening white space.
-t
Indicates that FFDC Error Stacks and detail data files that are older than a specific number of days should be removed from the local node. This selection criteria is independent of the other selection criteria.

Exit Status

fcclear generates the following exit status values upon completion:

0
Successful completion of the command. The command may complete successfully if no FFDC Error Stack files or detail data files match the selection criteria.
2
Help information successfully displayed. No further processing is performed.
10
No files are removed from the local system. A required option was not specified to this command.
11
No files are removed from the local system. The argument of the -t option is not numeric.
12
No files are removed from the local system. Unknown option specified by the caller.
19
The directory /var/adm/ffdc/stacks does not exist or is not mounted.
26
No files are removed from the local system. The same option was specified more than once.
28
No files were removed from the system. The caller provided options that instruct the command to both remove and retain the same file. This condition can occur when the command user specified an FFDC Failure Identifier that is recorded in an FFDC Error Stack file specified by name to this command.

Examples

To remove any FFDC Error Stack and detail data files older than seven days from the local node:

fcclear -t 7

To remove all FFDC Error Stack and detail data files older than seven days, but retain the FFDC Error Stack that contains information for the FFDC Failure Identifier /3Iv04ZVVfvp.wtY0xRXQ7...................., issue the command:

fcclear -t 7 -F /3Iv04ZVVfvp.wtY0xRXQ7....................

To remove the FFDC Error Stack file that contains the record for the FFDC Failure Identifier /3Iv04ZVVfvp.wtY0xRXQ7...................., issue the command:

fcclear -f /3Iv04ZVVfvp.wtY0xRXQ7....................

To remove the FFDC Error Stack files myprog.14528.19990204134809 and a.out.5134.19990130093256 from the system, plus the detail data file myprog.14528.19990204135227:

fcclear -s myprog.14528.19990204134809,a.out.5134.19990130093256
    -d myprog.14528.19990204135227

To extend the previous command to remove the named files plus any FFDC Error Stack and detail data files older that 14 days:

fcclear -s myprog.14528.19990204134809,a.out.5134.19990130093256
    -d myprog.14528.19990204135227 -t 14

Implementation Specifics

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