MSISCSITARGET_iSCSISessionSettings class

  • Article

Contains the default settings for an iSCSI Session. These properties are used as the starting position for login negotiations between initiator and target nodes.

Depending on a given implementation, an instance of MSISCSITARGET_iSCSISessionSettings is associated by MSISCSITARGET_ElementSettingData to one or more instances of MSISCSITARGET_iSCSIProtocolEndpoint, MSISCSITARGET_SCSIProtocolController, or CIM_ComputerSystem.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[Dynamic, Provider("MSiSCSITargetProv"), Version("1.0.0")]
class MSISCSITARGET_iSCSISessionSettings : CIM_iSCSISessionSettings
{
  string  Caption;
  string  Description;
  string  InstanceID;
  string  ElementName;
  uint32  MaxConnectionsPerSession = 1;
  boolean InitialR2TPreference = TRUE;
  boolean ImmediateDataPreference = TRUE;
  uint32  MaxOutstandingR2T = 1;
  uint32  MaxUnsolicitedFirstDataBurstLength = 65536;
  uint32  MaxDataBurstLength = 262144;
  boolean DataSequenceInOrderPreference = TRUE;
  boolean DataPDUInOrderPreference = TRUE;
  uint32  DefaultTimeToWaitPreference = 2;
  uint32  DefaultTimeToRetainPreference = 20;
  uint32  ErrorRecoveryLevelPreference = 0;
  string  SystemName;
};

Members

The MSISCSITARGET_iSCSISessionSettings class has these types of members:

Properties

The MSISCSITARGET_iSCSISessionSettings class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

The Caption property is a short textual description (one- line string) of the object.

This property is inherited from CIM_ManagedElement.

DataPDUInOrderPreference

Data type: boolean

Access type: Read/write

Qualifiers: MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeDataPDUInOrder"), ModelCorrespondence ("CIM_iSCSISession.DataPDUInOrder")

The DataPDUInOrder preference of this node. False (=No) indicates that iSCSI data PDUs within sequences MAY be in any order. True (=Yes) indicates that data PDUs within sequences MUST be at continuously increasing addresses, with no gaps or overlay between PDUs.

This property is inherited from CIM_iSCSISessionSettings.

DataSequenceInOrderPreference

Data type: boolean

Access type: Read/write

Qualifiers: MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeDataSequenceInOrder"), ModelCorrespondence ("CIM_iSCSISession.DataSequenceInOrder")

The DataSequenceInOrder preference of this node. False (=No) indicates that iSCSI data PDU sequences MAY be transferred in any order. True (=Yes) indicates that data PDU sequences MUST be transferred using continuously increasing offsets, except during error recovery.

This property is inherited from CIM_iSCSISessionSettings.

DefaultTimeToRetainPreference

Data type: uint32

Access type: Read/write

Qualifiers: Units ("Seconds"), MinValue (0), MaxValue (3600), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeDefaultTime2Retain"), ModelCorrespondence ("CIM_iSCSISession.DefaultTimeToRetain")

The DefaultTime2Retain preference of this node. This is the maximum time, in seconds after an initial wait (Time2Wait), before which an active iSCSI task reassignment is still possible after an unexpected connection termination or a connection reset.

This property is inherited from CIM_iSCSISessionSettings.

DefaultTimeToWaitPreference

Data type: uint32

Access type: Read/write

Qualifiers: Units ("Seconds"), MinValue (0), MaxValue (3600), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeDefaultTime2Wait"), ModelCorrespondence ("CIM_iSCSISession.DefaultTimeToWait")

The DefaultTime2Wait preference of this node. This is the minimum time, in seconds, to wait before attempting an explicit/implicit logout or active iSCSI task reassignment after an unexpected connection termination or a connection reset.

This property is inherited from CIM_iSCSISessionSettings.

Description

Data type: string

Access type: Read-only

Contains a textual description of the object.

This property is inherited from CIM_ManagedElement.

ElementName

Data type: string

Access type: Read-only

Qualifiers: Required

The user-friendly name for this instance of SettingData. In addition, the user-friendly name can be used as an index property for a search or query. (Note: The name does not have to be unique within a namespace.)

This property is inherited from CIM_SettingData.

ErrorRecoveryLevelPreference

Data type: uint32

Access type: Read/write

Qualifiers: MinValue (0), MaxValue (255), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeErrorRecoveryLevel"), ModelCorrespondence ("CIM_iSCSISession.ErrorRecoveryLevel")

The ErrorRecoveryLevel preference of this node. Currently, only 0-2 are valid. This is designed to accommodate future error recover levels.

Higher error recovery levels imply support in addition to support for the lower error level functions. In other words, error level 2 implies support for levels 0-1, since those functions are subsets of error level 2.

This property is inherited from CIM_iSCSISessionSettings.

ImmediateDataPreference

Data type: boolean

Access type: Read/write

Qualifiers: MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeImmediateData"), ModelCorrespondence ("CIM_iSCSISession.ImmediateData")

This property indicates ImmediateData preference for this node True = YES (but will accept NO), False = NO.

This property is inherited from CIM_iSCSISessionSettings.

InitialR2TPreference

Data type: boolean

Access type: Read/write

Qualifiers: MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeInitialR2T"), ModelCorrespondence ("CIM_iSCSISession.InitialR2T")

This property indicates the InitialR2T preference for this node: true = YES, false = will try to negotiate NO, will accept YES.

This property is inherited from CIM_iSCSISessionSettings.

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key

Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. To ensure uniqueness within the NameSpace, the value of InstanceID should be constructed using the following "preferred" algorithm:

<OrgID>:<LocalID>

Where <OrgID> and <LocalID> are separated by a colon (:), and where <OrgID> must include a copyrighted, trademarked, or otherwise unique name that is owned by the business entity that is creating or defining the InstanceID or that is a registered ID assigned to the business entity by a recognized global authority. (This requirement is similar to the <Schema Name>_<Class Name> structure of Schema class names.) In addition, to ensure uniqueness, <OrgID> must not contain a colon (:). When using this algorithm, the first colon to appear in InstanceID must appear between <OrgID> and <LocalID>.

<LocalID> is chosen by the business entity and should not be reused to identify different underlying (real-world) elements. If the above "preferred" algorithm is not used, the defining entity must assure that the resulting InstanceID is not reused across any InstanceIDs produced by this or other providers for the NameSpace of this instance.

For DMTF-defined instances, the "preferred" algorithm must be used with the <OrgID> set to CIM.

This property is inherited from CIM_SettingData.

MaxConnectionsPerSession

Data type: uint32

Access type: Read/write

Qualifiers: MinValue (1), MaxValue (65535), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeMaxConnections"), ModelCorrespondence ("CIM_iSCSISession.MaxConnectionsPerSession")

The maximum number of connections allowed in each session to and/or from this node.

This property is inherited from CIM_iSCSISessionSettings.

MaxDataBurstLength

Data type: uint32

Access type: Read/write

Qualifiers: Units ("Bytes"), MinValue (512), MaxValue (16777215), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeMaxBurstLength"), ModelCorrespondence ("CIM_iSCSISession.MaxDataBurstLength")

The maximum number of bytes which can be sent within a single sequence of Data-In or Data-Out PDUs.

This property is inherited from CIM_iSCSISessionSettings.

MaxOutstandingR2T

Data type: uint32

Access type: Read/write

Qualifiers: MinValue (1), MaxValue (65535), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeMaxOutstandingR2T"), ModelCorrespondence ("CIM_iSCSISession.MaxOutstandingR2T")

Maximum number of outstanding R2Ts allowed per ISCSI task.

This property is inherited from CIM_iSCSISessionSettings.

MaxUnsolicitedFirstDataBurstLength

Data type: uint32

Access type: Read/write

Qualifiers: Units ("Bytes"), MinValue (512), MaxValue (16777215), MappingStrings ("MIB.IETF|iSCSI-MIB.iscsiNodeFirstBurstLength"), ModelCorrespondence ("CIM_iSCSISession.MaxUnsolicitedFirstDataBurstLength")

The maximum length (bytes) supported for unsolicited data to/from this node.

This property is inherited from CIM_iSCSISessionSettings.

SystemName

Data type: string

Access type: Read-only

Indicates the computer system name.

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_iSCSISessionSettings

iSCSI Target Server Reference

CIM_ManagedElement

CIM_SettingData