IVM lssyscfg command

Purpose

List attributes of partitions, partition profiles, or the managed system. This command is operable only in an Integrated Virtualization Manager environment.

Syntax

To list partition attributes:

lssyscfg -r lpar [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list partition profile attributes:

lssyscfg -r prof [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list system attributes:

lssyscfg -r sys [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

Description

The lssyscfg command lists attributes of partitions, partition profiles, or the managed system.

Flags

Flag name Description
-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:
  • 0 - no
  • 1 - yes
 
dlpar_proc_capable
Indicates if the partition supports dynamic LPAR of processing resources. Valid values:
  • 0 - no
  • 1 - yes
ipl_source
The IPL source for the IBM® i logical partition. This attribute is optional. Valid values:
  • a
  • b
  • c
  • d
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:
  • none: No partitions
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:
  • 0 - no
  • 1 - yes
 
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:
  • 0 - no
  • 1 - yes
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:
  • none - No partitions
power_ctrl_lpar_names
A list of logical partitions which have power control over this logical partition. Valid values are:
  • none - No partitions
 
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:
  • 0 - no
  • 1 - yes
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:
  • 0 - no
  • 1 - yes
Valid values for is_required:
  • 0 - no
  • 1 - yes
 
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.

Exit Status

This command has a return code of 0 on success.

Security

This command is accessible by all users.

Examples

  1. To list the attributes for the managed system, type:
    lssyscfg -r sys
  2. To list only the user-defined name, machine type and model, and serial number for the managed system, type:
    lssyscfg -r sys -F name,type_model,serial_num
  3. To list all partitions and only display attribute values for each partition following a header of attribute names, type:
    lssyscfg -r lpar -F --header
  4. To list the partitions named lpar1, lpar2, and lpar3, type:
    lssyscfg -r lpar --filter \"lpar_names=lpar1,lpar2,lpar3\"
  5. To list the partition profile for partition lpar2, type:
    lssyscfg -r prof --filter lpar_names=lpar2
  6. To view the desired compatibility mode in the profile, type:
    lyssyscfg -r prof -F lpar_proc_compat_mode



Last updated: Wed, November 18, 2020