samwhy

Name

samwhy - Displays information about errors that are detected by System Automation for Multiplatforms.

Synopsis

samwhy [-dhv] [-t hh[:mm[:ss]] | <#>h|m|s] [Resource_class:Resource_name[:node]]

Description

The command samwhy helps the operator to understand what happened to the applications and it also explains why System Automation for Multiplatforms reacted the way it did. samwhy uses the history of events and the history of automation decisions of System Automation for Multiplatforms and provides a readable and easy-to-understand output. The output lists the application failures that are detected by samwhy in the specified time and logs.

Options

-d, --detail

Display detailed error information.

-h, -?

Display brief help information.

-t TIME

Specify time duration. Available formats:

<#>h|m|s show last <#> hours|minutes|seconds

hh[:mm[:ss]] show last hours:minutes:seconds

-v

Display build date and version.

--help

Display extended help information.

--nocolor

Do not use colors in the output.

Exit Status

0: The command ran successfully.
1: Command stopped due to an error or timeout in an underlying command or due to user, which specifíes an invalid option.

Security

This command does not require root authority. For more information, see System Automation for Multiplatforms Administrator's and User's Guide.

Examples

Display errors, which occur in the specified time frame:

samwhy -t 20h        (last 20 hours)
samwhy -t 45m        (last 45 minutes)
samwhy -t 55s        (last 55 seconds)
samwhy -t 20:45      (last 20 hours and 45 minutes)
samwhy -t 20:45:55   (last 20 hours, 45 minutes and 55 seconds)

Display error details of the specified resource class, resource, and node:

samwhy -d IBM.Application:Res1:Node1  (resource on this node)
samwhy -d IBM.Application:Res1        (aggregate resource)

Files

/usr/sbin/rsct/bin/samwhy: Location of the samwhy command.