---

HMC Manual Reference Pages  - MKCODPOOL (1)

---

mkcodpool - create a CoD Power enterprise pool

CONTENTS

Synopsis
Description
Options
Exit Status
Examples
Environment
Bugs
Author
See Also

mkcodpool -p pool-name -f file [-a attributes ] [-v] [--help]

mkcodpool creates a Capacity on Demand (CoD) Power enterprise pool.

-p	A name for the Power enterprise pool.
-f	The name of the XML file that contains the Power enterprise pool configuration data. If file is not fully qualified, file must exist in the user’s home directory on the Hardware Management Console (HMC). If file exists on removable media, the media must be present in the removable media device and the device must be mounted with the mount command before this command is issued. The lsmediadev command can be used to display all of the removable media devices on the HMC.
-a	The Power enterprise pool attributes. The attribute data consists of attribute name/value pairs, which are in comma separated value (CSV) format. The format of the attribute data is as follows: attribute-name=value,value,... ,... When a list of values is specified, the attribute name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a ’#146; character. Valid attribute names: mcs Comma separated list of managing HMCs for the pool, with each managing HMC having the following format: host-name-or-IP-address/user-ID/[password][/ [restricted-ops]] The first 2 ’/’ characters must be present. The 3rd ’/’ character is optional, but it must be present if restricted-ops is specified. Optional values may be omitted. Optional values are password and restricted-ops. If password is omitted, you will be prompted to enter the password. Valid values for restricted-ops: 0 - users are not restricted from initiating add and remove Mobile CoD resource operations from this managing HMC (default value) 1 - users are restricted from initiating add and remove Mobile CoD resource operations from this managing HMC Note: do not include the HMC which is running this command in the list. For example: hmc1/user1/ prompts the user for user1’s password then uses that password and the user ID user1 to log into the HMC with host name hmc1 to add that HMC to the pool.
-v	Specify this option to enable verbose mode. When verbose mode is enabled, warning messages and informational messages are displayed for successful create pool operations. Warning messages and informational messages are displayed for create pool operations that partially succeed or fail, regardless of whether this option is specified.
--help	Display the help text for this command and exit.

This command has the following return codes:

0	Success
100	Partial success This value is returned when at least one operation in the configuration file succeeded, and at least one failed.

Any other value means the command failed.

Create the Power enterprise pool pool1 using the configuration file pool0195.xml on a USB flash memory device (the USB flash memory device must already be connected to the HMC) and add HMC hmc1 to the pool:

lsmediadev (to obtain mount points)

mount /media/sdb1

mkcodpool -p pool1 -f /media/sdb1/pool0195.xml
-a "mcs=hmc1/myuserID/mypassword" -v

Create the Power enterprise pool myPool using the configuration file pool.xml in the user’s home directory on the HMC and add the HMCs hmc1 and hmc2 to the pool (you will be prompted to enter the password for each HMC):

mkcodpool -p myPool -f pool.xml -a ""mcs=hmc1/myuserID/,
hmc2/myuserID/"" -v

None

None

IBM Austin

chcodpool, lscodpool, lsmediadev