i Can … Display the Status of Your IOA Cache Batteries

I assume most of you are familiar with the I/O adapters that have cache batteries on them and the importance of monitoring the status of those batteries to ensure they are replaced before they fail. In case you’re not: the IOA has a cache to improve performance; the application doesn’t have to wait for the data to be written to the disk. The cache is powered by a battery in the IOA to ensure the cache data is preserved even if the IOA is powered off or reset. However, if the cache battery is failing, then the data is written directly to disk and the cache isn’t used, which can result in significant performance degradation. As such, you should know when the cache batteries are failing to get them replaced before it affects your application's performance. 

Various ways to display the status of your cache batteries exist, including one very new method that we’ve recently made available via PTFs. I'm only going to briefly summarize the existing methods of checking the battery status, since I really want to share the new information.

The system is aware when the cache batteries start to fail, and sends message CPPEA13 to the QSYSOPR message queue.  The first-level message text for this message is somewhat vague – “Contact your hardware service provider.” However, in the recovery section of the message it says you should have the cache battery replaced. When this message is sent to QSYSOPR, you’ll also have a problem created in the problem log, and you can use WRKPRB to display the problem details.

You can use the Work with Disk Status (WRKDSKSTS) command to determine if you have cache batteries requiring attention. Press F11 to get to the second panel; if the status for the disk unit is DEGRADED, it’s possible the issue is due to failing cache batteries. If your drives are mirrored, however, they’ll always show ACTIVE status and you must use one of the alternative ways to check the cache battery status.

There are a two different ways you can view your cache battery status using System Service Tools (STRSST): 

1. You can use the Hardware Service Manager to work with resources containing cache battery packs, which will show you the resources that have cache batteries, and you can then display the battery information.

2. You can use the Display/Alter/Dump service function to invoke the batteryinfo Advanced Analysis feature to display the status of your cache batteries.


And now for the news: some recent PTFs (one for each supported release) now provide a simple program that you can call that to display the cache battery status.  They are:

7.1 - SI40406
6.1 - SI40404
5.4 - SI40403

To display the cache battery information, simply run the following:

CALL QSYS/QSMBTTCC

This will create a spool file containing the cache battery information for the IBM i partition where the function is run. To use this function you must have *SERVICE special authority, or be authorized to the Service Trace function. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform this operation.

Comments

[Tom]

Hi Dawn,

Could you please elaborate on this..
"You can use the Display/Alter/Dump service function to invoke the batteryinfo Advanced Analysis feature to display the status of your cache batterie"

I am looking for a programming way to get the cache battery info but unable to find a way. Any help on this would be greatly appreciated.

Regards,

Tom.

[Dawn]

Hi Tom,
The Display/Alter/Dump service function is an interactive interface through System Service Tools (STRSST).

For a programmatic interface, you will want to look at the PTFs I reviewed - they give you a program to call to get the status. The output from the program call goes to a spooled file.

Hope this helps.
Dawn

[Rob Berendt]

For obsolete hardware which will not run these new ptf's, nor have the display cache battery option in SST you do it this way:
STRSST
1. Start a service tool
4. Display/Alter/Dump
1. Display/Alter storage
2. Licensed Internal Code (LIC) data
14. Advanced analysis
1=Select BATTERYINFO
Options . . . . . -list -all
But that really doesn't tell you jack
Concurrently Can Be
Resource Serial Type Frame Card Maintainable Safely
Name Number Model ID Position Battery Pack Replaced
DC09 YL1088121002 57B7-001 3C00 C9 Yes No
You miss all the date information.

Doesn't the newer SST option show you so much more information than the old Advanced Analysis method?
Battery Information
Resource name . . . . . . . . . . . : DC09
Serial number . . . . . . . . . . . : YL1088121002
Actual type-model . . . . . . . . . : 57B7-001
Unit ID . . . . . . . . . . . . . . : U789C.001.DQD0P72
Planar ID . . . . . . . . . . . . . : P1
Card . . . . . . . . . . . . . . . : C9
Battery type . . . . . . . . . . . : Lithium Ion (LiIon)
Battery state . . . . . . . . . . . : No battery warning/error
Power-on time (days) . . . . . . . : 934
Adjusted power-on time (days) . . . : 941
Estimated time to warning (days) . : 31
Estimated time to error (days) . . : 121
Concurrently maintainable :
battery pack . . . . . . . . . . .: Yes
Battery pack can be safely replaced : No