---

HMC Manual Reference Pages  - LSSYSCFG (1)

---

lssyscfg - list system resources

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

lssyscfg -r {lpar | prof | sys | sysprof | cage | frame}
[-m managed-system | -e managed-frame]
[--osrefresh] [--lastvalidcfg]
[--filter "filter-data"]
[-F [attribute-names] [--header]] [--help]

lssyscfg lists the attributes of partitions, partition profiles, or system profiles for the managed-system. It can also list the attributes of the managed-system, and of all of the systems managed by this Hardware Management Console (HMC).

lssyscfg can also list the attributes of cages in the managed-frame, the attributes of the managed-frame, or the attributes of all of the frames managed by this HMC.

-r	The type of resources to list. Valid values are lpar for partitions, prof for partition profiles, sys for managed systems, sysprof for system profiles, cage for managed frame cages, and frame for managed frames.
-m	The name of either the managed system to list, or the managed system which has the system resources to list. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name. This option is required when listing partitions, partition profiles, or system profiles. This option is optional when listing managed systems, and if it is omitted, then all of the systems managed by this HMC will be listed. This option is not valid when listing managed frame cages or managed frames.
-e	The name of either the managed frame to list, or the managed frame which contains the cages to list. The name may either be the user-defined name for the managed frame, or be in the form tttt-mmm*sssssss, where tttt is the type, mmm is the model, and sssssss is the serial number of the managed frame. The tttt-mmm*sssssss form must be used if there are multiple managed frames with the same user-defined name. This option is required when listing managed frame cages. This option is optional when listing managed frames, and if it is omitted, then all of the frames managed by this HMC will be listed. This option is not valid when listing partitions, partition profiles, system profiles, or managed systems.
--osrefresh	When listing partitions, specify this option to refresh the current operating system version information for the partitions first. If a partition does not have an active RMC connection to the management console, Unknown will be displayed for that partition’s operating system version information. Specifying this option may cause this command to take a long time to complete if many partitions are being listed or there are network issues. This option is only valid when listing partitions.
--lastvalidcfg	When listing partition profiles, specify this option to include the last valid configuration partition profiles. This option is only valid when listing partition profiles.
--filter	The filter(s) 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 of 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 ’#146; character. Multiple values can be specified for each filter. Valid filter names for partitions: lpar_names | lpar_ids | work_groups Only one of these three filters may be specified. Valid filter names for partition profiles: lpar_names | lpar_ids, profile_names Valid filter names for system profiles: profile_names This option is not valid when listing managed systems, managed frame cages, or managed frames.
-F	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. To display the values of only selected properties of the sriov_eth_logical_ports partition profile attribute, use the following format: sriov_eth_logical_ports=property-name:property-name:... If no property names are specified, then values for all of the properties for each SR-IOV ethernet logical port will be displayed. Descriptions of selected command attributes: capabilities A comma separated list of managed system capabilities. Capabilities that are supported by the managed system are displayed in the list. Capabilities that are not supported are not displayed.
--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.
--help	Display the help text for this command and exit.

List all systems managed by this HMC:

lssyscfg -r sys

List only the user-defined name, machine type and model, and serial number for all of the systems managed by this HMC, and separate the output values with a colon:

lssyscfg -r sys -F name:type_model:serial_num

List the managed system system1:

lssyscfg -r sys -m system1

List all of the capabilities supported by managed system system1:

lssyscfg -r sys -m system1 -F capabilities

List all partitions in the managed system, and only display attribute values for each partition, following a header of attribute names:

lssyscfg -r lpar -m 9406-570*1234567 -F --header

List the partitions lpar1, lpar2, and lpar3:

lssyscfg -r lpar -m system1 --filter ""lpar_names=lpar1,
lpar2,lpar3""

List only the names, IDs, and states of partitions lpar1, lpar2, and lpar3, and separate the output values with a comma:

lssyscfg -r lpar -m system1 --filter ""lpar_names=lpar1,
lpar2,lpar3"" -F name,lpar_id,state

Refresh the operating system version information for partition aix1, then list the partition:

lssyscfg -r lpar -m system1 --filter "lpar_names=aix1" --osrefresh

List all partition profiles in the managed system:

lssyscfg -r prof -m 9406-570*1234567

List all partition profiles in the managed system and include the last valid configuration partition profiles:

lssyscfg -r prof -m 9406-570*1234567 --lastvalidcfg

List all partition profiles defined for partition lpar2:

lssyscfg -r prof -m system1 --filter "lpar_names=lpar2"

List the partition profiles prof1 and prof2 defined for the partition that has an ID of 2:

lssyscfg -r prof -m system1 --filter "lpar_ids=2,
"profile_names=prof1,prof2""

List the values of all properties for all SR-IOV ethernet logical ports in all partition profiles in the managed system:

lssyscfg -r prof -m system1 -F sriov_eth_logical_ports

List the values of specific properties for all SR-IOV ethernet logical ports in all partition profiles in the managed system:

lssyscfg -r prof -m system1 -F sriov_eth_logical_ports=config_id:
adapter_id:logical_port_id:port_vlan_id

List all system profiles defined for the managed system:

lssyscfg -r sysprof -m 9406-520*100128A

List the system profile sysprof1:

lssyscfg -r sysprof -m system1 --filter "profile_names=
sysprof1"

List all frames managed by this HMC:

lssyscfg -r frame

List the managed frame myFrame:

lssyscfg -r frame -e myFrame

List all cages in the managed frame:

lssyscfg -r cage -e 9119-59*000012C

None

None

IBM Austin

chsyscfg, mksyscfg, rmsyscfg, lshwres