Purpose
Displays the contents of an FFDC
Error Stack file.
Syntax
/usr/sbin/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.