HP Instant Capacity Version 10.x User Guide (5900-1581, March 2011)

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 10.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
only option that can be used when the complex is in this state is the -C option, which accepts the
upgrade codeword.
143