Share via


ScsiScan method of the CIM_StorageConfigurationService class

This method requests that the system rescan SCSI devices for changes in their configuration. If called on a general-purpose host, the changes are reflected in the list of devices available to applications (for example, the UNIX 'device tree'. This method may also be used on a storage appliance to force rescanning of attached SCSI devices.

This operation can be disruptive; optional parameters allow the caller to limit the scan to a single or set of SCSI device elements. All parameters are optional; if parameters other Job are passed in as null, a full scan is invoked.

Syntax

uint32 ScsiScan(
  [in, out] CIM_ConcreteJob          REF Job,
  [in]      uint16                       ConnectionType,
  [in]      string                       OtherConnectionType,
  [in]      CIM_SCSIProtocolEndpoint REF Initiators[],
  [in]      string                       Targets[],
  [in, out] string                       LogicalUnits[]
);

Parameters

Job [in, out]

Reference to the job (may be null if job completed).

ConnectionType [in]

The type of connection, constrains the scan to initiator ports of this type. Only used if the Initiators parameter is null.

Other (1)

Fibre Channel (2)

Parallel SCSI (3)

SSA (4)

IEEE 1394 (5)

RDMA (6)

iSCSI (7)

SAS (8)

ADT (9)

OtherConnectionType [in]

The connection type, if the ConnectionType parameter is "Other".

Initiators [in]

A list of references to initiators. Scanning will be limited to SCSI targets attached to these initiators. If this parameter is null and connection is specified, all initiators of that connection type are scanned. If this parameter and ConnectionType are null, all targets on all system initiators are probed.

Targets [in]

A list of names or numbers for targets. These should be formatted to match the appropriate connection type, For example, PortWWNs would be specified for Fibre Channel targets.

LogicalUnits [in, out]

A list of SCSI logical unit numbers representing logical units hosted on the targets specified in the Targets argument.

Return value

Success (0)

Not Supported (1)

Unknown (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

DMTF Reserved (6 4095)

Invalid connection type (4096)

Invalid Initiator (4097)

No matching target found (4098)

No matching LUs found (4099)

Prohibited by name binding configuration (4100)

DMTF Reserved (4101 32767)

Vendor Specific (32768 65535)

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012 R2
Namespace
Root\CIMv2\Storage\iScsiTarget
MOF
SmIscsiTarget.mof
DLL
SMiSCSITargetProv.dll

See also

CIM_StorageConfigurationService