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

The method signature is described below:
uint32 HidePaths (
[Out] CIM_ConcreteJob ref Job,
[In] String LUNames[],
[In] String InitiatorPortIDs[],
[In] String TargetPortIDs[],
[In] String DeviceNumbers[],
[In/Out] CIM_SCSIProtocolController ref ProtocolController[],
[In] boolean NoVCN,
[Out] String ResultDescriptions[]);
• Job: This is ignored since the storage system does not support job control.
• LUNames[]: An array of IDs of logical unit instances. The LU instances must already exist. The
members of this array must match the Name property of the StorageVolume instances.
• InitiatorPortIDs[]: IDs of initiator ports (host HBA WWNs)
• TargetPortIDs[]: IDs of target ports (the storage system’s front-end FC port).
• DeviceNumbers[]: A list of logical unit numbers corresponding to the logical unit in the LUNames
parameter. This is a vendor-specific extension and therefore is optional.
• ProtocolControllers[]: An array of references to SCSIProtocolControllers (SPCs). On
input, this contains exactly one element; there may be multiple references on output. If SPC is
included on input, this can either be a reference to TPD_SCSIController for FC host or
TPD_iSCSIController orTPD_iSCSINode for iSCSI host.
• NoVCN: Do not issue a VLUN (Virtual Logical Unit Number) Change Notification (VCN) after
removal. For direct connect or loop configuration, a VCN consists of a fibre channel Loop
Initialization Primitive (LIP). For fabric configuration a VCN consists of Registered State Change
Notification (RSCN) being sent to the fabric controller. This parameter is a vendor-specific
extension. The default value is false.
• ResultDescriptions[]: An array of descriptive text of the result of the operation, with each entry
containing the result of each hide path operation. This parameter is a vendor-specific extension
.
Table 71 HidePaths Use Cases
ProtocolControllers
(On input)
TagetPortIDsInitiatorPortIDsLUNamesUse Cases
Contains a single SPC
ref; if this is a
NULLNULLMandatoryRemove LUs from a
view
TPD_iSCSINode, this
operation is equivalent
to removing an LU
from a port-present
SPC for that iSCSI
port.
Contains a single SPC
ref
MandatoryMandatoryMandatoryHide full paths from a
view
Contains a single SPC
ref
NULLMandatoryNULLRemove Initiator IDs
from view
Parameters DeviceNumbers and NoVCN are optional. All other combinations of the parameters
are rejected.
Masking and Mapping Subprofile 83