IBM Support

IBM AIX Diagnostic Tool "summ". A Summarized System Error log and Report Generator for I/O devices.

General Page

This document describes the summ tool, its options and use cases for summarizing and decoding AIX I/O error messages.

NAME
summ

PURPOSE
Diagnostic tool for decoding and summarizing AIX I/O error messages

SYNTAX
summ [Flags] [Filename]

FLAGS
-e  Include FC driver error numbers for each error.
-p  Paginate the output.
-r  Reverse the order of output.
-s  Include sequence numbers in each line's header.
NOTE: summ --help displays the flags presented above.

DESCRIPTION
"summ" is an AIX only diagnostic tool used to decode fibre-channel and SCSI disk AIX error report entries. It is an invaluable tool that can aid in diagnosing storage array or SAN fabric related problems providing the source of the error.  

The script generates single line error messages enhancing the readability of the AIX error report. This is the same tool used by IBM Support worldwide and is considered safe to run in a production environment.

USAGE
The summ command can process results of the AIX error log from a file or from standard input:

From a file:
# errpt -a > errpt.out
# summ errpt.out

From standard input:
# errpt -a | summ

Use continuous errpt option flag to watch errors in real time while the messages are logged to the AIX error report:
# errpt -ac | summ
DEPENDENCY:
The summ command depends on the version of the perl command shipped with AIX. Perl fileset is available in each level of AIX as shown at the following link:
http://www-01.ibm.com/support/docview.wss?uid=isg1fileset434767588
Also, “summ” only accepts output in the "errpt -a" format.
 

DOWNLOAD

NOTE: The summ script is provided as a courtesy, and it is provided as-is, without warranty and without guarantee of having no defects. Support for this script is not available.
Click on this summ link to download the summ utility. After downloading the summ_version_1.tar file, transfer this file to your AIX system into the /tmp directory as /tmp/summ_version_1.tar. While logged in as the root user, execute the following commands to install the summ command into the /usr/local/bin directory:

# cd /usr/local/bin

# tar -xvf /tmp/summ_version_1.tar

# chmod 755 summ

 

EXAMPLE
The following snippet of data is an output generated upon running summ on an AIX Server. These are just some of the common decoded errors available and are presented below for exemplification purposes only:

Jul  4 16:18:27 fcs1       I FCA_ERR12           INFO: Adapter link up recovery;link failure cnt 0000000A
Jul  4 16:15:55 fcs1       T FCA_ERR4            Adapter link up failure

Jun 21 09:54:07 hdisk10   P SC_DISK_ERR7        path  4 path failure; WRITE(10)        (0xLogical_Block_Address, <Transfer Length Value>) transport dead
Jun 21 09:54:07 fscsi3     T FCP_ERR4            Adapter driver rejected I/O request for port 0xSCSI_ID; ENETDOWN

May 10 04:13:48 fscsi0     I FCP_ERR10           Target port 0xSCSI_ID  <WWPN#> has recovered
May 10 03:54:05 hdisk9     P SC_DISK_PCM_ERR8    path  # path failure
May 10 03:35:10 fscsi0     T FCP_ERR14           NS GID_PN reject wwpn <WWPN#>; Port Name not registered

Apr 11 22:07:25 hdisk11    I SDDPCM_PATH_RECOVER Path ID 5
Apr 11 22:05:54 hdisk11    P SC_DISK_ERR7        path  5 path failure; WRITE(10)        (0xLogical_Block_Address, <Transfer Length Value>) command timeout
Apr 11 22:04:31 hdisk11    T SC_DISK_ERR4        path  5 READ(10)         (0xLogical_Block_Address, Transfer Length Value) transport fault
Apr 11 22:04:30 fscsi0     T FCP_ERR4            Error detected receiving from port 0xSCSI_ID (possible marginal link)

Mar 12 18:26:44 hdisk1     T SC_DISK_ERR9        path  6 WRITE(10)        (0xLogical_Block_Address, <Transfer Length Value>) RESERVATION CONFLICT
Mar 12 18:26:42 hdisk1     P SC_DISK_ERR10       path  7 TEST UNIT READY  RESERVATION CONFLICT

Feb 21 16:29:43 fscsi3     T FCP_ERR4            dynamic tracking failed for port 0xSCSI_ID; ENETDOWN
Feb 21 16:29:43 fscsi3     T FCP_ERR4            Relogin <NPIV Client WWPN#> to port 0xFFFFFC rejected; ENETDOWN

AIX SUPPORT:

If additional assistance is required to further troubleshoot the problem, please follow the step-by-step instructions below to contact IBM to open a case for software under warranty or with an active and valid support contract.  The technical support specialist assigned to your case will confirm that you have completed these steps.

a.  Capture snap data from the sever experiencing the problem using the commands shown below:

 

b.  Contact IBM to open a case:

   -For electronic support, please visit the IBM Support Community:
     https://www.ibm.com/mysupport
   -If you require telephone support, please visit the web page:
      https://www.ibm.com/planetwide/

c.  Provide a good description of your issue and if any changes were made to the system.

d.  Upload all of the details and data to your case

   -You can attach files to your case in the IBM Support Community
   -Or Upload data to IBM testcase server analysis:

    http://www.ibm.com/support/docview.wss?uid=ibm10733581

Document was written by Raul Salajan on September 18, 2019 with contributions from Steven Lang.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SWG10","label":"AIX"},"Component":"","Platform":[{"code":"PF002","label":"AIX"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Document Information

Modified date:
25 March 2020

UID

ibm11072626