fcdecode Command

Purpose

Translates a First Failure Data Capture (FFDC) Failure Identifier from its standard form into its component parts, displaying this information to the standard output device in human readable format.

Syntax

/usr/sbin/rsct/bin/fcdecode FFDC_Failure_ID [,FFDC_Failure_ID,...] | -h

Description

fcdecode decodes the 42-character FFDC Failure Identifier into its component parts, and displays these parts in human readable format. The output of this command displays the following information, extracted from the FFDC Failure Identifier:

The network address (in ASCII format) of the node where this report resides
The time when this recording was made, expressed using the currently active time zone settings
One of the following, depending on where the information is recorded:
The AIX® Error Log template ID used to make this recording, if the record was filed in the AIX Error Log on that node, or
The name of the FFDC Error Stack file containing this recording, if the record was file in the FFDC Error Stack and the FFDC Error Stack resides on this node
A suggested command that can be used to obtain the specific report associated with this FFDC Failure Identifier.

Flags

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

Parameters

FFDC_Failure_ID: An FFDC Failure Identifier, returned from previous calls to the fcpushstk and fclogerr commands, or returned from previous calls to the fc_push_stack or fc_log_error subroutines. This identifier indicates an entry made to report a failure or other noteworthy incident. More than one FFDC Failure Identifier can be provided as an argument to this command, however, each identifier must be separated by a comma (,) with no intervening white space between the identifiers.

Exit Status

fcdecode returns one of the following integer status codes upon completion:

0: FFDC Failure Identifier successfully decoded.
2: Help information displayed and processing ended.
10: An FFDC Failure Identifier was not provided as an argument to this command.
12: Invalid or unsupported option provided to this command.
27: No information written to the standard output device. The FFDC Failure Identifier argument was not valid.

Examples

The FFDC Failure Identifier is represented by a base-64 value, read from right to left. Each dot represents a leading zero. To decode the FFDC Failure Identifier .3Iv04ZVVfvp.wtY0xRXQ7....................into its component parts:

fcdecode .3Iv04ZVVfvp.wtY0xRXQ7....................

Information for First Failure Data Capture identifier
        .3Iv04ZVVfvp.wtY0xRXQ7....................
        Generated by the local system
        Generated Thu Sep 3 11:40:17 1998 EDT
        Recorded to the AIX Error Log using template 460bb505
        To obtain the AIX Error Log information for this entry, issue
        the following command on the local system:
        TZ=EST5EDT errpt -a -j 460bb505 -s 0903114098 │ more
        Search this output for an AIX Error Log entry that contains
        the following ERROR ID code:
         .3Iv04ZVVfvp.wtY0xRXQ7....................

The same command run on a different node has the following results:

fcdecode .3Iv04ZVVfvp.wtY0xRXQ7....................

Information for First Failure Data Capture identifier
        .3Iv04ZVVfvp.wtY0xRXQ7....................
        Generated on a remote system with the following Internet address:
          9.114.55.125
        Generated Thu Sep 3 11:40:17 1998 EDT
        Recorded to the AIX Error Log using template 460bb505
        TZ=EST5EDT errpt -a -j 460bb505 -s 0903114098 │ more
        Search this output for an AIX Error Log entry that contains
        the following ERROR ID code:
         .3Iv04ZVVfvp.wtY0xRXQ7....................

Implementation Specifics

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