[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 2
fcclear Command
Purpose
Removes FFDC Error Stacks and detail data files from the local node.
Syntax
/usr/sbin/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
Related Information
Commands: fccheck, fcreport, fcstkrpt
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]