chcod - change Capacity on Demand

To enter a CoD code:

chcod -o e -m managed-system -k CoD-code

To activate or change On/Off 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 Reserve CoD processors:

chcod -o a -m managed-system -c reserve -r proc-q quantity-of-processors

To deactivate all On/Off CoD, all Reserve CoD, or all Trial CoD resources:

chcod -o d -m managed-system-c {onoff | reserve | trial} -r{mem | proc}

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 On/Off CoD and Reserve CoD resources, or to deactivate On/Off CoD, Reserve CoD, or Trial CoD resources. CoD resources are either memory or processors.

-o

The CoD operation to perform. Valid values are e to enter a CoD code, a to activate or change On/Off CoD or Reserve CoD resources, and d to deactivate all On/Off CoD, all Reserve CoD, or all Trial CoD resources.

To change the number of On/Off CoD resources or days that are currently activated, specify an activate operation with this option, specify the total number of activated On/Off 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 On/Off 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 On/Off CoD resources.

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

Note that CUoD and Trial CoD resources are activated by entering CoD codes.

-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*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system. The tttt-mmm*ssssssss 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 On/Off CoD, reserve for Reserve CoD, and trial for Trial CoD.

-r

The CoD resource type. Valid values are mem for memory and proc for processors.

-q

The quantity of On/Off CoD or Reserve CoD resources requested. The value specified must be a whole number which is greater than 0.

When requesting On/Off 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 On/Off CoD resources are requested.

--help

Display the help text for this command and exit.

Enter a CoD code:

chcod -m sys1 -o e -k AlphaNumericString12345

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

Increase to 5 GB of On/Off CoD memory for 3 days:

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

Activate 4 On/Off CoD processors for 5 days:

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

Decrease to 1 On/Off CoD processor for 5 days:

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

Activate 3 Reserve CoD processors:

chcod -m 9406-570*1001CA -o a -c reserve -r proc -q 3

Decrease the number of activated Reserve CoD processors to 1:

chcod -m sys1 -o a -c reserve -r proc -q 1

Deactivate all On/Off CoD processors:

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

Deactivate all Reserve CoD processors:

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

Deactivate all Trial CoD memory and stop the trial:

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

None

None

lscod