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

CreateSetting
Table 33 Method for TPD_StorageCapabilities.CreateSetting
DescriptionMethod
Allows clients to create a new StorageSetting instance
based on existing instances.
CreateSetting()
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 ()
Explanation/NotesValuesValueMap
Method Completed OK0
Failed4
Invalid Parameters5
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