IVM lshwres command

Purpose

Lists the hardware resources of a managed system. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

To list attributes for physical I/O buses

lshwres -r io --rsubtype bus [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for I/O pools

lshwres -r io --rsubtype iopool --level pool [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for I/O pools

lshwres -r io --rsubtype iopool --level sys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for physical I/O buses

lshwres -r io --rsubtype bus [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for physical I/O slots

lshwres -r io --rsubtype slot [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list attributes for physical I/O units

lshwres -r io --rsubtype unit [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list recoverable I/O resources

lshwres -r io --rsubtype slot -R [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the currently tagged I/O for all IBM® i logical partitions

lshwres -r io --rsubtype taggedio [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition attributes for memory

lshwres -r mem --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To display memory statistics from a partition

lshwres -r mem --level lpar --stat --filter "FilterData" [-F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for memory

lshwres -r mem --level sys [ --maxmem ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list recoverable memory resources

lshwres -r mem --level lpar -R [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list information about the memory pool

lshwres -r mempool [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list paging devices associated with the memory pool

lshwres -r mempool --rsubtype pgdev [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list recoverable memory pools

lshwres -r mempool -R [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition attributes for processors

lshwres -r proc --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list shared processor pool attributes

lshwres -r proc --level pool [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for processors

lshwres -r proc --level sys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list recoverable processors resources

lshwres -r proc --level lpar -R [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual Ethernet adapter attributes

lshwres -r virtualio --rsubtype eth --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for virtual Ethernet adapters

lshwres -r virtualio --rsubtype eth --level sys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual fibre channel adapter attributes

lshwres -r virtualio --rsubtype fc --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes for virtual fibre channel adapters

lshwres -r virtualio --rsubtype fc --level sys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual SCSI adapter attributes

lshwres -r virtualio --rsubtype scsi [ --level lpar ] [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual serial adapter attributes

lshwres -r virtualio --rsubtype serial --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition attributes for virtual I/O slots

lshwres -r virtualio --rsubtype slot --level lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list virtual I/O slot attributes

lshwres -r virtualio --rsubtype slot --level slot [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list recoverable virtual I/O resources

lshwres -r virtualio --rsubtype slot -- level slot -R [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list high-speed link (HSL) pools for all IBM i logical partitions

lshwres -r virtualio --rsubtype hsl [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list Virtual OptiConnect pools for all IBM i logical partitions

lshwres -r virtualio --rsubtype virtualopti [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the physical Host Ethernet Adapters

lshwres -r hea --rsubtype phys --level sys [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the physical Host Ethernet Adapter ports

lshwres -r hea --rsubtype phys --level port [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the physical Host Ethernet Adapter port performance metrics

lshwres -r hea --rsubtype phys --level port --stat [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the physical Host Ethernet Adapter port groups

lshwres -r hea --rsubtype phys --level port_group [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the logical Host Ethernet Adapters and resource settings

lshwres -r hea --rsubtype logical --level sys [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the logical ports

lshwres -r hea --rsubtype logical --level port [-R] [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list the virtual Ethernet topology

lshwres -r virtualio --rsubtype eth --level lpar -F device_name,drc_name,shared_adapter,backing_device

Description

The lshwres command lists the hardware resources of the managed-system, including physical I/O, virtual I/O, memory, and processing.

Flags

Flag name Description
-r ResourceType --rsubtype ResourceSubtype --level ResourceLevel The combination of -r, --rsubtype, and --level indicates which type of attributes and objects to list. The valid combinations are enumerated below.
  • -r io --rsubtype bus: List attributes for physical I/O buses
    • Attributes: unit_phys_loc,bus_id,backplane_phys_loc,bus_drc_index,bus_drc_name
    • Filters: units, buses
 
  • -r io --rsubtype iopool -level sys: List attributes for physical I/O pools
    • Attributes: max_io_pools
    • Filters: none
  • -r io --rsubtype iopool -level pool: List attributes for physical I/O pools
    • Attributes: io_pool_id, lpar_ids, slots
    • Filters: {lpar_ids | lpar_names}, pools
  • -r io --rsubtype slot: List attributes for physical I/O slots
    • Attributes: unit_phys_loc, bus_id, phys_loc, drc_index, lpar_name, lpar_id, slot_io_pool_id, description, feature_codes, adapter_feature_codes, adapter_descriptions, pci_vendor_id, pci_device_id, pci_subs_vendor_id, pci_subs_device_id, pci_class, pci_revision_id, bus_grouping, iop, iop_info_stale,console_capable, load_source_capable, laod_source_attached, alt_restart_device_capable, alt_restart_device_attached, op_console_capable, op_console_attached, twinas_capable, direct_console_capable, lan_console_capablevpd_stale, vpd_type, vpd_model, vpd_serial_num, parent_slot_drc_index, drc_name
    • Filters: {lpar_ids | lpar_names}, units, buses, slots, pools
 
  • -r io --rsubtype slot -R: List attributes for physical I/O slots
    • Attributes: drc_index, lpar_name, lpar_id, drc_name
    • Filters: {lpar_ids | lpar_names}, units, buses, slots, pools
  • -r io --rsubtype taggedio: List attributes for tagged I/O resources
    • Attributes: lpar_name, lpar_id, load_source_slot, alt_restart_device_slot, recent_alt_restart_device_slot, console_slot, alt_console_slot, op_console_slot
    • Filters: {lpar_ids | lpar_names}
  • -r io --rsubtype unit: List attributes for physical I/O units
    • Attributes: unit_phys_loc
    • Filters: units
 
  • -r hea --rsubtype phys --level sys
    • Attributes: adapter_id, state, phys_loc
    • Filters: adapter_ids
  • -r hea --rsubtype phys --level port_group
    • Attributes: adapter_id, port_group, phys_port_ids, unassigned_logical_port_ids, curr_port_group_mcs_value, pend_port_group_mcs_value, valid_port_group_mcs_values
    • Filters: adapter_ids, port_groups
  • -r hea --rsubtype phys --level port
    • Attributes: adapter_id, port_group, phys_port_id, phys_port_type, phys_port_state, conn_state, curr_conn_speed, config_conn_speed, curr_duplex, config_duplex, trans_flow_control, recv_flow_control, config_flow_control, max_recv_packet_size, promisc_lpar_id, promisc_lpar_name, logical_port_ids, phys_port_loc
    • Filters: adapter_ids, port_groups
 
  • -r hea --rsubtype phys --level port --stat
    • Attributes: adapter_id, port_group, phys_port_id, recv_octets, recv_packets_0_64, recv_packets_65_127, recv_packets_128_255, recv_packets_256_511, recv_packets_512_1023, recv_packets_1024_max, recv_packets_dropped_bad_FCS, recv_packets_dropped_internal_mac_error, recv_packets_dropped_in_range_length_error, recv_packets_dropped_out_of_range_length_error, recv_packets_dropped_frame_too_long, recv_packets_dropped_jabber, recv_symbol_error, recv_code_error,recv_runt_frame, recv_fragments, recv_unsupported_opcode, recv_control_pause_frames, recv_search_busy, recv_packets_dropped_filter, recv_packets_dropped_other, recv_packets_dropped_alignment, recv_MC_packets, recv_BC_packets, trans_MC_packets, trans_BC_packets, trans_octets, trans_packets_length_0_64, trans_packets_length_65_127, trans_packets_length_128_255, trans_packets_length_255_511, trans_packets_length_512_1023, trans_packets_length_1024_max, trans_packets_dropped_bad_FCS, trans_control_pause_frames, trans_tx_local_fault_packets, trans_tx_remote_fault_packets, trans_tx_packets_dropped_int_MAC_error, trans_packets_retried_single_collision, trans_packets_retried_multiple_collision, trans_packets_signal_quality, trans_packets_deferred, trans_packets_late_collisions, trans_packets_excessive_collisions, trans_packets_no_carrier, recv_overrun_frames_dropped
    • Filters: adapter_ids, port_groups
  • -r hea --rsubtype logical --level sys
    • Attributes: adapter_id, lpar_id, lpar_name, drc_index, drc_name, capabilities, ieq, nieq, qp, cq, mr
    • Filters: {lpar_ids | lpar_names}, adapter_ids
  • -r hea --rsubtype logical --level port
    • Attributes: adapter_id, lpar_id, lpar_name, state, port_group, phys_port_id, logical_port_id, drc_index, drc_name, mac_addr, user_def_mac_addr, vlan_id_list
    • Filters: {lpar_ids | lpar_names}, adapter_ids, port_groups
 
  • -r mem --level lpar: List partition attributes for memory
    • Attributes: lpar_name, lpar_id, mem_mode, auto_io_entitled_mem, curr_io_entitled_mem, curr_min_mem, curr_mem, curr_mem_weight, curr_max_mem, pend_io_entitled_mem, pend_min_mem, pend_mem, pend_mem_weight, pend_max_mem, run_io_entitled_mem, run_mem_weight, run_min_mem, run_mem
    • Filters: {lpar_ids | lpar_names}
  • -r mem --level lpar -R: List partition attributes for memory
    • Attributes: lpar_name, lpar_id, mem_mode, pend_mem_weight, pend_io_entitled_mem, run_mem_weight, run_io_entitled_mempend_mem, run_mem
    • Filters: {lpar_ids | lpar_names}
  • -r mem --level lpar -stat: List partition attributes for memory
    • Attributes: min_io_entitled_mem, optimial_io_entitled_mem, max_io_entitled_mem_usage
    • Filters: {lpar_ids | lpar_names}
 
  • -r mem --level sys [--maxmem]: List system attributes for memory
    • Attributes: configurable_sys_mem, curr_avail_sys_mem, pend_avail_sys_mem, installed_sys_mem, deconfig_sys_mem, sys_firmware_mem, mem_region_size, pend_mem_region_size, possible_mem_region_size, max_mem_pools, max_paging_vios_per_mem_pool
    • Additional attributes with --maxmem: required_min_mem_aix_linux, required_min_mem_os400
    • Filters: None
  • -r mempool : List system attributes for memory pools
    • Attributes: curr_pool_mem, pend_pool_mem, curr_max_pool_mem, pend_max_pool_mem, sys_firmware_pool_mem, paging_storage_pool, paging_vios_names, paging_vios_ids
    • Filters: None
  • -r mempool -R: List system attributes for recoverable memory pool resources
    • Attributes: curr_pool_mem, pend_pool_mem, curr_max_pool_mem, pend_max_pool_mem, sys_firmware_pool_mem, paging_storage_pool, paging_vios_names, paging_vios_ids
    • Filters: None
 
  • -r mempool --rsubtype pgdev: List paging devices associated with the memory pool
    • Attributes: device_name, size, state, type, phys_loc, storage_pool, lpar_name, lpar_id, paging_vios_name, paging_vios_id, redundant_state, is_redundant, redundant_device_name, redundant_paging_vios_id, redundant_paging_vios_name, redundant_phys_loc
    • Filters: {lpar_ids | lpar_names}
  • -r proc --level lpar: List partition attributes for processors
    • Attributes: lpar_name, lpar_id, curr_shared_proc_pool_id, curr_proc_mode, curr_min_proc_units, curr_proc_units, curr_max_proc_units, curr_min_procs, curr_procs, curr_max_procs, curr_sharing_mode, curr_uncap_weight, pend_shared_proc_pool_id, pend_proc_mode, pend_min_proc_units, pend_proc_units, pend_max_proc_units, pend_min_procs, pend_procs, pend_max_procs, pend_sharing_mode, pend_uncap_weight, run_proc_units, run_procs, run_uncap_weight
    • Filters: {lpar_ids | lpar_names}
  • -r proc --level lpar -R: List partition attributes for processors
    • Attributes: lpar_name, lpar_id, curr_proc_mode, curr_sharing_mode, pend_proc_mode, pend_proc_units, pend_procs, pend_sharing_mode, pend_uncap_weight, run_proc_units, run_procs, run_uncap_weight
    • Filters: {lpar_ids | lpar_names}
 
  • -r proc --level pool: List shared processor pool attributes
    • Attributes: shared_proc_pool_id, configurable_pool_proc_units, curr_avail_pool_proc_units, pend_avail_pool_proc_units
    • Filters: None
  • -r proc --level sys: List system attributes for processors
    • Attributes: configurable_sys_proc_units, curr_avail_sys_proc_units, pend_avail_sys_proc_units, installed_sys_proc_units, deconfig_sys_proc_units, min_proc_units_per_virtual_proc, max_shared_proc_pools, max_virtual_procs_per_lpar, max_procs_per_lpar
    • Filters: None
  • -r virtualio --rsubtype eth --level lpar: List virtual Ethernet adapter attributes
    • Attributes: lpar_name, lpar_id, slot_num, state, ieee_virtual_eth, port_vlan_id, addl_vlan_ids, is_trunk, trunk_priority, is_required, mac_addr
    • Filters: {lpar_ids | lpar_names}, vlans, slots
 
  • -r virtualio --rsubtype eth --level sys: List system attributes for virtual Ethernet adapters
    • Attributes: max_vlans_per_port, mac_prefix
    • Filters: None
  • -r virtualio --rsubtype eth --level lpar -F device_name,drc_name,shared_adapter,backing device: List virtual Ethernet adapter attributes
    Note: The shared_adapter and backing_device are empty for all logical partitions other than the Virtual I/O Server. These attributes might be empty on the Virtual I/O Server if the Integrated Virtualization Manager cannot retrieve the information or if no such adapter exists (shared_adapter) or if no such shared Ethernet adapter (backing_device) exists.
    • Attributes: lpar_name, lpar_id, slot_num, state, ieee_virtual_eth, port_vlan_id, addl_vlan_ids, is_trunk, trunk_priority, is_required, mac_addr
    • Filters: {lpar_ids | lpar_names}, vlans, slots
  • -r virtualio --rsubtype fc --level lpar: List information about virtual fibre channel adapters for each logical partition
    • Attributes: lpar_name, lpar_id, slot_num, adapter_type, remote_lpar_id, remote_lpar_name, remote_slot_num, is_required, wwpns, state
    • Filters: {lpar_ids | lpar_names}, slots
 
  • -r virtualio --rsubtype fc --level sys: List system attributes for virtual fibre channel adapters
    • Attributes: num_wwpns_remaining, wwpn_prefix
    • Filters: None
  • -r virtualio --rsubtype fc --level lpar -F topology: List information about virtual fibre channel adapters for each logical partition in the form of a slash delimited list (for example, vd_name/status/fc_client_name/fc_server_name/phys_port_name)
    • Attributes: lpar_name, lpar_id, slot_num, adapter_type, remote_lpar_id, remote_lpar_name, remote_slot_num, is_required, wwpns, state
    • Filters: {lpar_ids | lpar_names}, slots
  • -r virtualio --rsubtype hsl: List system attributes for high-speed link
    • Attributes: hsl_pool_id, lpar_names, lpar_ids
    • Filters: {lpar_ids | lpar_names}, pools
 
  • -r virtualio --rsubtype scsi --level lpar: List virtual SCSI adapter attributes
    • Attributes: lpar_name, lpar_id, slot_num, state, adapter_type, remote_lpar_id, remote_lpar_name, remote_slot_num, is_required
    • Filters: {lpar_ids | lpar_names}, slots
  • -r virtualio --rsubtype scsi --level lpar -F topology: List virtual SCSI adapter attributes in the form of a slash delimited list (for example, vd_name/status/vscsi_client_name/bd_sp_name/bd_name)
    Note: The bd_sp_name might be empty if the Virtual I/O Server uses physical volumes rather than a storage pool.
    • Attributes: vd_name, vscsi_client_name, vscsi_server_name, bd_sp_name, bd_name
    • Filters: {lpar_ids | lpar_names}, slots
 
  • -r virtualio --rsubtype slot --level lpar: List partition attributes for virtual I/O slots
    • Attributes: lpar_name, lpar_id, curr_max_virtual_slots, pend_max_virtual_slots
    • Filters: {lpar_ids | lpar_names}
  • -r virtualio --rsubtype slot --level slot: List virtual I/O slot attributes
    • Attributes: slot_num, lpar_name, lpar_id, config, state, drc_name
    • Filters: {lpar_ids | lpar_names}, slots
  • -r virtualio --rsubtype slot --level slot -R: List virtual I/O slot attributes
    • Attributes: slot_num, lpar_name, lpar_id, drc_name
    • Filters: {lpar_ids | lpar_names}, slots
  • -r virtualio --rsubtype virtualopti: List virtual OptiConnect resource attributes
    • Attributes: virtual_opti_pool_id, lpar_names, lpar_ids
    • Filters: {lpar_ids | lpar_names}, pools
--maxmem MaximumMemory When this option is specified, the required minimum memory amount needed for partitions to support the maximum memory quantity specified is listed. All memory quantities are in megabytes, and are a multiple of the memory region size for the managed- system.

This information is useful for specifying memory amounts in partition profiles.

This option is only valid when listing system level memory resources.

-m ManagedSystem The name of the managed system. This attribute is optional because there is only one system to manage. The name may 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 characters 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:

adapter_ids
The DRC index of the Host Ethernet Adapter in hexadecimal
buses
The bus ID of the I/O bus to view
lpar_ids | lpar_names
Name or ID of the logical partition to view
Note: The filter value of none for lpar_ids is supported and displays only paging devices that are not currently assigned to any logical partition. If the memory pool does not exist, and you use the -r mempool --rsubtype pgdev attribute, an error is displayed.
pools
The pool ID of the I/O pool to view
port_groups
The Host Ethernet Adapter port group or groups
slots
For physical I/O slots, the DRC index of the slot to view. For virtual I/O slots, the virtual slot number of the slot to view
units
The physical location code of the unit to view
vlans
The virtual LAN of the virtual Ethernet adapters 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:

 
adapter_descriptions
Indicates a description of the adapter.
adapter_feature_codes
List of possible feature codes for the I/O adapter sorted by likely match. Each element in the list consists of two feature codes - one for each operating system. This list follows the following format:
aix_feature_code1/linux_feature_code1,
/i5_feature_code1,aix_feature_code2/
linux_feature_code2/i5_feature_code2,...
adapter_id
Indicates the DRC index of the Host Ethernet Adapter in hexadecimal.
 
adapter_type
Indicates whether the virtual SCSI, virtual fibre channel, or serial adapter is a client or server. Valid values are client and server.
addl_vlan_ids
The list of additional IEEE 802.1Q virtual LANs (VLANs) on a virtual Ethernet adapter.
alt_console_slot
The location of the virtual I/O slot that contains the alternate console device for the IBM i logical partition. The default value is none.
 
alt_restart_device_attached
Whether this IOP has an alternate restart device. Valid values are:
  • 0 - not attached
  • 1 - attached
alt_restart_device_capable
Whether the IOP is capable of being tagged as the alternate restart device. The default values is 0 (not capable).
alt_restart_device_slot
The location of the virtual I/O slot that contains the alternate restart device for the IBM i logical partition. If the load source slot has a value other than none, this attribute is optional. Valid values are:
  • Slot number (for virtual I/O)
  • None
auto_io_entitled_mem
Indicates whether the I/O entitled memory of the partition is automatically managed. Valid values follow:
  • 0 (Not managed/custom)
  • 1 (Automatically managed)
This attribute is only displayed by default if the mem_mode attribute is shared. If the value is dedicated and the attribute is requested, the value is null.
auto_mem_region_size
Indicates the optimal size of the memory region, as automatically calculated by the firmware.
Note: The memory region size applies to the entire system and requires you to reboot the entire system.
backing_device
The name of the physical Ethernet adapter that is connected to the shared Ethernet adapter on the virtual I/O server (VIOS). For example, ent0.
backplane_phys_loc
Physical location code of the backplane on which the bus resides.
 
bus_drc_index
DRC index, in hex, of the bus.
 
bus_drc_name
DRC name of the bus.
bus_grouping
Indicates whether bus grouping is required. Possible values:
  • 0 - not required
  • 1 - required
bus_id
I/O bus unique ID.
 
capabilities
Values currently applied to the system.
config
Virtual slot configuration state. Possible values follow:
  • empty - no adapter
  • ethernet - virtual Ethernet adapter
  • fc - virtual fibre channel adapter
  • reserved - reserved slot
  • scsi - virtual SCSI adapter
  • serial - virtual serial adapter
  • vasi - virtual asynchronous services interface
  • vmc - virtual management channel adapter
config_conn_speed
The configured connection speed of the port in megabits per second. This value can be set by the user using chhwres. Possible values are:
  • auto
  • 10
  • 100
  • 1000
  • 10000
 
config_duplex
Configured duplex value of the port. This value can be set by the user using chhwres. Possible values are:
  • auto
  • half
  • full
config_flow_control
Configured flow control value of the port. This value is used for both the receive and transmit flow control. This attribute can also be set using the chhwres command. Possible values are:
  • 1 (enabled)
  • 0 (disabled)
configurable_pool_proc_units
Total number of configurable processing units in the shared processing pool.
 
configurable_sys_mem
Total amount, in megabytes, of configurable memory on the managed system.
configurable_sys_proc_units
Total number of configurable processing units on the managed system.
conn_state
Connection state or link state of the physical port. Possible values are:
  • 1 (up)
  • 0 (down)
  • unavailable
 
cq
Total number of completion queues.
console_capable
Whether the IOP is capable of being tagged as the console device. Valid values are:
  • 0 - not capable
  • 1 - capable
console_slot
The location of the virtual I/O slot that contains the console device for the IBM i logical partition. Valid values are:
  • Slot number (for virtual I/O)
  • None
 
curr_avail_pool_proc_units
Current number of configurable processing units in the shared processing pool that are not assigned to partitions.
curr_avail_sys_mem
Current amount, in megabytes, of configurable memory on the managed system that is not assigned to partitions.
curr_avail_sys_proc_units
Current number of configurable processing units on the managed system that are not assigned to partitions.
 
curr_conn_speed
Speed of the port in Mbps. Possible values are:
  • 10
  • 100
  • 1000
  • 10000
  • unavailable
curr_duplex
Duplex value of the port. Valid values are:
  • half
  • full
  • unavailable
curr_io_entitled_mem
The current I/O entitled memory of the partition in megabytes. This attribute is only displayed, by default, if the value of the mem_mode attribute is Shared. If the value is Dedicated and the attribute is requested, the value is null.
 
curr_max_mem
Maximum amount of memory, in megabytes, that can be dynamically assigned to the partition.
curr_max_pool_mem
Maximum amount of physical memory that can be assigned to the memory pool without taking the pool offline. This value is in megabytes.
curr_max_proc_units
Maximum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
 
curr_max_procs
Maximum number of processors or virtual processors that can be dynamically assigned to the partition.
curr_max_virtual_slots
Maximum number of virtual slots that can be dynamically configured for the partition.
curr_mem
Current amount of memory, in megabytes, assigned to the partition.
 
curr_mem_weight
The current shared memory weight of the partition. Possible values are 0 through 255. This attribute is only displayed by default if the mem_mode attribute is set to the shared value. If the value is dedicated and the attribute is requested, the value is null.
curr_min_mem
Minimum amount of memory, in megabytes, that can be dynamically assigned to the partition.
curr_min_proc_units
Minimum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
 
curr_min_procs
Minimum number of processors or virtual processors that can be dynamically assigned to the partition.
curr_pool_mem
The amount of physical memory currently assigned to the memory pool in megabytes.
curr_port_group_mcs_value
The current MCS value for the port group.
 
curr_proc_mode
Indicates whether the partition is using dedicated or shared processors. The mode cannot change dynamically. Valid values:
  • ded - dedicated
  • shared - shared
curr_proc_units
The current number of processing units assigned to the partition. This attribute is only valid for partitions using shared processors.
curr_procs
The current number of processors or virtual processors assigned to the partition.
 
curr_shared_proc_pool_id
The shared processor pool that this partition is currently participating in. This attribute is only valid for partitions using shared processors.
curr_sharing_mode
The current sharing mode for a partition. Valid values:
  • keep_idle_procs - valid with dedicated processor mode
  • share_idle_procs - valid with dedicated processor mode
  • share_idle_procs_always - valid with dedicated processor mode
  • share_idle_procs_active - valid with dedicated processor mode
  • cap - capped mode. valid with shared processor mode
  • uncap - uncapped mode. valid with shared processor mode
curr_uncap_weight
The current weighted average of processing priority when in uncapped sharing mode. Valid values are 0 - 255.
 
deconfig_sys_mem
The amount of memory, in megabytes, on the managed system that has been unconfigured. This includes memory that has been unconfigured by the system due to hardware failure, and memory that has been manually unconfigured.
deconfig_sys_proc_units
The number of processing units on the managed system that have been unconfigured. This includes processing units that have been unconfigured by the system due to hardware failure, and processing units that have been manually unconfigured.
description
A description of the I/O adapter which is in the slot.
 
device_name
The Virtual I/O Server device used as a paging space device in the memory pool.
direct_console_capable
Whether the IOP is capable of being tagged as the console device for directly attached console. Valid values are:
  • 0 - not capable
  • 1 - capable
drc_index
The DRC index, in hexadecimal, of the I/O slot.
 
drc_name
The DRC name of the I/O slot.
 
feature_codes
The most likely feature code for the I/O adapter. The feature code may be different for each operating system. The adapter_feature_codes attribute should be used to distinguish the feature code specific to each operating system.
hsl_pool_id
Whether the logical partition participates in the high-speed Link (HSL) pool. The default value is 0 (does not participate).
ieee_virtual_eth
Indicates whether the virtual Ethernet adapter is using IEEE 802.1Q. Valid values follow:
  • 0 - No
  • 1 - Yes
 
ieq
Total number of interruptible event queues.
installed_sys_mem
Total amount, in megabytes, of memory installed on the managed system.
installed_sys_proc_units
Total number of processing units installed on the managed system.
 
io_pool_id
A unique identifier for an I/O pool. I/O pools are used in some I/O clustering environments.
iop
Indicates whether the I/O adapter is an I/O processor. Valid values:
  • 0 - no
  • 1 - yes
iop_info_stale
Indicates whether the information about the I/O processor is stale. Valid values:
  • 0 - no
  • 1 - yes
 
is_required
Indicates whether the I/O slot or virtual I/O adapter is required for the partition. Valid values:
  • 0 - no
  • 1 - yes
is_trunk
Indicates whether the virtual Ethernet adapter is the trunk or uplink adapter for the virtual LAN. Valid values:
  • 0 - no
  • 1 - yes
lan_console_capable
Whether the IOP is capable of being tagged as the console device for a LAN console. The default values is 0 (not capable).
 
load_source_attached
Whether this IOP has a load source device. Valid values:
  • 0 - not attached
  • 1 - attached
load_source_capable
Whether this IOP is capable of being tagged as the load source device. The default values is 0 (not capable).
load_source_slot
The location of the virtual I/O slot that contains the load source for the IBM i logical partition. If the alt_restart_device_slot has a value other than none, then this attribute is optional. Valid values are:
  • Slot number (for virtual I/O)
  • None
 
logical_port_id
The ID of the logical port.
logical_port_ids
Logical port IDs defined on the physical port.
lpar_id
Partition ID. Valid values are 1 through the maximum number of partitions supported on the managed system (max_lpars).

When using the --rsubtype pgdev flag, this attribute represents the partition ID of the shared memory partition to which this paging device is associated. If no partition is associated, then the value is none.

 
lpar_ids
List of logical partition IDs of logical partitions using a pool.
lpar_name
User-defined name for the partition.

When using the --rsubtype pgdev flag, this attribute represents the name of the shared memory partition to which this paging device is associated. If no partition is associated, this attribute is not displayed by default. If no partition is associated but the attribute is requested, the attribute will have a blank value.

lpar_names
List of names of logical partitions using a pool.
 
mac_addr
MAC address for the virtual Ethernet adapter.
mac_prefix
The first 3 bytes of the MAC address to be assigned to all virtual Ethernet adapters for this managed system. This must be specified as a 3 byte hexadecimal value (for example, 32ab10) and can only be configured in the mkgencfg command.
max_io_entitled_mem_usage
The highest level of I/O entitled memory used by the specified logical partition since the value was last reset.
 
max_io_pools
Maximum number of I/O pools supported on the managed system.
max_mem_pools
Maximum number of memory pools supported. If the system does not support memory pools, then the value is 0; otherwise, it is 1.
max_paging_vios_per_mem_pool
Maximum number of paging Virtual I/O Server (VIOS) partitions that can be assigned to a memory pool. If the system supports memory pools, this value is 1.
max_procs_per_lpar
Indicates the largest number of dedicated processors that you can assign as the maximum processors value for a logical partition.
 
max_recv_packet_size
Maximum Transmission Unit (MTU) size of the port. This value can also be changed using the chhwres command. Possible values:
  • 1500 (default)
  • 9000 (jumbo)
max_shared_proc_pools
Maximum number of shared processing pools which are supported on the managed system.
max_virtual_procs_per_lpar
Indicates the largest number of virtual processors that can be assigned as the maximum processors value for a logical partition.
 
max_vlans_per_port
Indicates the largest number of VLANs that can be specified as additional IEEE 802.1Q VLANs on a virtual Ethernet adapter.
mem_mode
Partition memory mode.
  • ded: Dedicated memory
  • shared: Shared memory
mem_region_size
The memory region size, in megabytes, for the managed system. The memory regions size represents the granularity of memory allocation to partitions.
 
min_io_entitled_mem
The minimum I/O entitled memory required for the logical partition to function with the current I/O configuration.
min_proc_units_per_virtual_proc
Minimum number of processing units that are required for each virtual processor assigned to a partition.
mr
Total number of memory regions.
 
nieq
Total number of non-interruptible event queues.
num_wwpns_remaining
The number of worldwide port names that remain to be allocated on the managed system.
op_console_attached
Whether this IOP has an operations console device. This attribute is only shown if iop is 1. This attribute is current only if vpd_stale is 0. Valid values are:
  • 0 - not capable
  • 1 - attached
 
op_console_capable
Whether this IOP is capable of being tagged as the console device for operations console. This attribute is only shown if iop is 1. This attribute is current only if vpd_stale is 0. The default value is 0 (not capable).
op_console_slot
The location of the virtual I/O slot that contains the directly attached Operations Console device for the IBM i logical partition. The default value is none.
optimal_io_entitled_mem
The amount of I/O entitled memory that would satisfy the requested configuration of all I/O devices.
 
paging_storage_pool
The name of default paging storage pool. This attribute is the storage pool from which new paging devices are created. If there is no default paging storage pool, the value is an empty string.
paging_vios_id
The partition ID of the paging VIOS partition.
paging_vios_ids
A comma-separated list of partition IDs for paging VIOS partitions associated with this memory pool. This attribute is not displayed by default. If requested, the value displayed is 1.
 
paging_vios_name
The name of the paging VIOS partition.
paging_vios_names
A comma-separated list of partition names for paging VIOS partitions that are associated with this memory pool. This attribute is not displayed by default. If requested, the value displayed is the name of the Virtual I/O Server logical partition.
parent_slot_drc_index
The DRC index, in hex, of the parent slot. A value of none indicates there is no parent slot.
 
pci_class
PCI class code for the I/O adapter. This value is displayed in hexadecimal.
pci_device_id
ID of the device for this I/O adapter. This value is displayed in hexadecimal.
pci_revision_id
Vendor-assigned code indicating the revision number of the I/O adapter. This value is displayed in hexadecimal.
 
pci_subs_device_id
Vendor-assigned code identifying the type of driver that is installed for the I/O adapter. This value is displayed in hexadecimal.
pci_subs_vendor_id
ID of the vendor that made the driver for the I/O adapter. This value is displayed in hexadecimal.
pci_vendor_id
ID of the vendor that made this I/O adapter. This value is displayed in hexadecimal.
 
pend_avail_pool_proc_units
After system restart, the number of configurable processing units in the shared processing pool that are not assigned to partitions.
pend_avail_sys_mem
After system restart, the amount, in megabytes, of configurable memory on the managed system that is not assigned to partitions.
pend_avail_sys_proc_units
After system restart, the number of configurable processing units on the managed system that are not assigned to partitions.
 
pend_io_entitled_mem
The pending I/O entitled memory of the partition in megabytes. This attribute is only displayed by default if the mem_mode attribute has a value of shared. If the value is dedicated and the attribute is requested, the value is null.
pend_max_mem
After partition restart, the maximum amount of memory, in megabytes, that can be dynamically assigned to the partition.
pend_max_pool_mem
The pending value for the maximum amount of physical memory that can be assigned to the memory pool without taking the memory pool offline. This value is in megabytes.
 
pend_max_proc_units
After partition restart, the maximum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
pend_max_procs
After partition restart, the maximum number of processors or virtual processors that can be dynamically assigned to the partition.
pend_max_virtual_slots
After partition restart, the maximum number of virtual slots that can be dynamically created for the partition.
 
pend_mem
The target amount of memory, in megabytes, assigned to the partition.
pend_mem_region_size
This is the memory region size of the system after the system is restarted.
pend_mem_weight
The pending shared memory weight of the partition. Possible values are 0 - 255. This attribute is only displayed by default if the mem_mode attribute is set to the shared value. If the value is dedicated and the attribute is requested, the value is null.
 
pend_min_mem
After partition restart, the minimum amount of memory, in megabytes, that can be dynamically assigned to the partition.
pend_min_proc_units
After partition restart, the minimum number of processing units that can be dynamically assigned to the partition. This attribute is only valid for partitions using shared processors.
pend_min_procs
After partition restart, the minimum number of processors or virtual processors that can be dynamically assigned to the partition.
 
pend_pool_mem
The amount of physical memory to be assigned to the memory pool in megabytes.
pend_port_group_mcs_value
Pending MCS value of the port group. Setting the MCS value may require a system restart.
pend_proc_mode
Indicates whether the partition will be using dedicated or shared processors after restart. Valid values:
  • ded: Dedicated
  • shared: Shared
 
pend_proc_units
The target number of processing units assigned to the partition. This attribute is only valid for partitions using shared processors.
pend_procs
The target number of processors or virtual processors assigned to the partition.
pend_shared_proc_pool_id
The shared processor pool that a partition is will participate in after restart. This attribute is only valid for partitions using shared processors.
 
pend_sharing_mode
The target sharing mode for a partition. Valid values:
  • keep_idle_procs: Valid with pending dedicated processor mode
  • share_idle_procs: Valid with pending dedicated processor mode
  • cap - capped mode: Valid with pending shared processor mode
  • uncap - uncapped mode: Valid with pending shared processor mode
pend_uncap_weight
The target weighted average of processing priority when in uncapped sharing mode. Valid values are: 0 - 255.
 
phys_loc
If the device has a physical location code for the slot, this attribute is displayed by default with the physical location code as the value. If the device does not have a physical location code, this attribute is not displayed by default and has a blank value.
phys_port_id
The ID of the physical port in the port group (0 or 1).
phys_port_ids
List of host Ethernet adapter (HEA) physical port IDs in a port group.
 
phys_port_loc
Location code suffix for the physical port.
phys_port_state
State of the physical port.
 
phys_port_type
Speed of the port.
port_group
Indicates the Host Ethernet Adapter port group(s).
port_vlan_id
Port virtual LAN ID for the virtual ethernet adapter.
 
possible_mem_region_size
The memory region size that is possible of the system.
promisc_lpar_id
ID assigned to the promiscuous logical partition. Possible values:
  • none
  • 1 - 254
promisc_lpar_name
Name assigned to the promiscuous logical partition.
 
qp
The total number of queue pairs.
recent_alt_restart_device_slot
The previous alternate restart device slot.
recv_flow_control
Receive flow control value of the port
  • 1 (enabled)
  • 0 (disabled)
  • unavailable
 
recv_octets, recv_packets_0_64, recv_packets_65_127, recv_packets_128_255, recv_packets_256_511, recv_packets_512_1023, recv_packets_1024_max, recv_packets_dropped_bad_FCS, recv_packets_dropped_internal_mac_error, recv_packets_dropped_in_range_length_error, recv_packets_dropped_out_of_range_length_error, recv_packets_dropped_frame_too_long, recv_packets_dropped_jabber, recv_symbol_error, recv_code_error, recv_runt_frame, recv_fragments, recv_unsupported_opcode, recv_control_pause_frames, recv_search_busy, recv_packets_dropped_filter, recv_packets_dropped_other, recv_packets_dropped_alignment, default_unicast_QPN, recv_MC_packets, recv_BC_packets, trans_MC_packets, trans_BC_packets, trans_octets, trans_packets_length_0_64, trans_packets_length_65_127, trans_packets_length_128_255, trans_packets_length_255_511, trans_packets_length_512_1023, trans_packets_length_1024_max, trans_packets_dropped_bad_FCS, trans_control_pause_frames, trans_tx_local_fault_packets, trans_tx_remote_fault_packets, trans_tx_packets_dropped_int_MAC_error, trans_packets_retried_single_collision, trans_packets_retried_multiple_collision, trans_packets_signal_quality, trans_packets_deferred, trans_packets_late_collisions, trans_packets_excessive_collisions, trans_packets_no_carrier, recv_overrun_frames_dropped
Performance metric values
remote_lpar_id
For client adapters, this specifies the ID of the partition which has the virtual serial/SCSI server adapter for this adapter. For server adapters, this specifies the ID of the partition which has the only client virtual serial/SCSI adapter allowed to connect to this adapter. A value of any indicates that any client virtual serial/SCSI adapter should be allowed to connect to this adapter.
 
remote_lpar_name
The partition name which corresponds to the remote_lpar_id.
remote_slot_num
For client adapters, this specifies the virtual slot number of the virtual serial/SCSI server adapter for this adapter. For server adapters, this specifies the virtual slot number of the only client virtual serial/SCSI adapter allowed to connect to this adapter. A value of any indicates that any client virtual serial/SCSI adapter should be allowed to connect to this adapter.
required_min_mem_aix_linux
For an AIX® or Linux partition, this is the required minimum memory amount, in megabytes, for the maximum memory amount specified with the --maxmem parameter.
 
required_min_mem_os400
The required minimum memory amount, in megabytes, for the maximum memory amount specified with the --maxmem parameter. This attribute only applies for an IBM i logical partition.
op_console_slot
The location of the virtual I/O slot that contains the directly attached Operations Console device for the IBM i logical partition. The default value is none.
run_io_entitled_mem
The I/O entitled memory of the partition at run time in megabytes. This attribute is only displayed by default if the mem_mode attribute has a value of shared. If the value is dedicated and the attribute is requested, the value is null.
run_mem
Current amount of memory, in megabytes, that the partition has varied on.
 
run_mem_weight
The runtime shared memory weight of the logical partition. Possible values are 0 - 255. This attribute is only displayed by default if the mem_mode attribute is set to the shared value. If the value is dedicated and the attribute is requested, the value is null.
run_min_mem
The amount of memory, in megabytes, returned by a running partition's operating system to represent the smallest memory assignment which is currently supported by the operating system. If the operating system does not support this feature, then the value is 0.
run_proc_units
Number of processing units that are varied on for the partition.
 
run_procs
Number of processors or virtual processors that are varied on for the partition.
run_uncap_weight
The operating system's current setting for the weighted average of processing priority when in uncapped sharing mode. Valid values are: 0 - 255.
shared_adapter
The name of the shared Ethernet adapter on the VIOS. For example, ent9.
shared_proc_pool_id
A unique decimal identifier for a shared processing pool.
 
size
The size of the paging device in megabytes.
slot_io_pool_id
A unique decimal identifier of the I/O pool to which the slot is assigned. A value of none indicates that the slot is not assigned to any I/O pools.
slot_num
Virtual slot number.
 
slots
A list of slot DRC indices.
state
The state of a virtual slot. A virtual slot must be able to transition into the off state before a dynamic reconfiguration of the slot can succeed. Valid states follow:
  • 0 - The virtual slot is ready for dynamic reconfiguration.
  • 1 - The virtual slot is not yet ready for dynamic reconfiguration.
When using paging devices, state indicates the state of the paging device in megabytes. Valid states follow:
  • Active - The paging device is in use.
  • Inactive - The paging device is available.
  • Missing backing device - The backing device being used as a paging space device is missing.
  • Defined - The backing device being used as a paging space device is defined.
storage_pool
If the device comes from a storage pool, this attribute is displayed by default with the storage pool as the value. If the device does not come from a storage pool, this attribute is not displayed by default and has a blank value.
 
supports_hmc
Indicates whether or not the virtual serial adapter is enabled for HMC client support. Valid values:
  • 0 - no
  • 1 - yes
sys_firmware_mem
The amount of memory, in megabytes, on the managed system that is being used by system firmware.
sys_firmware_pool_mem
The amount of memory in the shared memory pool that is reserved for firmware use. This is the greater of the current and pending values.
 
trans_flow_control
Transmit flow control value of the port. Possible values are:
  • 1 (enabled)
  • 0 (disabled)
  • unavailable
trunk_priority
The valid values are integers between 1 and 15, inclusive. This value is required for a trunk adapter.
 
unassigned_logical_port_ids
List of logical port IDs in the port group that are not assigned to a partition.
unit_phys_loc
Physical location code of the I/O unit.
user_def_mac_addr
User defined MAC address for the logical port.
 
valid_port_group_mcs_values
Valid MCS values.
virtual_opti_pool_id
The location of the virtual I/O slot that contains the directly attached operations console device for the IBM i logical partition. The default value is 0 (does not participate).
 
vlan_id_list
List of virtual LAN IDs that the logical port has access to.
vpd_model
Model of the I/O adapter.
vpd_serial_num
Serial number of the I/O adapter.
 
vpd_stale
Indicates whether or not type, model, and serial number of the adapter is not current. Valid values:
  • 0 - not current
  • 1 - current
vpd_type
Type of the I/O adapter.
 
wwpns
If the adapter is of type client, the worldwide port names assigned to this adapter are displayed as a comma-separated list. If the adapter is of type server, by default, the attribute is not displayed. If the attribute is requested, the value is null.
wwpn_prefix
A 12-character hexadecimal string that is used by the managed system to generate worldwide port names.
--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.
-R List information for partitions with resources that can be restored due to a dynamic LPAR operation failure.

Exit Status

This command has a return code of 0 on success.

Security

This command is accessible by all users.

Examples

  1. List system level memory information and include the minimum memory required to support a maximum of 1024 MB:
    lshwres -r mem --level sys --maxmem 1024
  2. List all memory information for partitions lpar1 and lpar2, and only display attribute values, following a header of attribute names:
    lshwres -r mem --level lpar --filter "\"lpar_names=lpar1,lpar2\"" -F --header
  3. List all I/O units on the system:
    lshwres -r io --rsubtype unit
  4. List all virtual Ethernet adapters on the managed system:
    lshwres -r virtualio --rsubtype eth --level lpar
  5. List all virtual slots for partition lpar1:
    lshwres -r virtualio --rsubtype slot --level slot --filter "lpar_names=lpar1"
  6. List only the installed and configurable processors on the system:
    lshwres -r proc --level sys -F installed_sys_proc_units,
    configurable_sys_proc_units
  7. List all physical Host Ethernet Adapter ports on the system:
    lshwres -r hea --rsubtype phys --level port
  8. List all logical Host Ethernet Adapter ports on the system:
    lshwres -r hea --rsubtype logical --level port
  9. List the physical Host Ethernet Adapter adapters on the system:
    lshwres -r hea --rsubtype phys --level sys
  10. List the Host Ethernet Adapter port groups on the system:
    lshwres -r hea --rsubtype phys --level port_group



Last updated: Wed, November 18, 2020