chcod Command

Purpose

Manages Capacity Upgrade on Demand.

Syntax

chcod [ -r ResourceType -n NbrResources ] [-c CustomerInfo ] [ -m MailAddr ] [-h ]

Description

The chcod command manages Capacity Upgrade on Demand, or CUoD. CUoD enables the authorization of more ResourceTypes, such as processors, on the system than were initially authorized. The additional resources may be enabled if they are available, and if the system supports CUoD for that ResourceType. Only one ResourceType may be managed at a time. The change in the number of ResourceTypes takes effect after the next system boot. CUoD management also includes displaying the current number of ResourceType(s) that have CUoD support, monitoring the number of ResourceType(s) on the system, and notifying appropriately. Notification occurs on a monthly basis and also whenever NbrResources changes.

Notification takes the form of error logging and, optionally, sending e-mail. An entry is made in the system error log whenever the specified ResourceType changes and also on a monthly basis. The CustomerInfo text is included in the error log. If you specify an e-mail address with MailAddr, notification also occurs through an e-mail message sent to MailAddr. The CustomerInfo text is included in the text of the message. You can have notification by both error logging and e-mail if you specify both CustomerInfo and MailAddr.

With no flags specified, chcod displays the current value of CustomerInfo, MailAddr, the system's model name and serial number, and the current value(s) of NbrResources for any ResourceType that has CUoD support.

Note: Beginning with the IBM® p650 and later models (all POWER4 Systems), CUoD is managed at the Hardware Management Console (HMC).

Flags

Item	Description
-c CustomerInfo	Specifies the text string to include in the error log. This string is also included in the body of any e-mail message sent. CustomerInfo may not be more than 255 characters. Blanks may not be included in the string. AfterCustomerInfo has been specified, subsequent chcod uses do not have to specify the -c flag, but you do have the option of changing it. CustomerInfo may consist of alphanumeric characters and any of . (period), , (comma), - (hyphen), ( (open parenthesis), or ) (close parenthesis).
-h	Displays the usage message.
-m MailAddr	Specifies the e-mail address to which e-mail should be sent. MailAddr may not be more than 255 characters. If MailAddr is reset by specifying "" (a blank string), then only error logging will monitor the resources that have CUoD support. You must have e-mail configured on your system if you want to send notification to this e-mail address.
-n NbrResources	Specifies the number of ResourceTypes to be authorized on the system. It must be zero or greater. If it is 0, CUoD is disabled for the specified ResourceType. If -n is specified, then -r must also be specified.
-r ResourceType	Specifies the ResourceType, for example, `proc` for processors, to be enabled and monitored on the system. The system must support CUoD for ResourceType. If -r is specified, then -n must also be specified.

Examples

To initiate CUoD for processors, type:

chcod -r proc -n 10 -m"someone@ibm.location.com" -c"Jane_Doe-Customer_Number_999999-(111)111-1111"

To change the CustomerInfo, type:

chcod -c"Jane_Doe-Customer_Number_999999-(222)222-2222"

To stop the e-mail form of notification, type:
```
chcod -m""
```

To see the current values of the resources with CUoD support, type:

chcod

A message similar to the following will be displayed:

Current CustomerInfo = Jane_Doe-Customer_Number_999999-(222)222-2222
Current MailAddr = someone@ibm.location.com
Current model and serial number = IBM,7043-150 000974934C00
Current number of authorized processors = 10 of 12 installed on system