HP 3PAR InForm OS 3.1.1 CIM API (QL226-96591, July 2012)

Table 30 Return Values for CreateOrModifyElementFromStoragePool() (continued)
Explanation/NotesValuesValueMap
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 31) 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,
[Out] CIM_ConcreteJob ref Job,
[In] CIM_StorageSetting ref Goal,
[In] CIM_StoragePool ref InPools[],
[In, Out] Uint64 Size,
[In, Out] CIM_LogicalElement ref TheElement);
• ElementName: The name of the TP StorageVolume (TPVV) or StorageVolume (CPVV)
to be created.
• ElementType: This enumeration specifies what type of object to create. StorageVolume(2)
and ThinlyProvisionedStorageVolume(5) are supported. If other values are passed
in, the provider should throw an “operation not supported” exception.
• Job: If a Job was created as a side-effect of the execution of the method, a reference to that
Job is returned through this parameter. Job control is not supported. This output parameter is
always NULL.
• InPool: This array contains string references (object path) of DynamicStoragePool where
the volume draws space. The first element contains DynamicStoragePool for user data.
The second element contains a DynamicStoragePool for snapshot space. The snapshot
space properties (allocation warning and space limit threshold, etc …) from each pool are
Block Services Package 31