HP StorageWorks SAN Virtualization Services Platform SMI-S User Guide (5697-0209, April 2010)
Methods
CreateGroup
Method overview
This method creates an HPSVSP_VirtualDiskGroup instance.
Supported return values:
• 0 (Success)
• 1 (Not Supported)
• 4 (Failed)
• 5 (Invalid Parameter)
Parameter preconditions:
• DeleteOnEmptyElement
• Empty groups are not supported. Attempts to remove the final member of a group results in
error and failure to remove member.
• If this value is supplied, it must be NULL. If otherwise, an INVALID_PARAMETER exception will
be thrown.
• DeleteOnUnassociated
• If this value is supplied and is non-null, it must be False. If otherwise, an INVALID_PARAMETER
exception will be thrown.
• GroupName
• User defined name is required.
• If this value is not supplied or is null, an INVALID_PARAMETER exception will be thrown.
• Provider does not enforce length. Name is passed as is to the VSM, and if too long, an excep-
tion will be thrown with text from VSM indicating an error.
• Members
• Empty groups are not supported, this value must not be null.
• If this value is not supplied or is null, 5 (Invalid Parameter) is returned.
• Persistent
• Groups are not transient.
• If this value is supplied and is non-null, it must be True. If otherwise, an INVALID_PARAMETER
exception will be thrown.
• ServiceAccessPoint
• If this value is not supplied or is null, an INVALID_PARAMETER exception will be thrown.
Post-conditions:
• An instance of HPSVSP_VirtualDiskGroup shall be created and returned through the Virtu-
alDiskGroup (out) parameter.
• If an error happens after preconditions are checked, a value of 4 (Failed) is returned.
• If no errors occur, 0 (OK) is returned.
SAN Virtualization Services Platform SMI-S User Guide 153