lsenclosurebattery

Use the lsenclosurebattery command to display information about the batteries. The batteries are located in the node canisters.

Syntax

lsenclosurebattery [ -nohdr ] [ -filtervalue attribute_value ] [ -filtervalue? ] [ -delim delimiter ] [ [ -battery battery_id ] enclosure_id ]

Parameters

-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-filtervalueattribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards when using the CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard.
  • When using a wildcard, you must enclose the filter entry within double quotation marks (""), as follows:
    lsenclosurebattery -filtervalue "battery_id=1"
-filtervalue?
(Optional) Displays a list of valid filter attributes for the -filtervalueattribute=value parameter:
  • battery_id
  • charging_status
  • enclosure_id
  • end_of_life_warning
  • percent_charged
  • recondition_needed
  • status
-delimdelimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. A detailed view provides each item of data in its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a one-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
-battery battery_id
(Optional) Provides a detailed view of the specified battery. Valid only when an enclosure is specified.
enclosure_id
(Optional) Lists the batteries for the specified enclosure.

Description

This command displays information about the batteries, which are located in the node canisters. The concise view displays a line for each battery slot in every enclosure whether a battery exists for that slot or not.Batteries are not shown for expansion enclosures.Table 1 shows possible outputs.
Table 1. lsenclosurebattery outputs
Attribute Description
enclosure_id Identifies the identity of the enclosure that contains the battery.
battery_id Identifies the battery in the enclosure.
status Identifies the status of the battery:
  • online indicates the battery is present and working as usual.
  • degraded indicates the battery is present but not working as usual.
  • offline indicates the battery cannot be detected.
charging_status Identifies the charging state of the battery:
  • charged indicates the battery is fully charged.
  • charging indicates the battery is charging.
  • discharging indicates the battery is losing voltage (life).
  • idle indicates the battery is neither charging nor discharging but it is not fully charged.
percent_charged Indicates the charge of battery (in a percentage).
end_of_life_warning Identifies the battery's end of life (with a warning noise). The values are yes and no.
Important: Replace the battery.
FRU_part_number Identifies the FRU part number of the battery.
FRU_identity Identifies the 11S number, combining the manufacturing part number and the serial number.
firmware_level The version of the microcode image that is installed on the battery.
error_sequence_number Indicates the error log (or event log) number of the highest priority error for this object. This output field is typically blank. However, if there is a problem (for example, the status is degraded), then it contains the sequence number of that error event.
remaining_charge_capacity_mAh Identifies the battery's remaining charge capacity in milliampere-hour (mAh).
full_charge_capacity_mAh Identifies the fully-charged capacity of the battery in mAh (this diminishes as the battery ages).
compatibility_level Identifies the battery driver software must support this level to operate with this battery - this comes from the battery vital product data (VPD).
last_recondition_timestamp Identifies a system timestamp, in the format YYMMDDHHMMSS, for when the last successful calibration of the gas gauge occurred, where:
  • Y is year
  • (The first) M is month
  • D is day
  • H is hour
  • (The second) M is minute
  • S is second
powered_on_hours Identifies the number of hours the battery has been in a powered node (not necessarily the same node).
cycle_count Identifies the number of charge or discharge cycles performed on the battery.

A concise invocation example

lsenclosurebattery 1

The resulting output:

enclosure_id battery_id status charging_status recondition_needed percent_charged end_of_life_warning 
1            1          online idle            no                 100             no                  
1            2          online idle            no                 100             no 

A detailed invocation example

lsenclosurebattery -battery 1 1

The resulting output:

enclosure_id 1
battery_id 1
status online
charging_status idle
recondition_needed no
percent_charged 100
end_of_life_warning no
FRU_part_number 31P1807
FRU_identity 11S00AR085YM30BG42R04P
firmware_level 105:1
error_sequence_number 
remaining_charge_capacity_mAh 3477
full_charge_capacity_mAh 3795
compatibility_level 1
last_recondition_timestamp 140528045617
powered_on_hours 1162
cycle_count 10