HP 3PAR StoreServ 7450 2-node HP 3PAR CIM API Programming Reference (OS 3.1.2 - Page 34

[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 () ValueMap 0 1 2 3 4 5 6 4097 Values Job Completed with No Error Not supported Unknown Timeout Failed Invalid Parameter In Use Size Not Supported Explanation/Notes 34 CIM API SMI-S Support