HMC Manual Reference Pages  - CHCOD (1)

NAME

chcod - change Capacity on Demand

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

To enter a CoD code:
chcod -o e -m managed-system -k CoD-code

To activate or change the amount of Elastic CoD resources:
chcod -o a -m managed-system -c onoff -r {mem | proc}
-q quantity-of-resources -d number-of-days

To activate or change the number of Utility CoD processors:
chcod -o a -m managed-system -c utility -r proc
-q quantity-of-processors

To deactivate all Elastic CoD or all Trial CoD resources:
chcod -o d -m managed-system -c {onoff | trial}
-r {mem | proc}

To deactivate all Utility CoD processors:
chcod -o d -m managed-system -c utility -r proc

To set or disable a Utility CoD processor minute usage limit:
chcod -o s -m managed-system -c utility -r proc
-l number-of-processor-minutes

DESCRIPTION

chcod performs Capacity on Demand (CoD) operations on the managed-system.

chcod is used to enter a CoD code for the managed-system. It is also used to activate Elastic CoD or Utility CoD resources, or to deactivate Elastic CoD, Trial CoD, or Utility CoD resources. CoD resources are either memory or processors.

chcod is also used to set or disable a Utility CoD processor minute usage limit.

OPTIONS

-o The CoD operation to perform. Valid values are e to enter a CoD code, a to activate or change the number of Elastic CoD or Utility CoD resources, d to deactivate all Elastic CoD, all Trial CoD, or all Utility CoD resources, and s to set or disable a Utility CoD processor minute usage limit.

To change the number of Elastic CoD resources or days that are currently activated, specify an activate operation with this option, specify the total number of activated Elastic CoD resources that you want with the -q option, and specify the number of days that you want them for with the -d option. An activate operation is to be used regardless of whether the total number of activated Elastic CoD resources is being increased, decreased, or kept the same. A deactivate operation is to be used only when you no longer want to have any activated Elastic CoD resources.

To change the number of Utility CoD processors that are currently activated, specify an activate operation with this option, and specify the total number of activated Utility CoD processors that you want with the -q option. An activate operation is to be used regardless of whether the total number of activated Utility CoD processors is being increased or decreased. A deactivate operation is to be used only when you no longer want to have any activated Utility CoD processors in the shared processor pool.

Note that CUoD, and Trial CoD resources are activated by entering a CoD code.

-m The name of the managed system for which the CoD operation is to be performed. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.
-k The CoD code (key) to enter. Letters may be entered in either upper case or lower case.
-c The CoD type. Valid values are onoff for Elastic CoD, trial for Trial CoD, and utility for Utility CoD.
-r The CoD resource type. Valid values are mem for memory and proc for processors.
-q The quantity of Elastic CoD or Utility CoD resources requested. The value specified must be a whole number which is greater than 0.

When requesting Elastic CoD memory, the value specified must be in megabytes, and it must be a multiple of 1024 megabytes.

-d The number of days for which the Elastic CoD resources are requested.
-l The number of processor minutes to set as the Utility CoD processor minute usage limit.

To disable the Utility CoD processor minute usage limit, specify a 0 with this option.

--help Display the help text for this command and exit.

EXAMPLES

Enter a CoD code:

chcod -m sys1 -o e -k AlphaNumericString12345

Activate 2 GB of Elastic CoD memory for 10 days:

chcod -m 9406-570*1001CA -o a -c onoff -r mem -q 2048
-d 10

Increase to 5 GB of Elastic CoD memory for 3 days:

chcod -m 9406-570*1001CA -o a -c onoff -r mem -q 5120
-d 3

Activate 4 Elastic CoD processors for 5 days:

chcod -m sys1 -o a -c onoff -r proc -q 4 -d 5

Decrease to 1 Elastic CoD processor for 5 days:

chcod -m sys1 -o a -c onoff -r proc -q 1 -d 5

Activate 1 Utility CoD processor:

chcod -m 9117-MMA*10BACEC -o a -c utility -r proc -q 1

Activate 2 more Utility CoD processors for a total of 3 Utility CoD processors:

chcod -m 9117-MMA*10BACEC -o a -c utility -r proc -q 3

Decrease the number of activated Utility CoD processors to 2:

chcod -m 9117-MMA*10BACEC -o a -c utility -r proc -q 2

Deactivate all Elastic CoD processors:

chcod -m sys1 -o d -c onoff -r proc

Deactivate all Utility CoD processors:

chcod -m sys1 -o d -c utility -r proc

Deactivate all Trial CoD memory and stop the trial:

chcod -m 9406-570*1001CA -o d -c trial -r mem

Set a Utility CoD processor minute usage limit of 100 processor minutes:

chcod -m sys1 -o s -c utility -r proc -l 100

Disable the Utility CoD processor minute usage limit:

chcod -m sys1 -o s -c utility -r proc -l 0

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

SEE ALSO

lscod


Linux CHCOD (1) November 2012
Generated by manServer 1.07 from chcod.1 using man macros.