fcstkrpt Command

Purpose

Displays the contents of an FFDC Error Stack file.

Syntax

/opt/rsct/bin/fcstkrpt { [-a] [-p-r] { -f FFDC_Failure_Identifier [ -i ] │ -s FFDC_Error_Stack_File_Name } } │ [-h ]

Description

fcstkrpt reads an existing FFDC Error Stack file and displays its contents to the standard output device. The FFDC Error Stack file is indicated either through the name of the file itself, or by using an FFDC Failure Identifier that references a specific record within that file.

Information from the FFDC Error Stack can be displayed in one of two formats: by related failure conditions (the default) or by software layer.

Flags

-a
Indicates that all information be displayed for entries in the FFDC Error Stack. The default action is to display the time stamp for the record and the description of the incident.
-f
Specifies the FFDC Failure Identifier to use in locating the FFDC Error Stack. fcstkrpt decodes the FFDC Failure Identifier, locates the FFDC Error Stack associated with that FFDC Failure Identifier, and processes the FFDC Error Stack. Only one FFDC Failure Identifier can be specified by this flag.
-h
Displays a help message to standard output and exits. No other processing is performed regardless of the options specified.
-i
Displays only the information associated with the specific failure report identified by the -f flag. By default, all records in the FFDC Error Stack are displayed.
-p
Displays information from the FFDC Error Stack by process orientation. The output is ordered so that it reflects the order in which the processes were created (parent-child process relationship). Child process information is shown first, followed by parent process information. This view is used to understand which incidents occurred first, and which incidents occurred later because of them.
-r
Displays information from the FFDC Error Stack by incident relationships. Incidents are presented along with those incidents that are related to them. This view is used to understand which incidents occurred because of the occurrence of other incidents. This is the default.
-s
Specifies the name of the FFDC Error Stack to be examined. This name may be either the absolute or relative path name of the FFDC Error Stack. Only one FFDC Error Stack file name can be specified by this flag. If a relative file name is used, the file is assumed to be located in the /var/adm/ffdc/stacks directory of the node where the file resides.

Parameters

FFDC_Failure_ID
Specifies the FFDC Failure Identifier of the failure to begin the report. fcreport will attempt to obtain the failure information for this failure, as well as any failures that this report lists as an associated failure. Only one FFDC Failure Identifier may be provided to this command.

Security

fcreport uses rsh to obtain failure reports that may reside on remote nodes. The user must have sufficient privilege to execute rsh commands to these remote nodes. If the user does not have this permission, fcreport can only trace the list of related failures so long as they exist on the local node.

Exit Status

fcstkrpt issues the following integer exit status codes upon completion:

0
FFDC Error Stack file successfully located, and contents displayed to the standard output device.
2
Help information displayed and processing ended.
12
An invalid option was specified.
14
No information written to the standard output device. The -f option was used and the FFDC Error Identifier argument was not valid.
20
No information written to the standard output device. The -s option was used and the FFDC Error Stack File argument was not found.
27
No information written to the standard output device. The caller provided a valid FFDC Failure Identifier, but the file referenced by the FFDC Failure Identifier was not recorded on this node. Use the fcdecode command to locate the node where this FFDC Error Stack resides.
81
No information written to the standard output device. A failure occurred while writing information to standard output. The application should conclude that standard output cannot accept output.
85
No information written to the standard output device. The caller provided a valid FFDC Failure Identifier, but the file referenced by the FFDC Failure Identifier does not exist.

Examples

To obtain a brief report of the information stored in the FFDC Error Stack file /var/adm/ffdc/stacks/myprog.562.19981001143052:

$ fcstkrpt -r -s myprog.562.19981001143052

To obtain a detailed report of the information contained in the FFDC Error Stack where the FFDC Failure Identifier .3Iv04ZVVfvp.wtY0xRXQ7.................... was recorded, and present this information in parent-child ordering:

$ fcstkrpt -p -f .3Iv04ZVVfvp.wtY0xRXQ7....................

Implementation Specifics

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