| -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 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, 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, vpd_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 unit: List attributes for physical
I/O units
- Attributes: unit_phys_loc
- Filters: units
- -r mem --level lpar: List partition attributes for
memory
- Attributes: lpar_name, lpar_id, curr_min_mem, curr_mem, curr_max_mem,
pend_min_mem, pend_mem, pend_max_mem, run_min_mem, run_mem
- 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
- Additional attributes with --maxmem: required_min_mem_aix_linux
- Filters: None
- -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 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
- 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, 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 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 serial --level lpar: List
virtual serial adapter attributes
- Attributes: lpar_name, lpar_id, slot_num, state, adapter_type, supports_hmc,
remote_lpar_id, remote_lpar_name, remote_slot_num, is_required
- 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
|
| --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 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:
- buses
- The bus ID of the I/O bus to view
- lpar_ids | lpar_names
- Name or ID of the partition to view
- pools
- The pool ID of the I/O pool to view
- 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 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_type
- Indicates whether the virtual SCSI or serial adapter is a client or
server. Valid values are client and server.
- 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
- config
- Virtual slot configuration state. Possible values:
- empty - no adapter
- ethernet - virtual ethernet adapter
- scsi - virtual scsi adapter
- serial - virtual serial adapter
- vmc - virtual management channel adapter
- 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
- 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_max_mem
- Maximum amount of memory, in megabytes, that can be dynamically assigned
to the partition
|
|
- 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_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_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
- Current number of processing units assigned to the partition. This
attribute is only valid for partitions using shared processors.
- curr_procs
- 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
- 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
- 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
- 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.
- 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.
- 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,aix_feature_code2/linux_feature_code2,...
- 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:
- iop_info_stale
- Indicates whether the information about the I/O processor is stale.
Valid values:
- is_required
- Indicates whether the I/O slot or virtual I/O adapter is required for
the partition. Valid values:
- is_trunk
- Indicates whether the virtual ethernet adapter is the trunk or uplink
adapter for the virtual LAN. Valid values:
- lpar_ids
- Partition ID. Valid values are 1 through the maximum number of partitions
supported on the managed system (max_lpars).
- lpar_name
- User defined name for the partition.
- 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 (e.g. 32ab10) and can only be configured in the mkgencfg command.
- max_io_pools
- Maximum number of I/O pools supported on the managed system
- max_shared_proc_pools
- Maximum number of shared processing pools which are supported on the
managed system
- 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_proc_units_per_virtual_proc
- Minimum number of processing units that are required for each virtual
processor assigned to a partition
- parent_slot_drc_index
- 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 hex.
- 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_max_mem
- After partition restart, the maximum amount of memory, in megabytes,
that can be dynamically assigned to the partition
- 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 partiton.
- pend_mem
- The target amount of memory, in megabytes, assigned to the partition.
- 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_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
- Physical location code of the slot.
- port_vlan_id
- Port virtual LAN ID for the virtual ethernet adapter.
- 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.
- run_mem
- Current amount of memory, in megabytes, that the partition has varied
on.
- 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 will be 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_proc_pool_id
- A unique decimal identifier for a shared processing pool.
- 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:
- off - the virtual slot is ready for dynamic reconfiguration
- on - the virtual slot is not yet ready for dynamic reconfiguration
- supports_hmc
- Indicates whether or not the virtual serial adapter is enabled for HMC
client support. Valid values:
- sys_firmware_mem
- Amount of memory, in megabytes, on the managed system that is being
used by system firmware.
- unit_phys_loc
- Physical location code of the I/O unit.
|
|
- 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.
|
| --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. |