MaskingMapping
Class IBMTSSVC_StorageHardwareIDManagementService


CIM_ManagedElement
\_CIM_ManagedSystemElement
  \_CIM_LogicalElement
    \_CIM_EnabledLogicalElement
      \_CIM_Service
        \_CIM_SecurityService
          \_CIM_AuthenticationService
            \_CIM_StorageHardwareIDManagementService


Description


Subclasses


Referenced By

IBMTSSVC_AvailableHardwareID IBMTSSVC_ManagesHardwareID IBMTSSVC_StorageHardwareIDsForSystem

Properties

IdTypeRangeDescription
Key
CreationClassName string
Max Length256
CreationClassName indicates the name of the class or the subclass that is used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.
Name string
Max Length256
The Name property uniquely identifies the Service and provides an indication of the functionality that is managed. This functionality is described in more detail in the Description property of the object.
SystemCreationClassName string
Max Length256
The CreationClassName of the scoping System.
SystemName string
Max Length256
The Name of the scoping System.
Read Only
Read Write
 
Inherited from class CIM_ManagedElement
Caption, Description, ElementName
 
Inherited from class CIM_ManagedSystemElement
HealthState, InstallDate, Name, OperationalStatus, Status, StatusDescriptions
 
Inherited from class CIM_EnabledLogicalElement
EnabledState, OtherEnabledState, RequestedState, TimeOfLastStateChange, EnabledDefault
 
Inherited from class CIM_Service
Started, StartMode, PrimaryOwnerContact, PrimaryOwnerName
 

Method Summary

NameDescription
CreateStorageHardwareIDThis method creates a CIM_StorageHardwareID, it creates the association CIM_ConcreteDependency between this service and the new CIM_StorageHardwareID.
DeleteStorageHardwareIDThis method deletes a named CIM_StorageHardwareID, and also tears down the associations that are no longer needed, including CIM_ConcreteDependency and CIM_AuthorizedSubject.
ModifyHostIOGroupMappingModify the current IOGroups mapped to a specified host.
 
Inherited from class CIM_EnabledLogicalElement
RequestStateChange
 
Inherited from class CIM_Service
StartService, StopService
 
Inherited from class CIM_StorageHardwareIDManagementService
AddHardwareIDsToCollection, CreateGatewayPathID, CreateHardwareIDCollection, CreateStorageHardwareID, DeleteStorageHardwareID
 

Method Detail


CreateStorageHardwareID

Description

This method creates a CIM_StorageHardwareID, it creates the association CIM_ConcreteDependency between this service and the new CIM_StorageHardwareID.

Parameters

IdTypeRangeDescription
In
ElementName string
Max Length15
 
The ElementName of the new StorageHardwareID instance.
StorageID string
StorageID is the value used by the SecurityService to represent Identity - in this case, a hardware worldwide unique name. Can be of the format WWPN:WWPN:WWPN or a single PortWWN with the remainder input into the Additional Ports Parameter.
IDType uint16
The type of the StorageID property. iSCSI IDs may use one of three iSCSI formats - iqn, eui, or naa. This three letter format is the name prefix; so a single iSCSI type is provided here, the prefix can be used to further refine the format.
OtherIDType string
The type of the storage ID, when IDType is"Other".
Setting CIM_StorageClientSettingData
REF to the StorageClientSettingData containing the OSType appropriate for this initiator. If left NULL, the instrumentation assumes a standard OSType - for example, that no OS-specific behavior for this initiator is defined.
Validate boolean
Validate WWPN before adding. Default value is true.
AdditionalPorts string
Optional Parameter. Each item in the vector is an additional WWPN in the StorageHardwareID.
PortLoginMask string
A four character mask of ports enabled for host login. Valid mask values are from"0000"(no ports enabled) to"1111"(all 4 ports enabled). For example: a mask of 0001 would enable only port 1, a mask of 0011 would enable ports 1&2, 0111 would enable ports 1, 2&3 etc. By default, all ports are enabled. This property is not available for SVC clusters running pre v4.1.0 firmware.
IOGroups IBMTSSVC_IOGroup
An array of refs containing IOGroup instances that will be viewable from the new StorageHardwareID (IOGroup Mapping). ** This option is not supported in SVC Cluster code levels before v3.1.0.0. This argument will be ignored for earlier levels. Default = all iogroups on the device.
out
HardwareID IBMTSSVC_StorageHardwareID
REF to the new StorageHardwareID instance.
Return Codes
none

DeleteStorageHardwareID

Description

This method deletes a named CIM_StorageHardwareID, and also tears down the associations that are no longer needed, including CIM_ConcreteDependency and CIM_AuthorizedSubject.

Parameters

IdTypeRangeDescription
In
HardwareID IBMTSSVC_StorageHardwareID
The storage hardware ID to be deleted.
Force boolean
This optional parameter will Force the Deletion of a StorageHardwareID, even if there are StorageVolumes associated to the ProtocolController of this StorageHardwareID. Default = false
out
none
Return Codes
none

ModifyHostIOGroupMapping

Description

Modify the current IOGroups mapped to a specified host. This method is not supported for clusters running code levels before v3.1.0.0.

Parameters

IdTypeRangeDescription
In
Host IBMTSSVC_StorageHardwareID
The host to be modified
IOGroups string
The list of IOGroups to be modified. These can be either IOGroup names or IDs.
Operation uint32
The operation to perform on the given Host/IOGroup. IOGroups is ignored if the operation is RemoveAllMappings
Force boolean
Optionally specified that the changes will be forced (when true). Otherwise a deletion could fail if it would result in the loss of a VDisk to host mapping.
out
none
Return Codes
none