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

[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 (FPVV) 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
described in the corresponding Goals array. For TPVV or CPVV, the array size may be two,
even if both its user and snap space are drawn from the same DSP. For a fully-provisioned
volume or a TPVV that is not a CPVV, the array size must be one, corresponding to only the
user space. InPools cannot contain anything other than DynamicStoragePool.
• Goal: This contains object path of StorageSetting, describing quality of service the new
StorageVolume must provide.
• Size: As an input, this is the desired logical size in bytes of the TP StorageVolume or the
requested size of the StorageVolume. If it is a modification request, “Size” is the new size
which must be greater than the existing size (e.g. volume can grow, but can not shrink). For
TP StorageVolume, the system actually allocates only minimum disk space to back up the
volume. More space is allocated on demand as more write data occur. The allocation unit
for each space allocation is the “growth increment” size. The system continues to allocate
more space until either the system runs out of disk space or maximum allocation of the volume
(SpaceLimit) is reached.
• TheElement: Should be null as an input to create a new TP StorageVolume or
StorageVolume. Upon method completion, it contains the object path of the newly created
TP StorageVolume. If it is not null, it refers to the TP StorageVolume to be modified (e.g.,
changing size, allocation warning, etc.).
Table 32 Return Values for TPD_CreateOrModifyElementFromStoragePools ()
Explanation/NotesValuesValueMap
Job Completed with No Error0
Not supported1
Unknown2
Timeout3
Failed4
Invalid Parameter5
In Use6
Size Not Supported4097
34 CIM API SMI-S Support