[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 2

fcfilter Command


Locates and displays any First Failure Data Capture (FFDC) Failure Identifiers in a file or in standard input. More than one file may be specified.


/usr/sbin/rsct/bin/fcfilter [ file_name ] [ . . . ]


This commands scans any files listed as arguments for First Failure Data Capture (FFDC) Failure Identifiers. If a file name is not provided as an argument, this command examines standard input for FFDC Failure Identifiers. If an FFDC Failure Identifier is detected, fcfilter displays the identifier to standard output on its own line.

fcfilter can be used by scripts to extract FFDC Failure Identifiers returned by child processes via the standard error device.

If fcfilter detects more than one FFDC Failure Identifier in the input, the command will display all FFDC Failure Identifiers found, each one on a separate output line.


Displays a help message to standard output and exits. No other processing is performed, regardless of the options specified.
Suppresses warning messages from this command. If this option is not provided, this command will display messages when an invalid FFDC Failure Identifier is detected.



The name of the file to be searched for an FFDC Failure Identifier. More than one file may be provided. If a file name is not provided, fcfilter reads from standard input.

Exit Status

fcfilter returns the following integer status codes upon completion:

fcfilter completed its execution. This exit status does not necessarily mean that any FFDC Failure Identifiers were detected.
> 0
fcfilter was interrupted or stopped by a signal. The exit status is the integer value of the signal that stopped the command.


The FFDC Failure Identifier is represented by a base-64 value, read from right to left. Each dot represents a leading zero. To obtain the list of all FFDC Failure Identifiers generated by a run of the command mycmd:

 mycmd 2> /tmp/errout
 fcfilter /tmp/errout

To obtain the FFDC Failure Identifier from a child process in a parent script, the script can use the fcfilter command as follows:

RESULTS=$(mychild 2> /tmp/errout)
if (($? != 0))               # mychild ended in failure, get FFDC ID
    cat /tmp/errout | fcfilter | read FIRST_FFDCID
    rm -f /tmp/errout

Related Information

Commands: fcdispfid, fclogerr, fcpushstk, fcreport, fcstkrpt

Subroutines: fc_display_fid, fc_log_error, fc_push_stack (see the RSCT First Failure Data Capture Programming Guide and Reference)

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]