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

• 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.
Creating a Volume with a Non-Default Setting
The following are the steps necessary for an SMI-S client to create a volume with non-default settings:
1. Invoke the CreateSetting method to get at a reference to the TPD_StorageSetting.
The SMI-S provider creates, if one does not exist, an instance of the default or goal
TPD_StorageSetting, depending on the value in the SettingType option. If one already
exists, the provider simply returns a reference to that instance. This instance is transient only
and does not persist across reboots. The client then performs a GetInstance to obtain the
instance of the TPD_StorageSetting in order to examine the properties. If the values are
OK, then it should be used as the Goal parameter for the
CreateOrModifyElementFromStoragePool method. If not, continue with the next step.
2. If you would like to change the value of some or all of the properties in the
TPD_StorageSetting instance from step 1, then you should call the ModifyInstance
method to modify them.
Block Services Package 33