Available: from 1.9.1.0

With the command “lpar chaccel” an LPAR can be assigned a Quantity of Service (QoS) value for the NX Hardware Accelerator.

   lpar [-h <hmc>] [-m <ms>] chaccel [-f] [-l <detail_level>] [-w <wait_time>] [-v] <lpar> <quantity>

To prevent oversubscription of the hardware accelerator resources, credits can be assigned to the LPARs of a managed system. The number of available credits can be displayed using the “ms lsaccel” command.

For example, to assign 10 credits to the LPAR aix02, the command “lpar chaccel” can be used as follows:

$ lpar chaccel aix02 10
$

If a managed system does not support a hardware accelerator, you will receive the following error message:

$ lpar chaccel aix14 10
hmc01: chhwres -m ms13 -r accel --rsubtype gzip  -o s -q 10 -p aix14
ERROR: remote HMC command returned an error (1)
StdErr: HSCLC014 Managed system ms13 does not support hardware accelerators.
$

Note: The NX Hardware Accelerator is only available from POWER 9 on.

If a hardware accelerator is not supported by the operating system of an LPAR, you will receive the following error message:

$ lpar chaccel aix09 10
hmc01: chhwres -m ms25 -r accel --rsubtype gzip  -o s -q 10 -p aix09
ERROR: remote HMC command returned an error (1)
StdErr: HSCLC102 The OS level of the partition does not support dynamically setting GZIP Quality of Service (QoS) credits.
$

Note: The NX Hardware Accelerator is only supported starting with AIX 7.2 TL4 or AIX 7.3.

If there are not enough credits available, you will also receive an error message:

$ lpar chaccel aix05 50
hmc01: chhwres -m ms25 -r accel --rsubtype gzip  -o s -q 50 -p aix05
ERROR: remote HMC command returned an error (1)
StdErr: HSCLC016 There is an insufficient amount of available GZIP Quality of Service (QoS) credits for the partition: available system QoS: 12, assigned partition QoS: 22, additional requested partition QoS: 28.
$

How many credits are assigned to which LPAR can be displayed with the command “lpar lsaccel”.