HP Instant Capacity Version 10.x User Guide (762794-001, March 2014)

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. TiCAP
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.
170