-r ResourceType |
The type of resources to list: lpar: Logical partition resources
prof: Logical partition profile resources
sys: Managed system 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 quotes.
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 quotes. Depending on the shell being used, nested
double quote characters may 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 partitions: lpar_names | lpar_ids - name or ID of the partitions to view
work_groups - work groups to which the partitions belong
Valid
filter names for partition profiles: lpar_names | lpar_ids: name or ID of the partition profiles
profile_names: profile names for the partitions
Note: This
option is not valid when listing managed systems.
|
-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 for partitions: - allow_perf_collection
- Permission for the partition to retrieve shared processor pool
utilization information Valid values are:
- 0: do not allow authority
- 1: allow authority
- auto_start
- Valid values are:
- 0 - do not automatically start with system power on
- 1 - automatically start with system power on
|
|
- boot_mode
- Partition power on mode. This attribute
is only available for AIX® and Linux logical partitions. Valid
values are:
- norm: normal
- dd: diagnostic with default boot list
- ds: diagnostic with stored boot list
- of: Open Firmware OK prompt
- sms: System Management Services
- null: not applicable
- curr_lpar_proc_compat_mode
- Displays the current negotiated compatibility mode. This is the
mode that the partition operating system has negotiated, and will
be less than or equal to the desired mode at logical partition boot
time.
Note: It is possible that the mode will be greater than the
desired mode, if the partition is powered off. The current value
only changes when the logical partition restarts.
- curr_profile
- The current profile is always equal to the partition name
|
|
- default_profile
- The default profile is always equal to the partition name
- desired_lpar_proc_compat_mode
- Displays the requested compatibility mode.
- dlpar_mem_capable
- Indicates if the partition supports dynamic LPAR of memory. Valid
values:
|
|
- dlpar_proc_capable
- Indicates if the partition supports dynamic LPAR of processing
resources. Valid values:
- ipl_source
- The IPL source for the IBM® i logical
partition. This attribute is optional. Valid values:
- logical_serial_num
- A globally unique string for this partition
|
|
- lpar_env
- The operating environment for this partition Valid values:
- aixlinux: a partition type that supports AIX or Linux.
- os400: an IBM i partition
- vioserver: a Virtual I/O Server partition
- lpar_id
- unique integer identifier for the partition
- lpar_keylock
- Partition keylock position. Valid values:
- norm: normal keylock
- manual: manual keylock
|
|
- mem_synchronized
- The current and pending memory values for this partition are synchronized.
- name
- Name of the partition
- os_version
- The version of the operating system running that is in the logical
partition.
|
|
- power_ctrl_lpar_ids
- A list of partitions which have power control over this partition.
Valid values:
- proc_synchronized
- The current and pending processing values for this partition are
synchronized.
- resource_config
- Valid values:
- 0 - resources are not available to power on with system
- 1 - resources are available to power on with system
|
|
- rmc_ipaddr
- The IP address of the client partition. This IP address is used
by RMC to connect to the client partition for dynamic LPAR.
- rmc_state
- The state of the RMC connection between the management partition
and the client partition. The RMC connection is used primarily for
dynamic LPAR. Valid values:
- inactive
- active
- unknown
- none - RMC not configured. This partition has never been registered
with RMC.
- rmc_osshutdown_capable
- Indicates if the partition supports shutdown via the RMC connection.
This allows the management partition to safely shutdown the client
partition via chsysstate -o osshutdown Valid values follow:
|
|
- state
- The current runtime state of the partition. Valid values follow:
- Not Activated
- Starting
- Running
- Shutting Down
- Error
- Open Firmware
- Not Available
- uptime
- Partition uptime in seconds.
- work_group_id
- Valid values follow:
- none: do not participate in the workload management group
- 1: participate in the workload management group
|
|
Attribute names for partition profiles: - all_resources
- Valid values:
- 0: This partition will not own all physical resources on the system
- alt_console_slot
- The location of the physical I/O slot that contains the alternate
console device for the IBM i logical
partition. The default value is none.
|
|
- 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 is a value other than none, then
this attribute is optional. Valid values are:
- Slot number (for virtual I/O)
- none
- auto_start
- Valid values:
- 0 - do not automatically start with system power on
- 1 - automatically start with system power on
- boot_mode
- Partition power on mode. Valid values are:
- norm - normal
- dd - diagnostic with default boot list
- ds - diagnostic with stored boot list
- of - Open Firmware OK prompt
- sms - System Management Services
|
|
- conn_monitoring
- Valid values:
- 0 - connection monitoring is disabled
- 1 - connection monitoring is enabled
- 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
- desired_io_entitled_mem
- The amount of I/O entitled memory for a shared memory partition.
This is the portion of memory that is reserved for I/O mappings.
- auto (automatically manage)
- Number of megabytes
If the value is auto, the entitlement is calculated based on
the virtual I/O configuration of the partition. If the virtual I/O
configuration is changed, the entitlement is updated automatically.
If auto is not used, no automatic adjustments are made. The default
value is auto.
|
|
- desired_mem
- The assigned megabytes of memory for this partition.
- desired_procs
- The assigned number of processors for this partition. In shared
processing mode, this refers to virtual processors.
- desired_proc_units
- The assigned number of processing units for this partition.
|
|
- hsl_pool_id
- Whether the logical partition participates in the high-speed link
(HSL) pool. The default value is 0 (does not participate).
- io_slots
- Comma separated list of I/O slots for the partition. Each item
in this list has the format:
drc_index/slot_io_pool_id/is_required
Valid
values for is_required:
- lhea_logical_ports
- Comma-separated list of Logical Host Ethernet Adapter (LHEA) logical ports, with each
logical port having the following format:
adapter-ID/port-group/physical-port-ID
/logical-port-ID/allowed-VLAN-IDs
|
|
- lhea_capabilities
- Comma-separated list of LHEA capabilities, with each capability
having one of the following formats:
adapter-ID/capability
adapter-ID/5/ieq/nieq/qp/cq/mr
The
values for ieq (interruptible event queues), nieq (non-interruptible
event queues), qp (queue pairs), cq (completion queues),
and mr (memory regions) specify the resource amount in addition
to the base minimum. Valid values are: - 0 - minimum
- 1 - low
- 2 - medium
- 3 - high
- 4 - dedicated
- 5 - custom
- 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
- lpar_id
- Unique integer identifier for the partition.
|
|
- lpar_io_pool_ids
- Valid values are:
- none - this partition is not part of an I/O pool.
- lpar_name
- Name of the partition.
- lpar_proc_compat_mode
- The currently requested compatibility mode of the processor for
the logical partition.
|
|
- max_mem
- The maximum megabytes of memory for this partition.
- max_procs
- The maximum number of processors for this partition. In shared
processing mode, this refers to virtual processors. Valid values are:
- keep_idle_procs - never share processors
- share_idle_procs - share processors only when the partition is
inactive
- share_idle_procs_active - share processors only when partition
is active
- share_idle_procs_always - always share processors
- cap - capped mode
- uncap - uncapped mode
- max_proc_units
- The maximum number of processing units for this partition.
|
|
- max_virtual_slots
- Maximum number of virtual I/O adapter slots.
- mem_mode
- The partition memory mode.
- ded - dedicated memory
- shared - shared memory
If the memory mode is shared, then the logical partition cannot
be assigned any physical I/O slots, the proc_mode attribute on the
logical partition must be shared, and a memory pool must exist. Note: The
Virtual I/O Server logical partition only supports the dedicated memory
mode.
- mem_weight
- The shared memory weight of the logical partition with shared
memory. This flag is used for determining priority of logical partitions
in a memory pool for distribution of memory.
|
|
- min_mem
- The minimum megabytes of memory for this logical partition.
- min_procs
- The minimum number of processors for this logical partition.
In shared processing mode, this refers to virtual processors.
- min_proc_units
- The minimum number of processing units for this logical partition.
|
|
- name
- Name of the profile.
- 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.
- os_type
- The operating system environment for this logical partition. Valid
values:
- aixlinux: an RPA partition type which supports AIX or Linux.
- os400: an IBM i logical partition
- vioserver: a Virtual I/O Server partition
|
|
- paging_device
- The paging space device to use if a memory pool is used. A paging
device is a block storage device that has been added to the memory
pool and is not designated as a paging device for any other logical
partition. If the paging_device value is a blank string, no paging
device is currently assigned.
- power_ctrl_lpar_ids
- A list of logical partitions which have power control over this
logical partition. Valid values are:
- power_ctrl_lpar_names
- A list of logical partitions which have power control over this
logical partition. Valid values are:
|
|
- primary_paging_vios_id
- The ID of the primary paging Virtual I/O Server (VIOS) partition
that provides access to the paging space devices for the shared memory
partitions. A paging VIOS partition is a VIOS logical partition that
is assigned to the shared memory pool.
- primary_paging_vios_name
- The name of the primary paging VIOS partition that provides access
to the paging space devices for the shared memory partitions. A paging
VIOS partition is a VIOS logical partition that is assigned to the
shared memory pool.
- proc_mode
- Valid values:
- ded: dedicated processor mode
- shared: shared processor mode
- secondary_paging_vios_id
- The ID of the secondary paging Virtual I/O Server (VIOS) partition
that provides access to the paging space devices for the shared memory
partitions. A paging VIOS partition is a VIOS logical partition that
is assigned to the shared memory pool.
- secondary_paging_vios_name
- The name of the secondary paging VIOS partition that provides
access to the paging space devices for the shared memory partitions.
A paging VIOS partition is a VIOS logical partition that is assigned
to the shared memory pool.
- sharing_mode
- Valid values:
- share_idle_procs
- proc_mode=ded
- share_idle_procs_active
- share_idle_procs_always
- proc_mode=shared
- cap
- uncap
|
|
- uncap_weight
- A weighted average of processing priority when in uncapped sharing
mode. The smaller the value, the lower the weight. Valid values are:
0 - 255.
- virtual_eth_adapters
- Comma-separated list of virtual Ethernet adapters, with each adapter
having the following format: slot_number/is_ieee/port_vlan_id/additional_vlan_ids/
is_trunk/is_required
All 5 '/' characters must be present, but
optional values may be omitted. Optional values are additional-vlan-IDs,
and is-trunk. Valid values for is_ieee, is_trunk,
and is_required:
For example, 4/0/2//0/0 specifies a virtual
Ethernet adapter with a virtual slot number of 4, is not IEEE 802.1Q
enabled, has a port virtual LAN ID of 2, no additional virtual LAN
IDs, it is not a trunk adapter, and is not required. A value of
none indicates that there are no virtual Ethernet adapters.
|
|
- virtual_fc_adapters
- Comma-separated list of virtual fibre channel adapters. Each
item in the list has the following format:
virtual slot num/adapter_type/remote_lpar_id/
remote_lpar_name/remote_slot_num/wwpn_list/is_required
- 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).
- virtual_scsi_adapters
- Comma-separated list of virtual SCSI adapters. Each item in the
list has the following format:
slot_num/adapter_type/remote_lpar_id/remote_lpar_name/
remote_slot_num/is_required
|
|
- virtual_serial_adapters
- Comma-separated list of virtual serial adapters. Each item in
the list has the following format:
slot_num/adapter_type/supports_hmc/remote_lpar_id/
remote_lpar_name/remote_slot_num/is_required
The attribute
names are not present in the list, just their values are present.
If an attribute is optional and is not to be included, then no value
would be specified for that attribute. For example, 0/server/1/any//any/1 specifies
a virtual server serial device that has a virtual slot number of 0,
supports HMC,
supports any remote partition, supports any remote slot, and is required. A
value of none indicates that there are no virtual
serial adapters.
Valid values for adapter_type: - client: client adapter
- server: server adapter, valid for Virtual I/O Server partitions
only
Valid values for supports_hmc:
Valid values for is_required:
|
|
Attribute names for the managed system: - active_lpar_share_idle_procs_capable
- Indicates if the platform supports setting the share while active
sharing_mode. Valid values:
- 0 - not capable
- 1 - capable
- active_mem_sharing_capable
- The capability of the managed system to use a shared memory pool.
Valid values follow:
- 0 - Not capable
- 1 - Capable
|
|
- capabilities
- Displays a comma-separated list of capabilities.
- cod_mem_capable
- Valid values:
- 0- not capable of memory Capacity on Demand
- 1 - capable of memory Capacity on Demand
- cod_proc_capable
- Valid values:
- 0- not capable of processor Capacity on Demand
- 1 - capable of processor Capacity on Demand
- config_version
- The version of the configuration data in platform firmware of
the current logical partition .
|
|
- curr_configured_max_lpars
- The current maximum number of logical partitions supported by
the management logical partition
This option is deprecated. Instead
use: lshwres -r virtualio --rsubtype slot --level lpar
with
attribute "curr_max_virtual_slots" value for partition 1
- dlpar_mem_capable
- Valid values:
- 0: Changes do not take effect until the next
reboot of the logical partition or platform.
- 1: Changes take effect immediately.
|
|
- lhea_capable
- Indicates if the managed system has one or more Host Ethernet Adapters.
|
|
- lpar_avail_priority
- The priority of the partition to maintain its entitled processors.
If a processor failure occurs, processing resources will be removed
first from the lowest priority partition.
Note: The Virtual I/O Server partition must
have a higher priority than any other partition on the system.
- lpar_avail_priority_capable
- Specifies if the platform supports the lpar_avail_priority attribute.
Valid values:
- 0 - not capable
- 1 - capable
- lpar_comm_default
- Indicates if the lpar_comm_ipaddr is using the default
IP address, or if the user has manually set this using chsyscfg.
Valid values:
- 0: User has manually set the IP address
- 1: Default IP address is used. This is the first IP address configured
on your system as reported by lstcpip -interfaces
|
|
- lpar_comm_ipaddr
- The IP address through which client partitions will communicate
with the management partition. This is used primarily for dynamic
LPAR. It is defaulted to the first IP address configured on your system,
but can be manually set if desired.
Note: This attribute
supports multiple IP addresses using a comma-separated list.
- lpar_proc_compat_mode_capable
- The supported compatibility modes of the processor for the logical
partition. Valid values:
- 0: The managed system does not support setting the processor compatibility
mode for a partition.
- 1: The managed system supports setting the processor compatibility
mode for a partition.
- lpar_proc_compat_modes
- A comma separated list of compatibility modes that the managed
system supports.
|
|
- max_lpars
- Maximum number of partitions supported by firmware.
- max_power_ctrl_lpars
- Maximum number of power controlling partitions per controlled
partition.
- max_vscsi_remote_lpar_id
- Indicates the largest partition ID of the remote partition with
a virtual SCSI server adapter.
- max_micro_lpar_id
- Indicates largest partition ID of a partition using the MicroPartition
technology.
|
|
- micro_lpar_capable
- Valid values:
0: not capable of creating shared processor partitions
1: capable of creating shared processor partitions
- mfg_default_config
- Specifies whether or not the system is in the manufacturing default
partition configuration.
Valid values:
0: No
1: Yes
- name
- Name for the managed system.
|
|
- pend_configured_max_lpars
- The maximum number of partitions supported by the management partition
after the next restart.
This option is deprecated. Instead use: lshwres -r virtualio --rsubtype slot --level lpar
with
attribute "pend_max_virtual_slots" value for partition 1.
- pend_lpar_config_state
- Valid values:
- enabled: The logical partition configuration
data will be enabled during the next restart operation.
- disabled: The logical partition configuration
data will be disabled during the next restart operation.
- cleared: The logical partition configuration
data will be cleared to manufacturing defaults during the next restart
operation.
- power_off_policy
- Valid values:
- 0- Power off the managed system after all partitions are powered
off.
|
|
- os400_capable
- Indicates that the platform supports IBM i logical partitions.
Valid values:
- 0: not capable of running IBM i
- 1: capable of running IBM i
- serial_num
- Serial number for the managed system.
- service_lpar_id
- ID of the partition with platform service authority.
|
|
- service_lpar_name
- Name of the partition with platform service authority.
- state
- Valid values:
- Operating - The managed system is running.
- sys_time
- The UTC time of system firmware in the format month/day/year
hour:minute:second.
|
|
- type_model
- Type and model for the managed system
- vet_activation_capable
- Whether the platform supports PowerVM® Editions system
technologies activation. Valid values:
- 0 - not capable
- 1 - capable
- virtual_fc_capable
- A value indicating whether the managed system supports a virtual
fibre channel. Valid values follow:
- 0: The managed system does not support a virtual fibre channel.
- 1: The managed system supports a virtual fibre channel.
|
--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. |