HMC Manual Reference Pages  - CHHWRES (1)

NAME
chhwres - change hardware resources

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS
To add, remove, or move a physical I/O slot:
chhwres -r io -m managed-system -o {a | r | m}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
-l slot-DRC-indexes [-a "attributes"]
[-w wait-time] [-d detail-level] [--force]

To set physical I/O attributes:
chhwres -r io -m managed-system -o s
{-p partition-name | --id partition-ID}
--rsubtype {iopool | taggedio}
-a "attributes"

To clear a physical I/O slot or bus:
chhwres -r io -m managed-system -o c
[--rsubtype {bus | slot}] [-l slot-DRC-index]

To add or remove a virtual I/O adapter:
chhwres -r virtualio -m managed-system -o {a | r}
{-p partition-name | --id partition-ID}
[--rsubtype {eth | fc | scsi | serial | vnic}]
[-s virtual-slot-number] [-a "attributes"]
[-w wait-time] [-d detail-level] [--force] [-v]

To change a virtual ethernet adapter or virtual NIC assigned to a partition:
chhwres -r virtualio -m managed-system -o s
--rsubtype {eth | vnic}
{-p partition-name | --id partition-ID}
-s virtual-slot-number -a "attributes"
[-w wait-time] [-d detail-level] [--force]
[--allownetdisrupt]

To enable or disable a virtual ethernet adapter or virtual NIC:
chhwres -r virtualio -m managed-system -o {d | e}
--rsubtype {eth | vnic}
{-p partition-name | --id partition-ID}
-s virtual-slot-number

To set virtual I/O attributes:
chhwres -r virtualio -m managed-system -o s
[{-p partition-name | --id partition-ID}]
--rsubtype {eth | virtualopti | vnic}
-a "attributes"

To set virtual NIC backing device attributes:
chhwres -r virtualio -m managed-system -o s
--rsubtype vnicbkdev
{-p partition-name | --id partition-ID}
-s virtual-slot-number --logport logical-port-ID
-a "attributes"

To make a virtual NIC backing device active or clear a virtual NIC backing device error:
chhwres -r virtualio -m managed-system -o {act | c}
--rsubtype vnicbkdev
{-p partition-name | --id partition-ID}
-s virtual-slot-number --logport logical-port-ID

To switch over all virtual NIC backing devices on the managed system from the specified Virtual I/O Server (VIOS) partition to other VIOS partitions:
chhwres -r virtualio -m managed-system -o so --rsubtype vnicbkdev
{-p VIOS-partition-name | --id VIOS-partition-ID}

To add or remove a virtual network or set virtual network attributes:
chhwres -r virtualio -m managed-system -o {a | r | s}
--rsubtype vnetwork --vnetwork virtual-network
[-a "attributes"]

To add or remove a virtual switch:
chhwres -r virtualio -m managed-system -o {a | r}
--rsubtype vswitch --vswitch virtual-switch
[-a "attributes"]

To set virtual switch attributes:
chhwres -r virtualio -m managed-system -o s
--rsubtype vswitch --vswitch virtual-switch
[-a "attributes"] [--force]

To synchronize the virtual switch mode:
chhwres -r virtualio -m managed-system -o sync
--rsubtype vswitch --vswitch virtual-switch

To add, remove, or move memory:
chhwres -r mem -m managed-system -o {a | r | m | s}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
[-q quantity] [--entitled quantity]
[-w wait-time] [-d detail-level] [--force]

To set memory attributes for the managed system:
chhwres -r mem -m managed-system -o s
-a "attributes"

To set memory attributes for a partition:
chhwres -r mem -m managed-system -o s
{-p partition-name | --id partition-ID}
-a "attributes"
[-w wait-time] [-d detail-level] [--force]

To switch over a running shared memory partition to its redundant paging VIOS partition:
chhwres -r mem -m managed-system -o so
{-p partition-name | --id partition-ID}

To reset I/O entitled memory statistics for a partition:
chhwres -r mem -m managed-system -o rs
{-p partition-name | --id partition-ID}
[-w wait-time] [-d detail-level]

To add or remove a shared memory pool, or set shared memory pool attributes:
chhwres -r mempool -m managed-system -o {a | r | s}
[-a "attributes"]

To add or remove a device in the shared memory pool (on managed systems that support partition suspend and resume operations, this adds or removes a device in the reserved storage device pool):
chhwres -r mempool -m managed-system -o {a | r}
{-p paging-VIOS-partition-name |
--id paging-VIOS-partition-ID}
--rsubtype pgdev --device device-name

To add or remove a reserved storage device pool, or set reserved storage device pool attributes (only supported on managed systems that support partition suspend and resume operations):
chhwres -r rspool -m managed-system -o {a | r | s}
[-a "attributes"]

To add or remove a device in the reserved storage device pool (only supported on managed systems that support partition suspend and resume operations):
chhwres -r rspool -m managed-system -o {a | r}
{-p VIOS-partition-name | --id VIOS-partition-ID}
--rsubtype rsdev --device device-name [--manual]

To add, remove, or change a persistent memory volume:
chhwres -r pmem -m managed-system -o {a | r | s}
--rsubtype volume --volume volume-name [--device dram]
[{-p partition-name | --id partition-ID}]
[-a "attributes"]

To add, remove, or move processing resources:
chhwres -r proc -m managed-system -o {a | r | m | s}
{-p partition-name | --id partition-ID}
[{-t target-partition-name |
--tid target-partition-ID}]
[--procs quantity] [--procunits quantity]
[-w wait-time] [-d detail-level] [--force]

To set processing attributes for the managed system:
chhwres -r proc -m managed-system -o s -a "attributes"

To set processing attributes for a partition:
chhwres -r proc -m managed-system -o s
{-p partition-name | --id partition-ID}
-a "attributes"

To set shared processor pool attributes on a managed system that supports multiple shared processor pools:
chhwres -r procpool -m managed-system -o s
{--poolname pool-name | --poolid pool-ID}
-a "attributes"

To set shared processor pool attributes for a partition on a managed system that supports multiple shared processor pools:
chhwres -r procpool -m managed-system -o s
{-p partition-name | --id partition-ID}
-a "attributes"

To switch an SR-IOV adapter to shared mode:
chhwres -r sriov -m managed-system --rsubtype adapter
-o a -a "attributes"
To switch an SR-IOV adapter to dedicated mode:
chhwres -r sriov -m managed-system --rsubtype adapter
-o r -a "attributes"
To move the configuration of a failed SR-IOV adapter to a new adapter:
chhwres -r sriov -m managed-system --rsubtype adapter
-o m -a "attributes"
To set SR-IOV physical port attributes:
chhwres -r sriov -m managed-system --rsubtype physport
-o s -a "attributes"
To add or remove an SR-IOV logical port, to recover a migratable SR-IOV logical port, or to set SR-IOV logical port attributes:
chhwres -r sriov -m managed-system --rsubtype logport
-o {a | r | rc | s}
{-p partition-name | --id partition-ID}
-a "attributes"
[-w wait-time] [-d detail-level] [--force]

To enable or disable an SR-IOV logical port:
chhwres -r sriov -m managed-system --rsubtype logport -o {d | e}
{-p partition-name | --id partition-ID}
-a "attributes"

To reset statistics for an SR-IOV logical or physical port:
chhwres -r sriov -m managed-system -o rs
--rsubtype {logport | physport}
-a "attributes"

To set GZIP hardware accelerator resources for a partition:
chhwres -r accel -m managed-system --rsubtype gzip -o s
-q QoS {-p partition-name | --id partition-ID}
[-w wait-time] [-d detail-level] [--force]

DESCRIPTION
chhwres changes the hardware resource configuration of the managed-system. chhwres is used to perform dynamic logical partitioning (DLPAR) operations.

When chhwres is used to add a virtual I/O adapter to a Virtual I/O Server (VIOS) partition, chhwres issues the VIOS cfgdev command to configure the device in the VIOS. When chhwres is used to remove a virtual I/O adapter from a VIOS partition, chhwres issues the VIOS rmdev command to remove the device from the VIOS partition.

When chhwres is used to remove memory or processing resources from a shutdown partition, if the amount of memory or processing resources falls below the minimum for the partition, the minimum, assigned, and maximum values for the partition are all set to 0. Also, if the memory values for a partition are set to 0, the processing resource values for the partition will also be set to 0. Likewise, if the processing resource values for a partition are set to 0, the memory values for the partition will also be set to 0.

OPTIONS
-r The type of hardware resources to change. Valid values are io for physical I/O, virtualio for virtual I/O, mem for memory, mempool for shared memory pool, rspool for reserved storage device pool, pmem for persistent memory, proc for processing, procpool for shared processor pool, sriov for Single Root I/O Virtualization (SR-IOV), and accel for hardware accelerator resources.

Reserved storage device pool operations are only supported on managed systems that support partition suspend and resume operations.

--rsubtype The subtype of hardware resources to change. Valid physical I/O resource subtypes are slot for I/O slots, bus for I/O buses, iopool for I/O pools, and taggedio for tagged I/O resources. Valid virtual I/O resource subtypes are eth for virtual ethernet, fc for virtual fibre channel, scsi for virtual SCSI, serial for virtual serial, virtualopti for virtual OptiConnect, vnetwork for virtual network, vnic for virtual NIC, vnicbkdev for virtual NIC backing device, and vswitch for virtual switch resources. Valid SR-IOV resource subtypes are adapter for SR-IOV adapter resources, logport for SR-IOV logical port resources, and physport for SR-IOV physical port resources. Valid persistent memory resource subtypes are volume for persistent memory volume resources. Valid hardware accelerator resource subtypes are gzip for GZIP hardware accelerator resources.

The only valid shared memory pool resource subtype is pgdev for paging space devices. The only valid reserved storage device pool resource subtype is rsdev for reserved storage devices. On a managed system that supports Active Memory Sharing and partition suspend and resume operations, the command chhwres -m managed-system -r mempool --rsubtype pgdev -o {a | r} -p VIOS-partition-name --device device-name adds or removes a device in the reserved storage device pool, and is equivalent to the command chhwres -m managed-system -r rspool --rsubtype rsdev -o {a | r} -p VIOS-partition-name --device device-name.

This option is required for physical I/O and virtual I/O set operations, for virtual I/O add operations, and for virtual network, virtual switch, SR-IOV, persistent memory, and hardware accelerator operations. This option is not valid for memory, processor, or shared processor pool operations.

-m The name of the managed system for which the hardware resource configuration is to be changed. 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.
-o The operation to perform. Valid values are a to add hardware resources, r to remove hardware resources, m to move hardware resources from one partition to another, s to set hardware resources or attributes, d to disable a virtual ethernet adapter, virtual NIC, or SR-IOV logical port, e to enable a virtual ethernet adapter, virtual NIC, or SR-IOV logical port, rs to reset I/O entitled memory statistics for a partition or to reset statistics for an SR-IOV logical or physical port, so to switch over a running shared memory partition to its redundant paging VIOS partition or to switch over all virtual NIC backing devices on the managed system from the specified VIOS partition to other VIOS partitions, sync to synchronize the virtual switch mode, c to clear a physical I/O slot or bus, or clear a virtual NIC backing device error, act to make a virtual NIC backing device active, or rc to recover a migratable SR-IOV logical port.

The c operation is useful for clearing stale physical I/O slot or bus information after a physical I/O adapter or drawer has been concurrently removed but not replaced.

-p The name of the partition for which to perform the operation. For a move operation, this is the source partition (the partition the resources will be moved from) for the operation.

When adding or removing a device in the shared memory pool or the reserved storage device pool, use this option to specify the name of the VIOS partition which has the device. If the device is accessed by more than one VIOS partition, then only one of the VIOS partitions must be specified, and the device name specified with the --device option must be the name of the device on that VIOS partition.

When switching over virtual NIC backing devices from one VIOS partition to other VIOS partitions, use this option to specify the name of the VIOS partition from which to switch over the virtual NIC backing devices.

You can either use this option to specify the name of the partition for which to perform the operation, or use the --id option to specify the partition’s ID. The -p and the --id options are mutually exclusive.

--id The ID of the partition for which to perform the operation. For a move operation, this is the source partition (the partition the resources will be moved from) for the operation.

When adding or removing a device in the shared memory pool or the reserved storage device pool, use this option to specify the ID of the VIOS partition which has the device. If the device is accessed by more than one VIOS partition, then only one of the VIOS partitions must be specified, and the device name specified with the --device option must be the name of the device on that VIOS partition.

When switching over virtual NIC backing devices from one VIOS partition to other VIOS partitions, use this option to specify the ID of the VIOS partition from which to switch over the virtual NIC backing devices.

You can either use this option to specify the ID of the partition for which to perform the operation, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive.

-t The name of the target partition for a move operation.

You can either use this option to specify the name of the target partition, or use the --tid option to specify the ID of the partition. The -t and the --tid options are mutually exclusive.

A target partition is required to be specified with this option or the --tid option for a move operation. This option is not valid for any other operation.

--tid The ID of the target partition for a move operation.

You can either use this option to specify the ID of the target partition, or use the -t option to specify the name of the target partition. The --tid and the -t options are mutually exclusive.

A target partition is required to be specified with this option or the -t option for a move operation. This option is not valid for any other operation.

--poolname The name of the shared processor pool for which to set attributes.

You can either use this option to specify the name of the shared processor pool, or use the --poolid option to specify the ID of the shared processor pool. The --poolname and the --poolid options are mutually exclusive.

A shared processor pool is required to be specified with this option or the --poolid option when setting the attributes for a shared processor pool. This option is not valid for any other operation.

--poolid The ID of the shared processor pool for which to set attributes.

You can either use this option to specify the ID of the shared processor pool, or use the --poolname option to specify the name of the shared processor pool. The --poolid and the --poolname options are mutually exclusive.

A shared processor pool is required to be specified with this option or the --poolname option when setting the attributes for a shared processor pool. This option is not valid for any other operation.

-l The DRC index of the physical I/O slot to add, remove, move, or clear.

When adding, removing, or moving physical I/O slots, one or more DRC indexes can be specified. Multiple DRC indexes must be comma separated.

When clearing a physical I/O slot, only one DRC index can be specified.

-s The virtual slot number of the virtual I/O adapter to add, change, disable, enable, or remove. When performing an operation on a virtual NIC backing device, this is the virtual slot number of the virtual NIC.

When adding a virtual I/O adapter, if this option is not specified then the next available virtual slot number will be assigned to the virtual I/O adapter.

When changing, disabling, enabling, or removing a virtual I/O adapter, or when performing an operation on a virtual NIC backing device, this option is required.

-q The quantity of memory to add, remove, move, or set, or the Quality of Service (QoS) hardware accelerator value to set.

The quantity of memory specified must be in megabytes and it must be a multiple of the memory region size for the managed-system.

For a partition using shared memory, this is the quantity of logical memory to add, remove, or set. Memory move operations are not supported for partitions using shared memory.

When adding memory to a partition or removing memory from a partition, you can either specify an add or remove operation and specify the amount of memory you want to add or remove, or you can specify a set operation and specify the total amount of memory you want the partition to have when the operation completes.

When the current, pending, and runtime memory values for a partition are not the same and an add or remove operation is being performed, the quantity of memory specified with this option is added to or removed from the current value.

--entitled The quantity of I/O entitled memory to add, remove, or set. The quantity specified must be in megabytes, or quantity can be auto. If quantity is a number, then automatic I/O entitled memory management will no longer be provided for the partition after the quantity of I/O entitled memory is added, removed, or set. If quantity is auto, then the partition will be set to have automatic I/O entitled memory management, and if necessary, I/O entitled memory will be added or removed at this time so that the partition has the amount of memory required with automatic I/O entitled memory management.

When adding I/O entitled memory to a partition or removing I/O entitled memory from a partition, you can either specify an add or remove operation and specify the amount of I/O entitled memory you want to add or remove, or you can specify a set operation and specify the total amount of I/O entitled memory you want the partition to have when the operation completes.

This option is only valid for partitions using shared memory.

--procs When adding or removing processing resources to or from a partition using dedicated processors, or when moving processing resources from a partition using dedicated processors to another partition using dedicated processors, use this option to specify the quantity of dedicated processors to add, remove, move, or set.

When adding or removing processing resources to or from a partition using shared processors, or when moving processing resources from a partition using shared processors to another partition using shared processors, use this option to specify the quantity of virtual processors to add, remove, move, or set.

When moving processing resources from a partition using dedicated processors to a partition using shared processors, use this option to specify the quantity of dedicated processors to be moved from the source partition and added as shared processors to the target partition.

This option is not valid when moving processing resources from a partition using shared processors to a partition using dedicated processors. The --procunits option must be used instead.

The quantity of processing resources specified with this option must be a whole number.

When adding processing resources to a partition or removing processing resources from a partition, you can either specify an add or remove operation and specify the number of processing resources you want to add or remove, or you can specify a set operation and specify the total number of processing resources you want the partition to have when the operation completes.

When the current, pending, and runtime processing resource values for a partition are not the same and an add or remove operation is being performed, the quantity of processing resources specified with this option is added to or removed from the current value.

--procunits When adding or removing processing resources to or from a partition using shared processors, or when moving processing resources from a partition using shared processors to another partition using shared processors, use this option to specify the quantity of processing units to add, remove, move, or set.

When moving processing resources from a partition using shared processors to a partition using dedicated processors, use this option to specify the quantity of shared processors to be moved from the source partition and added as dedicated processors to the target partition.

This option is not valid when moving processing resources from a partition using dedicated processors to a partition using shared processors. The --procs option must be used instead.

When moving processing resources from a partition using shared processors to a partition using dedicated processors, the quantity of processing units specified with this option must be a whole number. Otherwise, the quantity of processing units specified with this option can have up to 2 decimal places.

When adding processing resources to a partition or removing processing resources from a partition, you can either specify an add or remove operation and specify the number of processing resources you want to add or remove, or you can specify a set operation and specify the total number of processing resources you want the partition to have when the operation completes.

When the current, pending, and runtime processing resource values for a partition are not the same and an add or remove operation is being performed, the quantity of processing resources specified with this option is added to or removed from the current value.

--logport The ID of the SR-IOV logical port of the virtual NIC backing device.
--vnetwork The virtual network name.

This option is required for all virtual network operations. This option is not valid for any other operation.

--vswitch The virtual switch name.

This option is required for all virtual switch operations. This option is not valid for any other operation.

--device When adding or removing a device in the shared memory pool or the reserved storage device pool, specify the name of the device to add or remove.

When adding a persistent memory volume, specify dram to add a persistent memory dynamic random access memory (DRAM) volume.

This option is required when adding or removing a device in the shared memory pool or the reserved storage device pool. It is also required when adding a persistent memory volume. This option is not valid for any other operation.

--volume The persistent memory volume name.

This option is required when performing a persistent memory operation. This option is not valid for any other operation.

--manual When adding a device to the reserved storage device pool, specify this option to indicate that the device will only be available for manual assignment to partitions by the user. A reserved storage device that is added to the pool as a manual device cannot be automatically assigned to a partition by the Hardware Management Console (HMC).

If this option is not specified when adding a device to the reserved storage device pool, the device will only be available for automatic assignment to partitions by the HMC.

This option is only valid when adding a device to the reserved storage device pool.

-w The maximum time, in minutes, to wait for partition operating system commands issued by the HMC to complete. If a partition operating system command does not complete within the time specified, the operation will be stopped.

wait-time must be a whole number. If wait-time is 0, partition operating system commands will not be timed out.

If this option is not specified, a default value of 120 minutes is used for memory remove operations, and a default value of 5 minutes is used for all other operations.

This option is valid for add, remove, move, and memory, processor, and hardware accelerator set operations for AIX, Linux, and VIOS partitions. In addition, this option is valid for I/O entitled memory statistics reset operations and for migratable SR-IOV logical port recover operations for AIX and Linux partitions. This option is also valid for memory add, remove, move, and set operations for IBM i partitions, and when changing the additional VLAN IDs for a virtual ethernet adapter assigned to a VIOS partition.

-d The level of detail to request from partition operating system commands issued by the HMC. Valid values are 1 (lowest) through 4 (highest).

If this option is not specified, a default value of 1 is used.

This option is valid for add, remove, move, and memory, processor, and hardware accelerator set operations for AIX, Linux, and VIOS partitions. In addition, this option is valid for I/O entitled memory statistics reset operations and for migratable SR-IOV logical port recover operations for AIX and Linux partitions. This option is also valid when changing the additional VLAN IDs for a virtual ethernet adapter assigned to a VIOS partition.

--force This option allows you to force a remove or move operation to be performed for a physical I/O slot that is currently in use (varied on) by an IBM i partition.

This option also allows you to force an add, remove, move, or memory, processor, or hardware accelerator set operation to be performed for an AIX, Linux, or VIOS partition that does not have an RMC connection to the HMC. This option also allows you to force a migratable SR-IOV logical port recover operation to be performed for an AIX or Linux partition that does not have an RMC connection to the HMC. If this command completes successfully, you will need to restart your operating system for the change to take affect. You should only use this option if you intentionally configured your LAN to isolate the HMC from the operating system of your partition.

This option also allows you to force the additional VLAN IDs for a virtual ethernet adapter to be changed for a VIOS partition that does not have an RMC connection to the HMC.

This option also allows you to force a virtual switch to be set to VEPA mode when the physical switch does not support the IEEE 802.1Qbg standard.

--allownetdisrupt This option must be specified when adding one or more backing devices to a virtual NIC that currently has only one backing device and its MAC address is the same as the virtual NIC’s MAC address. The HMC will remove the existing backing device and recreate it with a different MAC address after adding the specified backing devices. The recreate will cause a short network disruption for the virtual NIC.
-a The configuration data for the command. The configuration data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The configuration data must be enclosed in double quotes.

The format of the configuration data is as follows:

attribute-name=value,attribute-name=value,...

Note that certain attributes accept a comma separated list of values, as follows:

attribute-name=value,value,... ,...

When a list of values is specified, the attribute 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.

If ’+=’ is used in the attribute name/value pair instead of ’=’, then the specified value is added to the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is added to the existing list.

If ’-=’ is used in the attribute name/value pair instead of ’=’, then the specified value is subtracted from the existing value for the attribute if the attribute is numerical. If the attribute is a list, then the specified value(s) is deleted from the existing list.

Valid attribute names for attributes that can be set when adding, removing, or moving a physical I/O slot:
slot_io_pool_id

Valid attribute names for setting I/O pool attributes:
lpar_io_pool_ids
comma separated

Valid attribute names for setting tagged I/O resources (IBM i partitions only):
load_source_slot
DRC index of I/O slot, DRC index of SR-IOV logical
port, or virtual slot number
alt_restart_device_slot
DRC index of I/O slot, DRC index of SR-IOV logical
port, or virtual slot number
console_slot
DRC index of I/O slot, DRC index of SR-IOV logical
port, virtual slot number, or the value hmc
alt_console_slot
DRC index of I/O slot
op_console_slot
DRC index of I/O slot

Valid attribute names for adding a virtual ethernet adapter:
ieee_virtual_eth
Valid values:
0 - not IEEE 802.1Q compatible
1 - IEEE 802.1Q compatible
Required
port_vlan_id
Required
addl_vlan_ids
is_trunk
Valid values:
0 - no
1 - yes
trunk_priority
Valid values are integers between 1
and 15, inclusive
Required for a trunk adapter
vswitch
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the adapter. It is
highly recommended that you use an automatically
generated MAC address.
allowed_os_mac_addrs
1 to 4 comma separated MAC addresses, each specified
as 12 hexadecimal characters. Other valid values:
all - all OS defined MAC addresses are allowed
none - no OS defined MAC addresses are allowed
qos_priority
Valid values are none and integers between 0 and 7,
inclusive
vsi_manager_id
vsi_type_id
vsi_type_version

Valid attribute names for adding a virtual fibre channel adapter:
adapter_type
Valid values are client or server
Required
remote_lpar_id | remote_lpar_name
One of these attributes is required
remote_slot_num
Required
wwpns
Optional for a client adapter, and not valid for
a server adapter. If this attribute is not
specified, WWPNs will be automatically generated for
a client adapter. It is highly recommended that
you do not specify WWPNs so that they will be
automatically generated. If you do specify WWPNs,
you must specify exactly two, and they must be comma
separated.

Valid attribute names for adding a virtual SCSI adapter:
adapter_type
Valid values are client or server
Required
remote_lpar_id | remote_lpar_name
One of these attributes is required for a
client adapter
remote_slot_num
Required for a client adapter

Valid attribute names for adding a virtual serial adapter:
adapter_type
Valid values are client or server
Required
remote_lpar_id | remote_lpar_name
One of these attributes is required for a
client adapter
remote_slot_num
Required for a client adapter
supports_hmc
The only valid value is 0 for no.

Valid attribute names for adding a virtual NIC:
backing_devices
Required
Comma separated list of virtual NIC backing devices,
with each backing device having the following format:

sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[failover-priority][/
[max-capacity]]]

The first 5 ’/’ characters must be present. The
6th ’/’ character is optional, but it must be
present if failover-priority or max-capacity
is specified. The 7th ’/’ character is optional,
but it must be present if max-capacity is
specified.

Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, failover-priority, and
max-capacity.

Specify capacity and max-capacity each as
a percentage with up to 2 decimal places.
max-capacity defaults to 100 if not specified.

Specify failover-priority as a value between 1
and 100 inclusive, with 1 being the highest
priority. It defaults to 50 if not specified.

For example:
sriov/vios1//1/3/5.5//15 specifies a virtual NIC
backing device on VIOS vios1 and physical port 3
of SR-IOV adapter 1 with a capacity of 5.5% and a
maximum capacity of 15%.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames (default value)
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.
Default value is 0.
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated. It is highly recommended
that you use an automatically generated MAC address.
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters. Other valid values are:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
auto_priority_failover
Valid values:
0 - automatic priority failover is disabled
1 - automatic priority failover is enabled
(default value when there is no system-level
setting or when the system-level setting does
not apply to new virtual NICs)

Valid attribute names for changing a virtual ethernet adapter assigned to a running partition:
ieee_virtual_eth
Valid values:
0 - not IEEE 802.1Q compatible
1 - IEEE 802.1Q compatible
addl_vlan_ids
qos_priority
Valid values are none and integers between 0 and 7,
inclusive
vsi_manager_id
To remove a VSI profile, specify none
vsi_type_id
To remove a VSI profile, specify none
vsi_type_version
To remove a VSI profile, specify none

Valid attribute names for changing a virtual NIC assigned to a partition:
backing_devices
Comma separated list of virtual NIC backing devices
to add or remove. You must use the ’+=’ operator or
the ’-=’ operator with this attribute. Each backing
device has the following format:

sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[failover-priority][/
[max-capacity]]]

The first 5 ’/’ characters must be present. The
6th ’/’ character is optional, but it must be
present if failover-priority or max-capacity
is specified. The 7th ’/’ character is optional,
but it must be present if max-capacity is
specified.

Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, failover-priority, and
max-capacity.

Specify capacity and max-capacity each as
a percentage with up to 2 decimal places.
max-capacity defaults to 100 if not specified.

Specify failover-priority as a value between 1
and 100 inclusive, with 1 being the highest
priority. It defaults to 50 if not specified.

For example:
sriov/vios1//1/0/6.25/10 specifies a virtual NIC
backing device on VIOS vios1 and physical port 0
of SR-IOV adapter 1 with a capacity of 6.25% and a
failover priority of 10.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.
allowed_vlan_ids
Comma separated list of VLAN IDs
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters
auto_priority_failover
Valid values:
0 - automatic priority failover is disabled
1 - automatic priority failover is enabled

Valid attribute names for changing the backing device for a virtual NIC assigned to a partition:
failover_priority
Valid values are:
An integer between 1 and 100 inclusive, with 1
being the highest priority.

Valid attribute names for setting virtual ethernet attributes for the managed-system:
mac_prefix

Valid attribute names for setting virtual OptiConnect attributes (IBM i partitions only):
virtual_opti_pool_id
Valid values are:
0 - virtual OptiConnect is disabled
1 - virtual OptiConnect is enabled

Valid attribute names for setting virtual NIC attributes for all existing virtual NICs on the managed-system:
auto_priority_failover
Valid values:
0 - disable automatic priority failover
1 - enable automatic priority failover
2 - no system-level setting (default value)
apply_to_new_vnics
Indicates whether to apply the system-level automatic
priority failover setting to new virtual NICs added
on the managed system unless the user explicitly
specifies a value during the add operation
Valid values are:
0 - no (default value)
1 - yes

Valid attribute names for adding a virtual network:
vlan_id
Required
vswitch
Required
is_tagged
Valid values are:
0 - do not use IEEE 802.1Q VLAN tagging
1 - use IEEE 802.1Q VLAN tagging
Required

Valid attribute names for setting virtual network attributes:
new_name

Valid attribute names for adding a virtual switch:
allowed_lpar_names | allowed_lpar_ids
Comma separated list of partition names or IDs that
are authorized to connect to this virtual switch.
Specify allowed_lpar_ids=all to allow all partitions
to connect (default value).

Valid attribute names for setting virtual switch attributes:
new_name
switch_mode
Valid values are:
VEB - Virtual Ethernet Bridge mode
VEPA - Virtual Ethernet Port Aggregator mode
allowed_lpar_names | allowed_lpar_ids
Comma separated list of partition names or IDs that
are authorized to connect to this virtual switch.
Specify allowed_lpar_ids=all to allow all partitions
to connect.

Valid attribute names for setting memory attributes for the managed-system:
requested_num_sys_huge_pages
mem_mirroring_mode
Valid values are:
none - disable memory mirroring
sys_firmware_only - enable memory mirroring for system
firmware memory only
pend_mem_region_size
Memory region size of the managed-system after it is
restarted. The valid values for the managed-system
are returned by the lshwres -m managed-system -r mem
--level sys -F possible_mem_region_sizes command.

Valid attribute names for setting memory attributes for a partition:
mem_weight
mem_expansion
Valid values are from 1.00 to 10.00
hardware_mem_encryption
Valid values are:
0 - disable hardware-accelerated encryption
1 - enable hardware-accelerated encryption
hardware_mem_expansion
Valid values are:
0 - disable hardware-accelerated Active Memory
Expansion
1 - enable hardware-accelerated Active Memory
Expansion

Valid attribute names for creating the shared memory pool or setting shared memory pool attributes:
pool_mem
megabytes
max_pool_mem
megabytes
paging_vios_names | paging_vios_ids
specify one or two VIOS partitions
mem_dedup
Valid values are:
0 - disable Active Memory Deduplication
1 - enable Active Memory Deduplication
dedup_table_ratio
Ratio of the deduplication table size to the maximum
memory for the pool. Valid values are displayed
by the lshwres -r mem -m managed-system --level sys
-F possible_dedup_table_ratios command.

Valid attribute names for creating the reserved storage device pool or setting reserved storage device pool attributes:
vios_names | vios_ids
specify one or two VIOS partitions

Valid attribute names for adding a persistent memory volume:
size
Required
Must be a multiple of pmem_dram_block_size for the
managed system which is displayed by the lshwres
-m managed-system -r pmem --level sys
-F pmem_dram_block_size command.
affinity
Valid values are:
0 - the volume may be presented as multiple volumes to
the OS, to help with affinity planning (default)
1 - the volume must be presented as a single volume to
the OS, and may be mixed across multiple affinity
domains

Valid attribute names for changing a persistent memory volume:
new_name

Valid attribute names for setting processing attributes for the managed-system:
max_curr_procs_per_lpar
The valid values for the managed-system are returned
by the lshwres -r proc --level sys -m managed-system
-F possible_max_curr_procs_per_lpar command.

Valid attribute names for setting processing attributes for a partition:
sharing_mode
Valid values for partitions using
dedicated processors are:
keep_idle_procs - never share
processors
share_idle_procs - share processors only
when partition is inactive
share_idle_procs_active - share
processors only when partition
is active
share_idle_procs_always - always share
processors

Valid values for partitions using shared
processors are:
cap - capped
uncap - uncapped
uncap_weight
Default value is 128

Valid attribute names for setting shared processor pool attributes:
new_name
max_pool_proc_units
reserved_pool_proc_units

Valid attribute names for setting shared processor pool attributes for a partition:
shared_proc_pool_name | shared_proc_pool_id

Valid attribute names for switching an SR-IOV adapter to shared mode:
slot_id
Required
adapter_id
Valid values are:
1 - 32, inclusive

If the adapter ID is not specified, the next available
adapter ID will be assigned.
adapter_config_option
Specify an option ID returned by the lshwres
-m managed-system -r sriov --rsubtype adapter
-F possible_adapter_config_options command. If
adapter configuration options are supported and this
attribute is not specified, the value returned by the
lshwres -m managed-system -r sriov --rsubtype
adapter -F default_adapter_config_option command
will be used.

Valid attribute names for switching an SR-IOV adapter to dedicated mode:
slot_id
Required

Valid attribute names for moving the configuration of an SR-IOV adapter:
slot_id
Required
DRC index of the I/O slot of the failed SR-IOV adapter
target_slot_id
Required
DRC index of the I/O slot of the new SR-IOV adapter

Valid attribute names for changing an SR-IOV physical port:

Warning! When an attribute for an SR-IOV physical port
is changed, a short network interruption may occur for
all partitions that share the physical port.

adapter_id
Required
phys_port_id
Required
conn_speed
Possible valid values are:
auto
10 - 10 Mbps
100 - 100 Mbps
1000 - 1 Gbps
10000 - 10 Gbps
40000 - 40 Gpbs
100000 - 100 Gbps
max_eth_logical_ports
An integer value less than or equal to the maximum
number of Ethernet logical ports allowed on any
physical port on the adapter. For physical ports that
support option IDs for configuring the maximum number
of logical ports supported for the physical port, this
attribute is mutually exclusive with the
max_logical_ports_option attribute, and if this
attribute is specified, the value specified must match
one of the values associated with one of the supported
option IDs. For a RoCE physical port, setting this
attribute also sets the max_roce_logical_ports
attribute to the maximum number of RoCE logical ports
that correlates with the maximum number of Ethernet
logical ports specified.
max_logical_ports_option
The option ID associated with the maximum number of
Ethernet logical ports and RoCE logical ports to allow
on the physical port. For Ethernet physical ports,
supported option IDs are displayed by the lshwres
-r sriov -m managed-system --rsubtype physport
--level ethc -F possible_max_logical_ports_options
command. For RoCE physical ports, supported option
IDs are displayed by the lshwres -r sriov
-m managed-system --rsubtype physport --level roce
-F possible_max_logical_ports_options command. For
physical ports that support option IDs for configuring
the maximum number of logical ports supported for the
physical port, this attribute is mutually exclusive
with the max_eth_logical_ports attribute.
max_recv_packet_size
Valid values are:
1500 - 1500 bytes
9000 - 9000 bytes (Jumbo frames)
phys_port_label
1-16 characters
Specify none to clear the physical port label
phys_port_sub_label
1-8 charaters
Specify none to clear the physical port sublabel
recv_flow_control
Valid values are:
0 - disable
1 - enable
trans_flow_control
Valid values are:
0 - disable
1 - enable
veb_mode
Valid values are:
0 - disable Virtual Ethernet Bridge mode
1 - enable Virtual Ethernet Bridge mode
vepa_mode
Valid values are:
0 - disable Virtual Ethernet Port Aggregator mode
1 - enable Virtual Ethernet Port Aggregator mode

Valid attribute names for adding an SR-IOV logical port or recovering a migratable SR-IOV logical port:
adapter_id
Required
phys_port_id
Required
logical_port_type
Required
Valid values are:
eth - ethernet logical port
roce - RDMA over Converged Ethernet (RoCE) logical
port
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters. Other valid values are:
all - all OS defined MAC addresses are allowed
(default value)
none - no OS defined MAC addresses are allowed
allowed_priorities
Comma separated list of integers between 0 and 7,
inclusive, or one of the following values:
all - all supported priorities are allowed
none - no priorities are allowed (default value)
allowed_vlan_ids
Comma separated list of VLAN IDs, or one of the
following values:
all - all VLAN IDs are allowed (default value)
none - no VLAN IDs are allowed
capacity
A percentage with up to 2 decimal places. For an
ethernet logical port this must be a multiple of
min_eth_capacity_granularity of the physical port,
which is displayed by the lshwres -m managed-system
-r sriov --rsubtype physport --level {eth | ethc}
-F min_eth_capacity_granularity command.
The minimum value and the default value is
min_eth_capacity_granularity. The maximum value is
100. For a RoCE logical port this must be a
multiple of min_roce_capacity_granularity of the
physical port, which is displayed by the lshwres
-m managed-system -r sriov --rsubtype physport --level
roce -F min_roce_capacity_granularity command.
The minimum value and the default value is
min_roce_capacity_granularity. The maximum value
is 100.
max_capacity
A percentage with up to 2 decimal places. The
minimum value is capacity. The maximum value
and the default value is 100.
config_id
If not specified, the management console will assign
the next available value.
diag_mode
Valid values are:
0 - disable (default value)
1 - enable

Warning! If diagnostics mode is enabled, no other
logical port may be attached to the physical port.
If logical ports are already in use on the physical
port, you will have to power off partitions or use
Dynamic Logical Partitioning (DLPAR) to remove the
logical ports that are attached to the physical port.
huge_dma_window_mode
Valid values are:
0 - disable (default value)
1 - enable
logical_port_id
DRC index of an SR-IOV logical port. If not
specified, an SR-IOV logical port will be
automatically assigned.
mac_addr
12 hexadecimal characters
If not specified, a unique MAC address will be
automatically generated for the logical port. It
is highly recommended that you use an automatically
generated MAC address.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames (default value)
promisc_mode
Valid values are:
0 - disable (default value)
1 - enable
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.
Default value is 0.
migratable
Not allowed for recover operations
Valid values:
0 - this logical port cannot be migrated
(default value)
1 - this logical port can be migrated
backup_device_type
Not allowed for recover operations
Backup device type for a migratable logical port
Valid values:
vnic - virtual NIC (default)
veth - virtual ethernet
backup_device_slot_num
Required for recover operations
Defaults to the next available virtual slot number
for add operations
backup_vnic_backing_device
Not allowed for recover operations
Specify the following format:

sriov/vios-lpar-name/vios-lpar-ID/
sriov-adapter-ID/sriov-physical-port-ID/
[capacity][/[/[max-capacity]]]

The first 5 ’/’ characters must be present. The
6th and 7th ’/’ characters are optional, but they
must be present if max-capacity is specified.

Optional values may be omitted. Optional values
are capacity, either vios-lpar-name or
vios-lpar-ID, and max-capacity.

Specify capacity and max-capacity each as
a percentage with up to 2 decimal places.
max-capacity defaults to 100 if not specified.

When the backup device type is virtual NIC, the
management console assigns a backing device if this
attribute is not specified. Note that the
management console can only assign a backing device
on an SR-IOV physical port that has the same port
label as the physical port for this logical port.
backup_veth_vnetwork
Not allowed for recover operations
Required for add operations when the backup device
type is virtual ethernet
Valid attribute names for changing an SR-IOV logical port:
adapter_id
Required
logical_port_id
Required
allowed_os_mac_addrs
Comma separated list of MAC addresses, each specified
as 12 hexadecimal characters
allowed_priorities
Comma separated list of integers between 0 and 7,
inclusive
allowed_vlan_ids
Comma separated list of VLAN IDs
diag_mode
Valid values are:
0 - disable (default value)
1 - enable

Warning! If diagnostics mode is enabled, no other
logical port may be attached to the physical port.
If logical ports are already in use on the physical
port, you will have to power off partitions or use
Dynamic Logical Partitioning (DLPAR) to remove the
logical ports that are attached to the physical port.
port_vlan_id
Port VLAN ID or 0 to disable VLAN tag insertions
for untagged frames
pvid_priority
Valid values are:
An integer between 0 and 7, inclusive.

Valid attribute names for removing an SR-IOV logical port:
adapter_id
Required
logical_port_id
Required

Valid attribute names for enabling or disabling an SR-IOV logical port:
adapter_id
Required
logical_port_id
Required

Valid attribute names for resetting statistics for an SR-IOV physical port:
adapter_id
Required
phys_port_id
Required

Valid attribute names for resetting statistics for an SR-IOV logical port:
adapter_id
Required
logical_port_id
Required

-v Specify this option to enable verbose mode. When verbose mode is enabled, warning messages and informational messages are displayed for successful virtual NIC operations. Warning messages and informational messages are displayed for virtual NIC operations that fail, regardless of whether this option is specified.
--help Display the help text for this command and exit.

EXAMPLES
In the following examples nested double quote characters are preceded by an escape character (’#146;). The escape characters are required to run the commands locally on an HMC.

Add the I/O slot with DRC index 21010001 to partition p1 and set the I/O pool ID for the slot to 3:

chhwres -r io -m sys1 -o a -p p1 -l 21010001
-a "slot_io_pool_id=3"

Add I/O pools 2 and 3 to the I/O pools in which partition p1 is participating:

chhwres -r io --rsubtype iopool -m 9406-520*1234321A -o s
-p p1 -a "\"lpar_io_pool_ids+=2,3\""

Clear the physical I/O slot with DRC index 21010207 after the physical I/O adapter in that slot was concurrently removed but not replaced:

chhwres -r io -m sys1 -o c -l 21010207

Add a virtual ethernet adapter to the partition with ID 3:

chhwres -r virtualio -m 9406-520*1234321A -o a --id 3
--rsubtype eth -a "ieee_virtual_eth=1,
port_vlan_id=4,\"addl_vlan_ids=5,6\",is_trunk=1,
trunk_priority=1"

Add a virtual fibre channel client adapter to the partition p1:

chhwres -r virtualio -m sys1 -o a -p p1 --rsubtype fc
-a "adapter_type=client,remote_lpar_name=vios,remote_slot_num=16"

Add a virtual NIC to the partition p1:

chhwres -r virtualio -m sys1 -o a -p p1 --rsubtype vnic -v
-a "port_vlan_id=3,backing_devices=sriov/vios1//1/2/"

Remove the virtual adapter in slot 3 from partition p1:

chhwres -r virtualio -m sys1 -o r -p p1 -s 3

Add an additional VLAN ID to the virtual ethernet adapter in slot 4 of the partition AIX:

chhwres -r virtualio -m sys1 -o s --rsubtype eth -p AIX -s 4
-a "addl_vlan_ids+=5"

Add additional VLAN IDs to the virtual NIC in slot 6 of the partition lp4 and change its port VLAN ID priority:

chhwres -r virtualio -m sys1 -o s --rsubtype vnic -p lp4 -s 6
-a "\"allowed_vlan_ids+=10,20,30\",pvid_priority=5"

Add additional backing devices to the virtual NIC in slot 3 of the partition with ID 4:

chhwres -r virtualio -m sys1 -o s --rsubtype vnic --id 4 -s 3
-a "\"backing_devices+=sriov/vios1//1/0/4/50,sriov/vios2//2/0/4/62\""
--allownetdisrupt

Remove a backing device from the virtual NIC in slot 3 of the partition lp4:

chhwres -r virtualio -m sys1 -o s --rsubtype vnic -p lp4 -s 3
-a "backing_devices-=sriov///1/0//"

Disable automatic priority failover for all existing virtual NICs on the managed system, but do not apply this setting to new virtual NICs:

chhwres -r virtualio -m sys1 -o s --rsubtype vnic
-a "auto_priority_failover=0,apply_to_new_vnics=0"

Change the failover priority of the backing device, with logical port ID 27004001, for the virtual NIC in slot 3 of the partition lp4:

chhwres -m sys1 -r virtualio -o s --rsubtype vnicbkdev -p lp4 -s 3
--logport 27004001 -a "failover_priority=75"

Make the backing device, with logical port ID 27004001, for the virtual NIC in slot 3 of the partition lp4 active:

chhwres -m sys1 -r virtualio -o act --rsubtype vnicbkdev -p lp4 -s 3
--logport 27004001

Switch over all virtual NIC backing devices on VIOS partition vios1 to other VIOS partitions:

chhwres -m sys1 -r virtualio -o so --rsubtype vnicbkdev -p vios1

Disable the virtual ethernet adapter in slot 2 of the partition p5:

chhwres -r virtualio -m sys1 -o d --rsubtype eth -p p5 -s 2

Enable virtual OptiConnect for the IBM i partition i_p1:

chhwres -r virtualio -m sys1 -o s -p i_p1
--rsubtype virtualopti -a "virtual_opti_pool_id=1"

Add the virtual network vnet5:

chhwres -r virtualio --rsubtype vnetwork -m sys1 -o a --vnetwork vnet5
-a "vswitch=ETHERNET0,vlan_id=5,is_tagged=1"

Add the virtual switch vs1:

chhwres -r virtualio --rsubtype vswitch -m sys1 -o a --vswitch vs1

Add 128 MB of memory to the partition with ID 1, and time out after 10 minutes:

chhwres -r mem -m sys1 -o a --id 1 -q 128 -w 10

Remove 512 MB of memory from the AIX partition aix_p1 and return a detail level of 5:

chhwres -r mem -m 9406-520*1234321A -o r -p aix_p1 -q 512 -d 5

Set the total amount of memory for the partition p1 to 8192 MB:

chhwres -r mem -m sys1 -o s -p p1 -q 8192

Remove 128 MB of logical memory and 100 MB of I/O entitled memory from the partition smp1:

chhwres -r mem -m sys1 -o r -p smp1 -q 128 --entitled 100

Set the partition smp1 to automatic I/O entitled memory management mode:

chhwres -r mem -m sys1 -o a -p smp1 --entitled auto

Reset I/O entitled memory statistics for partition smp1:

chhwres -r mem -m sys1 -o rs -p smp1

Create the shared memory pool with redundant VIOS partitions (on a managed system that supports partition suspend and resume operations, this command also creates the reserved storage device pool if it does not already exist):

chhwres -r mempool -m sys1 -o a -a "pool_mem=4096,max_pool_mem=
8192,\"paging_vios_names=vios_p1,vios_p2\""

Increase the size of the shared memory pool by 256 MB:

chhwres -r mempool -m sys1 -o s -a "pool_mem+=256"

Add the device hdisk1 on VIOS partition vios_p1 to the shared memory pool (on a managed system that supports partition suspend and resume operations, this command adds the device to the reserved storage device pool):

chhwres -r mempool -m sys1 --rsubtype pgdev -o a -p vios_p1
--device hdisk1

Create the reserved storage device pool with a single VIOS partition:

chhwres -r rspool -m sys1 -o a -a "vios_names=vios_p2"

Add the VIOS partition with ID 1 to the reserved storage device pool:

chhwres -r rspool -m sys1 -o s -a "vios_ids+=1"

Remove the device hdisk1 on VIOS partition vios_p1 from the reserved storage device pool:

chhwres -r rspool -m sys1 --rsubtype rsdev -o r -p vios_p1
--device hdisk1

Switch over the running shared memory partition smp1 to its redundant paging VIOS partition:

chhwres -r mem -m sys1 -p smp1 -o so

Set the number of pages of huge page memory requested for the managed system to 2 (the managed system must be powered off):

chhwres -r mem -m sys1 -o s -a "requested_num_sys_huge_pages=2"

Create and add a persistent memory DRAM volume to a partition:

chhwres -r pmem -m mySys -o a --rsubtype volume --volume p1Vol
--device dram -p p1 -a "size=512,affinity=1"

Remove a persistent memory DRAM volume from a partition and delete it:

chhwres -r pmem -m mySys -o r --rsubtype volume --volume p1Vol --id 3

Move 1 processor from partition p1 to partition p2 (both partitions are using dedicated processors):

chhwres -r proc -m 9406-520*1234321A -o m -p p1 -t p2 --procs 1

Move .5 processing units from the partition with ID 1 to the partition with ID 2 (both partitions are using shared processors):

chhwres -r proc -m sys1 -o m --id 1 --tid 2 --procunits .5

Add .25 processing units to the IBM i partition i_p1:

chhwres -r proc -m sys1 -o a -p i_p1 --procunits .25

Set the number of processors for partition p1 to 2:

chhwres -r proc -m sys1 -o s -p p1 --procs 2

Configure the shared processor pool with ID 1:

chhwres -r procpool -m sys1 -o s --poolid 1 -a "new_name=
pool1,max_pool_proc_units=2,reserved_pool_proc_units=.5"

Move the partition sharedlpar1 to shared processor pool pool1:

chhwres -r procpool -m sys1 -o s -p sharedlpar1
-a "shared_proc_pool_name=pool1"

Switch an SR-IOV adapter to shared mode:

chhwres -r sriov -m sys1 --rsubtype adapter -o a -a "slot_id=21010202,
adapter_config_option=0"

Switch an SR-IOV adapter to dedicated mode:

chhwres -r sriov -m sys1 --rsubtype adapter -o r -a "slot_id=21010202"

Set the connection speed for SR-IOV physical port 0 to 100 Gbps:

chhwres -r sriov -m sys1 --rsubtype physport -o s
-a "adapter_id=1,phys_port_id=0,conn_speed=100000"

Add an SR-IOV ethernet logical port (using defaults) to partition lpar1:

chhwres -r sriov -m sys1 --rsubtype logport -o a -p lpar1
-a "adapter_id=1,phys_port_id=1,logical_port_type=eth"

Remove an SR-IOV ethernet logical port from partition lpar1:

chhwres -r sriov -m sys1 --rsubtype logport -o r -p lpar1
-a "adapter_id=1,logical_port_id=27004001"

Change the port VLAN ID for an SR-IOV ethernet logical port in partition lpar1:

chhwres -r sriov -m sys1 --rsubtype logport -o s -p lpar1
-a "adapter_id=1,logical_port_id=27004001,port_vlan_id=2"

Disable an SR-IOV logical port:

chhwres -r sriov -m sys1 --rsubtype logport -o d --id 23
-a "adapter_id=1,logical_port_id=2700402d"

Reset the statistics for an SR-IOV physical port:

chhwres -r sriov -m sys1 --rsubtype physport -o rs
-a "adapter_id=1,phys_port_id=0"

Recover the migratable SR-IOV logical port for the backup device in slot 3 after a partition migration operation:

chhwres -r sriov -m sys1 --rsubtype logport -o rc -p aix1
-a "adapter_id=1,phys_port_id=1,logical_port_type=eth,capacity=10,
max_capacity=20,backup_device_slot_num=3"

Set the GZIP QoS value to 100 for partition aixLpar:

chhwres -r accel -m system1 --rsubtype gzip -o s -p aixLpar -q 100

ENVIRONMENT
None

BUGS
None

AUTHOR
IBM Austin

SEE ALSO
lshwres, rsthwres, chsyscfg, lssyscfg

Linux CHHWRES (1) June 2024
Generated by manServer 1.07 from chhwres.1 using man macros.