IVM lsled command

Purpose

List states for physical and virtual LEDs. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

To list physical platform LEDs:

lsled -r sa -t phys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual partition LEDs:

lsled -r sa -t virtuallpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual platform LEDs:

lsled -r sa -t virtualsys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

Description

The lsled command lists the states of physical and virtual LEDs.

Flags

Flag name Description
-r ResourceType The type of LED resources to list. The only valid value is sa for System Attention (SA) LEDs.
-t SystemAttentionType The type of System Attention (SA) LEDs to list.
  • -r sa -t virtuallpar: List attributes for virtual partition system attention LEDs
    • Attributes: lpar_id, lpar_name, state
    • Filters: { lpar_ids | lpar_names}
  • -r sa -t virtualsys: List attributes for virtual system attention LEDs
    • Attributes: state
    • Filters: None
  • -r sa -t phys: List attributes for physical system attention LEDs
    • Attributes: state
    • Filters: None
-m ManagedSystem The name of the managed system. This attribute is optional because there is only one system to manage. The name might either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
--filter FilterData The filters to apply to the resources to be listed. Filters are used to select which resources of the specified resource type are to be listed. If no filters are used, then all of the resources of the specified resource type will be listed. For example, specific partitions can be listed by using a filter to specify the names or IDs of the partitions to list. Otherwise, if no filter is used, then all the partitions in the managed system will be listed.

The filter data consists of filter name/value pairs, which are in comma separated value (CSV) format. The filter data must be enclosed in double quotation marks.

The format of the filter data is as follows:
"filter-name=value,filter-name=value,..."
Note that certain filters accept a comma separated list of values, as follows:
""filter-name=value,value,...",..."

When a list of values is specified, the filter name/value pair must be enclosed in double quotation marks. Depending on the shell being used, nested double quotation marks might need to be preceded by an escape character, which is usually a '\' character.

Unless otherwise indicated, multiple values can be specified for each filter.

Valid filter names for -r lpar
lpar_ids
ID of the partitions to view
lpar_names
Name of the partitions to view
-F AttributeNames A delimiter separated list of attribute names for the desired attribute values to be displayed for each resource. If no attribute names are specified, then values for all of the attributes for the resource will be displayed.

When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option.

This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

Attribute Names

  • lpar_id: Unique integer identifier for the partition
  • lpar_name: name of the partition
  • state: The current state of the LED. Valid values:
    • off - the LED is off
    • on - the LED is on
--header Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.

Exit Status

This command has a return code of 0 on success.

Security

This command is accessible by all users.

Examples

  1. Display the physical system attention LED for the system:
    lsled -r sa -t phys
  2. Display all of the virtual partition system attention LEDs:
    lsled -r sa -t virtuallpar
  3. Display the virtual partition system attention LEDs for partitions lpar1 and lpar2:
    lsled -r sa -t virtuallpar --filter \"lpar_names=lpar1,lpar2\"



Last updated: Wed, November 18, 2020