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
/opt/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.