IVM lssyscfg Command

Purpose

List attributes of partitions, partition profiles, or the managed system. This command is valid 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

-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 to view
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:

name
Name of the partition
lpar_id
unique integer identifier for the partition
lpar_env
The operating environment for this partition Valid values:
  • aixlinux: a partition type that supports AIX® or Linux®
  • vioserver: a Virtual I/O Server partition
state
The current runtime state of the partition Valid values:
  • Not Activated
  • Starting
  • Running
  • Shutting Down
  • Error
  • Open Firmware
  • Not Available
resource_config
Valid values:
  • 0 - resources are not available to power on with system
  • 1 - resources are available to power on with system
os_version
The operating system's version identifier
logical_serial_num
A globally unique string for this partition
default_profile
The default profile is always equal to the partition name
curr_profile
The current profile is always equal to the partition name
work_group_id
Valid values:
  • none: do not participate in the workload management group
  • 1: participate in the workload management group
shared_proc_pool_util_auth
Permission for the partition to retrieve shared processor pool utilization information Valid values:
  • 0: do not allow authority
  • 1: allow authority
power_ctrl_lpar_ids
A list of partitions which have power control over this partition. Valid values:
  • none: No partitions
boot_mode
Partition power on mode. Valid values:
  • norm: normal
  • dd: diagnostic with default boot list
  • ds: diagnostic with stored boot list
  • of: Open Firmware OK prompt
  • sms: System Management Services
lpar_keylock
Partition keylock position. Valid values:
  • norm: normal keylock
  • manual: manual keylock
auto_start
Valid values:
  • 0 - do not automatically start with system power on
  • 1 - automatically start with system power on
uptime
Partition uptime in seconds.
mem_synchronized
The current and pending memory values for this partition are synchronized.
proc_synchronized
The current and pending processing values for this partition are synchronized.
rmc_state
The state of the RMC connection between the management partition and the client partition. The RMC connection is used primarily for Dynamic Logical Partitioning (DLPAR). Valid values:
  • inactive
  • active
  • unknown
  • none - RMC not configured. This partition has never been registered with RMC.
rmc_ipaddr
The IP address of the client partition. This IP address is used by RMC to connect to the client partition for Dynamic Logical Partitioning (DLPAR).
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:
  • 0 - no
  • 1 - yes
dlpar_mem_capable
Indicates if the partition supports Dynamic Logical Partitioning (DLPAR) of memory. Valid values:
  • 0 - no
  • 1 - yes
dlpar_proc_capable
Indicates if the partition supports Dynamic Logical Partitioning (DLPAR) of processing resources. Valid values:
  • 0 - no
  • 1 - yes

Attribute names for partition profiles:

name
Name of the profile
lpar_name
Name of the partition
lpar_id
Unique integer identifier for the partition
os_type
The operating system environment for this partition. Valid values:
  • aixlinux: an RPA partition type which supports AIX or Linux
  • vioserver: a Virtual I/O Server partition
all_resources
Valid values:
  • 0: this partition will not own all physical resources on the system
min_mem
The minimum megabytes of memory for this partition
desired_mem
The assigned megabytes of memory for this partition
max_mem
The maximum megabytes of memory for this partition
proc_mode
Valid values:
  • ded: dedicated processor mode
  • shared: shared processor mode
min_proc_units
The minimum number of processing units for this partition
desired_proc_units
The assigned number of processing units for this partition
max_proc_units
The maximum number of processing units for this partition
min_procs
The minimum number of processors for this partition. In shared processing mode, this refers to virtual processors.
desired_procs
The assigned number of processors for this partition. In shared processing mode, this refers to virtual processors.
max_procs
The maximum number of processors for this partition. In shared processing mode, this refers to virtual processors.
sharing_mode
Valid values:
  • keep_idle_procs - valid with dedicated processor mode
  • share_idle_procs - valid with dedicated processor mode
  • cap - capped mode. valid with shared processor mode
  • uncap - uncapped mode. valid with shared processor mode
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
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

The attribute names are not present in the list, just their values are present. For example, 21010003/none/1, specifies an I/O slot with a DRC index of 0x21010003 which is not assigned to an I/O pool, and it is a required slot.

Valid values for is_required:

  • 0 - no
  • 1 - yes
lpar_io_pool_ids
Valid values are:
  • none - this partition is not part of an I/O pool
max_virtual_slots
Maximum number of virtual I/O adapter slots
virtual_serial_adapters
Comma separated list of virtual serial adapters. Each item in this list has the 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
virtual_scsi_adapters
Comma separated list of virtual SCSI adapters. Each item in this list has the format:
slot_num/adapter_type/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:
4/client//lpar2/3/0
specifies a virtual client SCSI adapter with a virtual slot number of 4, a server partition name of lpar2, a server slot number of 3, and is not required. The server partition ID was omitted.

A value of none indicates that there are no virtual SCSI adapters.

Valid values for adapter_type:

  • client: client adapter
  • server: server adapter, valid for Virtual I/O Server partitions only.

Valid values for is_required:

  • 0 - no
  • 1 - yes
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.

boot_mode
Partition power on mode. Valid values:
  • 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
auto_start
Valid values:
  • 0 - do not automatically start with system power on
  • 1 - automatically start with system power on
power_ctrl_lpar_ids
A list of partitions which have power control over this partition Valid values are:
  • none - No partitions
power_ctrl_lpar_names
A list of partitions which have power control over this partition Valid values are:
  • none - No partitions

Attribute names for the managed system:

name
Name for the managed system
type_model
Type and model for the managed system
serial_num
Serial number for the managed system
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.
power_off_policy
Valid values:
  • 0- power off the managed system after all partitions are powered off
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
os400_capable
Valid values:
  • 0: not capable of running i5/OS®
  • 1: capable of running i5/OS
micro_lpar_capable
Valid values:
0: not capable of creating shared processor partitions
1: capable of creating shared processor partitions
dlpar_mem_capable
Valid values:
  • 0: Changes do not take effect until the next reboot of the partition or platform.
  • 1: Changes take effect immediately.
max_lpars
Maximum number of partitions supported by firmware
max_power_ctrl_lpars
Maximum number of power controlling partitions per controlled partition
service_lpar_id
ID of the partition with platform service authority
service_lpar_name
Name of the partition with platform service authority
mfg_default_config
Valid values:
0: the system is not in the manufacturing default partition configuration
1: the system is in the manufacturing default partition configuration
curr_configured_max_lpars
The current maximum number of partitions supported by the management partition
pend_configured_max_lpars
The maximum number of partitions supported by the management partition after the next restart
config_version
The version of the current partition configuration data in platform firmware
pend_lpar_config_state
Valid values:
  • enabled: the partition configuration data will be enabled during the next restart
  • disabled: the partition configuration data will be disabled during the next restart
  • cleared: the partition configuration data will be cleared to manufacturing defaults during the next restart
lpar_comm_ipaddr
The IP address through which client partitions will communicate with the management partition. This is used primarily for Dynamic Logical Partitioning (DLPAR). It is defaulted to the first IP address configured on your system, but can be manually set if desired.
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
--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 zero 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

Related Information

The chsyscfg command, the mksyscfg command, and the rmsyscfg command.


Send feedback |  Rate this page