Commands Reference, Volume 2

fcfilter Command

Purpose

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.

Syntax

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

Description

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.

Flags

-h

Displays a help message to standard output and exits. No other processing is performed, regardless of the options specified.

-q

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.

Parameters

file_name

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:

0

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.

Examples

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
/.00...JMr4r.p9E.xRXQ7....................
/.00...JMr4r.pMx.xRXQ7....................

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
then
    cat /tmp/errout | fcfilter | read FIRST_FFDCID
else
    rm -f /tmp/errout
fi

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)