HP 3PAR CIM API Programming Reference (OS 3.1.2 MU2) (QL226-97015, June 2013)

• InPool: This option contains the reference to the source StoragePool.
◦ 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 is not null, the method is called to modify (either set or grow) the
existing StorageVolume. If it is null (on input), the method is called to create a new
StorageVolume. As an output, it contains the newly created StorageVolume options.
Table 30 Return Values for CreateOrModifyElementFromStoragePool()
Explanation/NotesValuesValueMap
Job Completed with No Error0
Failed4
Invalid Parameter5
A volume with the specified size cannot
be created or grown.
Size Not Supported4097
Creating Data and Snapshot Space from Two Storage Pools
Table 31 (page 33) shows the supported method for creating data and snapshot space from two
storage pools:
Table 31 Method for TPD_StorageConfigurationService
DescriptionMethod
Supports data and snapshot spaces, allocating space from
two different DynamicStoragePools. This method can
TPD_CreateOrModifyElementFromStoragePools
also be used to modify existing TP StorageVolume, for
example, increasing its size or changing other properties.
This method is useful for creating a default volume that has snap space without the need for
specifying a Goal parameter.
This method can also be used to create fully-provisioned volumes that draw user space from a DSP.
NOTE: This method does not support creating a legacy volume where user space is allocated
from a concrete “all” pool, although CreateOrModifyElementFromStoragePool still supports
this.
Method Signature for CreateOrModifyElementFromStoragePools
The method signature for CreateOrModifyElementFromStoragePools is described as
follows:
uint32 TPD_CreateOrModifyElementFromStoragePools (
[In] String ElementName,
[In,
Values {"StorageVolume","ThinlyProvisionedStorageVolume"},
ValueMap{"2", "5"}]
Uint16 ElementType,
Block Services Package 33