DEACTIVATE DEFINEDCAPACITY

Use the DEACTIVATE DEFINEDCAPACITY command to manually decrease the Defined Capacity for an LPAR. You can identify the LPAR either by the name of the LPAR and the name of the CPC on which the LPAR is active, or by the name of the z/OS system and sysplex running in the LPAR. In the second case, the z/OS system needs to be defined in the active domain configuration. In every case the respective CPC has to be defined in the active domain configuration.

Note:
The number that is supplied as the MSU parameter is the total limit to which the Defined Capacity should be decreased, not the number of MSU by which you want to decrease the limit.

Before performing the activation, the Provisioning Manager checks for the following conditions:

Syntax

Read syntax diagramSkip visual syntax diagram>>-+-DEACTIVATE--DEFINEDCAPACITY-+--+-PLEX=name SYS=name-+--MSU=limit-><
   '-I--DC-----------------------'  '-CPC=name LPAR=name-'
 

Parameters

The command has the following parameter:

PLEX=name
The name of the sysplex to which the specified system belongs.
SYS=name
The name of the system for which LPAR you want to decrease the Defined Capacity. The specified system must be currently observed.
CPC=name
The name of the CPC on which to find the specified LPAR.
LPAR=name
The name of an LPAR for which you want to decrease the Defined Capacity.
MSU=limit
The new Defined Capacity for the specified LPAR. The limit is specified in MSU. The new value must be lower than the current Defined Capacity and Defined Capacity must be turned on for the LPAR at the HMC. A value between 1 and 100000 MSU can be specified.

Example

To decrease the Defined Capacity for system SYS1 in sysplex PLEX2 to 500 MSU, issue the following command:

MODIFY CPOSERV,APPL=DEACTIVATE DEFINEDCAPACITY SYS=SYS1 PLEX=PLEX2 MSU=500

or:

F CPOSERV,APPL=I DC SYS=SYS1 PLEX=PLEX2 MSU=500

The response on the console is:

CPO1311I Defined capacity for system SYS1 in sysplex PLEX2 decreased to 500 MSU