DEACTIVATE GROUPCAPACITY

Use the DEACTIVATE GROUPCAPACITY command to manually decrease the Group Capacity for a capacity group. You can identify the group by the name of the group and the name of the CPC on which the group is defined, or by the name of the z/OS system and sysplex running in an LPAR that belongs to the group. 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 MSU parameter is the total limit to which the Group Capacity should be decreased, not the number of MSU by which you want to decrease the limit.

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

Syntax

Read syntax diagramSkip visual syntax diagram>>-+-DEACTIVATE--GROUPCAPACITY-+--+-PLEX=name SYS=name--+--MSU=limit-><
   '-I--GC---------------------'  '-CPC=name GROUP=name-'
 

Parameters

The command has the following parameter:

PLEX=name
The name of the sysplexto which the specified system belongs.
SYS=name
The name of the system running in an LPAR belonging to the group for which you want to decrease the Group Capacity.
CPC=name
The name of the CPC on which to find the specified capacity group.
GROUP=name
The name of a capacity group for which you want to decrease the Group Capacity. An LPAR must belong to the specified group.
MSU=limit
The new value for the Group Capacity for the specified capacity group. The limit is specified in MSU. The new value must be lower than the current Group Capacity on the group and Group Capacity must be turned on for the group at the HMC. A value between 1 and 100000 MSU can be specified.

Example

To decrease the Group Capacity for group GROUP1 on CPC CPC1 to 500 MSU, issue the following command:

MODIFY CPOSERV,APPL=DEACTIVATE GROUPCAPACITY GROUP=GROUP1 CPC=CPC1 MSU=500

or:

F CPOSERV,APPL=I GC GROUP=GROUP1 CPC=CPC1 MSU=500

The response on the console is:

CPO1312I Group capacity for group GROUP1 on CPC CPC1 decreased to 500 MSU