3PAR CIM API Programming Reference for InForm OS 2.3.1 (320-200164 Rev B, February 2010)

5.30
Block Services Package
CIM API Programming Reference InForm OS Version 2.3.1
 Size: As an input, this is the desired logical size in bytes of the StorageVolume. If it is not
possible to create a volume of the desired size, a return code of Size not supported is
returned with the size set to the nearest supported size. If it’s a growing volume request,
the size is the new size of the volume. As an output, size is the actual size allocated for the
volume. It might be a little larger than the input size because the allocation unit is based on
chunklet size (256 MB).
 InPool: This option contains the reference to the source StoragePool.
 For InForm OS release 2.2.4 and prior, the only correct input is the reference to
Concrete pool. If something else is passed in, this method throws an invalid parameter
exception. There are two kinds of concrete pools: Fibre Channel (FC) pool and Nearline
(NL) pool. If this parameter is NULL, then by default StorageVolume is created from FC
pool.
 For release 2.3.1 and later, this can either be a reference to Concrete pool or
DynamicStoragePool. If this contains a reference to Concrete pool, then only a fully
provisioned volume can be created and the ElementType has to be set to
StorageVolume(2). If this contains a reference to DynamicStoragePool, then the
volume that is created is a fully provisioned volume, if the ElementType is set to
StorageVolume(2), or TPVV, if ElementType is set to
ThinlyProvisionedStorageVolume(5). It is not valid to have a combination of
ThinlyProvisionedStorageVolume(5) for the ElementType and a reference to the
Concrete pool for InPool parameter. If this parameter is NULL and ElementType is set
to StorageVolume(2), then by default StorageVolume is created from FC pool.
 TheElement: As an input, if it’s not null, the method is called to modify (either set or grow)
the existing StorageVolume. If it’s null (on input), the method is called to create a new
StorageVolume. As an output, it contains the newly created StorageVolume options.
Table 5-21 shows the return values for CreateOrModifyElementFromStoragePool():
Table 5-21. Return Values for CreateOrModifyElementFromStoragePool()
ValueMap Values Explanation/Notes
0 Job Completed with No Error
4 Failed