Temporary Instant Capacity Exceptions

Error for Unlicensed Activation with Insufficient Temporary Capacity

You cannot activate an Instant Capacity processor with temporary capacity unless there is a sufficient balance of temporary capacity on the system. To increase the temporary capacity balance, see “Acquiring and Configuring Temporary Instant Capacity” for details.

Here is an example of the error message for attempting to activate an unlicensed processor without a sufficient temporary capacity balance:

Example 5-5 Error Message for Unlicensed Activation with Insufficient Temporary Capacity

/usr/sbin/icod_modify -t -a 1 

ERROR:   Operation not approved because there is not enough temporary capacity
         on this system to satisfy the request. Activations require at least 
         30 minutes worth of temporary capacity per CPU consuming temporary 
         capacity.

Temporary Capacity Balance Needing Action

If the temporary capacity balance reaches 30 minutes or less, the icod_stat command’s output displays “less than 30 minutes” in the Exception status field (at the beginning of the icod_stat output). When this state occurs, you need to take corrective action immediately and do one of the following:

Deactivate Instant Capacity processors that are utilizing temporary capacity
Apply additional temporary capacity codewords
Permanently license additional processors

Temporary Capacity Negative Balance

A complex is out of compliance with the Instant Capacity contract if a negative balance of temporary capacity occurs.

The Instant Capacity software sends an exception report (via e-mail) if there is a negative balance of temporary capacity. Exception information is also written to the syslog file. See “Handling Compliance Exceptions” for details of the exception report for a negative temporary capacity balance.

If you continue to have more active processors than licensed processors across the complex, a negative capacity balance will result in a license enforcement action, as described in “Temporary Instant Capacity Expiration and License Enforcement”. If there is a negative temporary capacity balance but the number of licensed processors is greater than or equal to the number of active processors, then the complex remains in an exception state, but without (additional) license enforcement action.

Purchasing an additional right-to-use (RTU) processor license for the system clears out any previous violation of Temporary Instant Capacity. Purchase of sufficient additional temporary capacity will also clear out a negative balance.

Temporary Capacity Enforcement

When the temporary capacity balance has been depleted and you continue to have more active processors than licensed processors across the complex, a license enforcement action occurs on a partition reboot to bring the system into a state closer to licensing compliance (by deactivating one or more processors). Example 5-6 “Error Message for Temporary Capacity Partial Enforcement” is an example of the message that is sent when the license enforcement results in a partially compliant state, but temporary capacity continues to be depleted. Example 5-7 “Error Message for Temporary Capacity Complete Enforcement” is an example of the message that is sent when the enforcement is able to deactivate enough processors so that temporary capacity is no longer being used.

Example 5-6 Error Message for Temporary Capacity Partial Enforcement

To: root@par1.yourorg.com 
Subject: iCOD license enforcement notice

This message is being sent to inform you that, due to expiration of temporary
capacity, 1 additional CPUs were deactivated on your iCOD system
(containing the partition par1) to bring the system into compliance with iCOD
licensing.

Prior to deactivation, the number of processor licenses distributed among the 
partitions exceeded the number of available licenses by 3. 
Also, 3 unlicensed CPUs were found to be active in the complex. This state 
was likely the result of having activated iCOD processors using temporary 
capacity (TiCOD) and then allowing the TiCOD balance to expire prior to 
deactivation of the processors.

As a result, 1 licenses were revoked and 1 processors were deactivated in 
conjunction with the revocation of the licenses.

There are currently 3 active CPUs and 1 CPU licenses. This complex is 
not compliant with iCOD licensing. Other partitions may also experience 
processor deactivation upon reboot until compliance is restored. To bring 
the system back into compliance now, perform one or more of the following 
steps: 
1. Purchase and apply additional temporary capacity. 
2. Deactivate processors until no processors are consuming temporary 
capacity. 
3. Purchase the number of processors consuming temporary capacity and 
apply the Right-to-Use licenses to the system so that they can be 
permanently activated.

To activate these 1 processors again, you can perform one of the 
following actions: 
1. Purchase a new TiCOD license, apply it to the system, and use TiCOD to 
activate the processors. 
2. Deactivate processors in other partitions after the system is in 
compliance. This frees up the licenses associated with the processors 
and allows them to be activated here.

You can view the current temporary capacity compliance of your system by using 
the icod_stat command. 
See the iCOD User's Guide at /usr/share/doc/icodUserGuide.pdf for more 
information.

Example 5-7 Error Message for Temporary Capacity Complete Enforcement

To: root@par1.yourorg.com 
Subject: iCOD license enforcement notice

This message is being sent to inform you that, due to expiration of temporary 
capacity, 1 CPUs were deactivated on your iCOD system (containing the 
partition par1) to bring the system into compliance with iCOD licensing.

Prior to deactivation, the number of processor licenses distributed among the 
partitions exceeded the number of available licenses by 1. 
Also, 1 unlicensed CPUs were found to be active in the complex. This state 
was likely the result of having activated iCOD processors using temporary 
capacity (TiCOD) and then allowing the TiCOD balance to expire prior to 
deactivation of the processors.

As a result, 1 licenses were revoked and 1 processors were deactivated in 
conjunction with the revocation of the licenses. To activate these 1 
processors again, you can perform one of the following actions: 
1. Purchase a new TiCOD license, apply it to the system, and use TiCOD to 
activate the processors. 
2. Deactivate processors in other partitions. This frees up the licenses 
associated with the processors and allows them to be activated here.

There are currently 3 active CPUs and 3 CPU licenses. This complex is 
now compliant with iCOD licensing.

You can view the current temporary capacity compliance of your system by using 
the icod_stat command.

See the iCOD User's Guide at /usr/share/doc/icodUserGuide.pdf for more 
information.

Temporary Instant Capacity Exceptions

Technical documentation

» Table of Contents

» Index

Error for Unlicensed Activation with Insufficient Temporary Capacity

Temporary Capacity Balance Needing Action

Temporary Capacity Negative Balance

Temporary Capacity Enforcement