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

• HardwareID: Reference to the new StorageHardwareID instance to delete. This is mandatory.
CreateStorageHardwareIDCollection (Creating a Host)
This method creates a StorageHardwareIDCollection (host) and optionally a list of
WWNs/iscsiNames to assign to it. This is useful to define a set of authorized subjects that can
access volumes. This method causes the creation of the HostedCollection association and
MemberOfCollection association to the members of the IDs parameter.
This operation is similar to “createhost <hostname>” and “createhost <hostname>
<wwn …>” or “createhost –iscsi <hostname> <iscsiName>”. The host as specified in
<hostname> must not have existed. If HardwareIDs (WWN/iscsiNames) are not specified,
then only the host is created.
The method signature is described below:
uint32 CreateStorageHardwareIDCollection (
[In] String ElementName,
[In] String HardwareIDs[],
[In] CIM_StorageClientSettingData REF Setting,
[In] String Domain,
[Out] CIM_SystemSpecificCollection REF Collection);
• ElementName: This is the name of the host to create the host HBA WWN/iscsiName on. The
host must not have existed. This corresponds to the ElementName property of the
StorageHardwareID instance. If the host already exist, use
AddHardwareIDsToCollection instead. This is mandatory.
• HardwareIDs: A list of WWN’s/iscsiNames to assign to the host. If this is null, only the host
(without WWN/iscsiName assigned) is created.
• Setting: Reference to the StorageClientSettingData containing the OSType appropriate
for this initiator. This refers to an TPD_StorageClientSettingData which is equivalent
to a host persona; if not specified then the host persona defaults to Generic.
• Domain: Name of the domain the host should belong to
• Collection: Reference to the new StorageHardwareIDCollection (host) instance. Must
be NULL on input.
AddStorageHardwareIDsToCollection (Adding a Path to a Host)
This method adds a list of WWNs (StorageHardwareID) to the host
(StorageHardwareIDCollection). This creates the MemberOfCollection instances between
the specified Collection and the StorageHardwareIDs.
This operation is similar to “createhost -add <hostname> <wwn …>“ or “createhost
–add –iscsi <hostname> <iscsiName>”. The host as specified in <hostname> must have
existed.
The method signature is described below:
uint32 AddHardwareIDsToCollection (
[In] String HardwareIDs[],
[In] CIM_SystemSpecificCollection REF Collection);
• HardwareIDs: A list of WWN’s/iscsiNames to assign to the host. This is mandatory.
• Collection: A reference to the StorageHardwareIDCollection (host) to add the
WWN’s/iscsiNames to. This is mandatory.
88 CIM API SMI-S Support