HP Instant Capacity User's Guide for Version 9.x

works exactly as the -a option (if n is greater than the
current number of active cores), or exactly as the -d option
(if n is less than the current number of active cores).
Specifying a value of n less than the number of cells in a
partition will fail. In a virtual partition environment, if
unused capacity is not available, this option will use the
value of n as the desired number of cores to be active in
the local virtual partition. If unused capacity is available,
icapmodify will first activate cores from unused capacity
before increasing the active cores. For further details of
using this option in an virtual partition environment, see
the Virtual Partition and Unused Capacity sections of
Chapter 4 of the HP Instant Capacity User's Guide for Version
9.x located at /usr/share/doc/icapUserGuide.pdf.
The icapmodify command fails if it is unable to set the
value exactly as requested. However, a failed request can
still make a partial change to the number of intended active
cores.
-t
Authorize use of temporary capacity. This option,
combined with either the -a or the -s option, specifies
that a core activation is allowed to consume temporary
capacity. Temporary capacity is consumed when the
number of active cores exceeds the number of core usage
rights. It is no longer used when the number of active cores
is decreased to no more than the number of core usage
rights available to the complex. Use icapmodify -d or
-s to reduce or stop the use of temporary capacity. It is
not necessary to use the -t option when using the -d
option. If a previous activation via icapmodify resulted
in temporary capacity being consumed in a virtual partition
environment, deactivating a core with a vparmodify
command temporarily reduces the consumption of
temporary capacity. A subsequent core activation using
vparmodify increases consumption of temporary capacity
if the activation results in more active cores than core usage
rights.
desc
Optional description to help customers identify this
configuration change. This description becomes part of the
Instant Capacity logfile (var/adm/icap.log) entry
documenting the activation or deactivation. This
description is also contained in the configuration change
notification email.
user_name
Optional string identifying the person performing the core
activation or deactivation. This can be any ASCII string,
and becomes part of the Instant Capacity logfile (/var/
adm/icap.log) entry documenting the activation or
deactivation. The string specified here is also contained in
the configuration change notification email.
UPGRADES
The icapmodify command fails if the system is in a state where a software upgrade is incomplete
(the software on the system has been upgraded from a version earlier than B.06.00, but an upgrade
codeword issued by the HP Utility Pricing Solutions portal was not applied to the complex). The
169