HP 3PAR StoreServ 7200 2-node HP 3PAR CIM API Programming Reference (OS 3.1.2 - Page 35

CreateSetting Table 33 Method for TPD_StorageCapabilities.CreateSetting Method CreateSetting() Description Allows clients to create a new StorageSetting instance based on existing instances. This method returns a new instance to the client with default property values. There are four instances of StorageCapabilities (one for each RAID type). The type of StorageSetting the client wants to create is determined by the referenced StorageCapabilities. For example, if the client invokes CreateSetting() method on a RAID-0 StorageCapabilities instance, then a RAID-0 StorageSetting instance is returned. The client can use intrinsic method ModifyInstance() to customize the properties as needed. Uint32 CreateSetting ( [in] uint16 SettingType, [Out] CIM_StorageSetting REF NewSetting); • SettingType (in): If Default (2) is passed, the Max, Goal, and Min setting attributes are set to the Default values of the parent StorageCapabilities option when the instance is created. If they are set to Goal (3), the new StorageSetting attributes are set to the related attributes of the parent StorageCapabilities options, such as Min to Min, Goal to Default, and Max to Max. • NewSetting (out): Reference to a new StorageSetting instance based on the parent StorageCapabilities. For example, if the parent StorageCapabilities option is the RAID-0 instance, then this instance is a copy of the pre-created RAID-0 StorageSetting instance. Table 34 Return Values for CreateSetting () ValueMap 0 4 5 Values Method Completed OK Failed Invalid Parameters Explanation/Notes Creating a Volume with a Default Setting A volume can be created using one of the fixed StorageSetting from the four available RAID types. The volume is then created with the default values associated with each RAID type. If no StorageSetting reference is passed into CreateOrModifyElementFromStoragePool, then a volume with default RAID-10 properties is created. To create a legacy volume with FC drives, use reference to FC StoragePool as the InPool parameter. To create a legacy volume with SSDs, use reference to SSD StoragePool as the InPool parameter. To create a legacy volume with NL drives, use reference to NL StoragePool as the InPool parameter. To create a thinly provisioned volume or a fully provisioned volume that allocates from a DynamicStoragepool, use reference to DynamicStoragePool as the InPool parameter; for TPVV, the ElementType parameter should be set to ThinlyProvisionedStorageVolume(5). For fully provisioned volume, the ElementType parameter should be set to StorageVolume(2). If the InPool parameter is NULL, by default FC drives are used to create the volume. The fixed TPD_StorageSetting instances can be found by walking the StorageSettingAssociatedToCapabilities association from TPD_StorageCapabilities. Block Services Package 35