MultipleComputerSystem
Class IBMTSSVC_IOGroup


CIM_ManagedElement
\_CIM_ManagedSystemElement
  \_CIM_LogicalElement
    \_CIM_EnabledLogicalElement
      \_CIM_System
        \_CIM_ComputerSystem


Description

A group containing two Nodes. An IOGroup defines an interface for a set of Volumes. All Nodes and Volumes are associated with exactly one IOGroup. The read and write cache provided by a node is duplicated for redundancy. When IO is performed to a Volume, the node that processes the IO will duplicate the data on the Partner node in the IOGroup. This class represents the system aspect of an IO group wheras IOGroupSet represents the set aspect.

Subclasses


Referenced By

IBMTSSVC_ClusteringService IBMTSSVC_IOGroupComponentOfCluster IBMTSSVC_IOGroupConcreteIdentity IBMTSSVC_IOGroupDeviceVolumeView IBMTSSVC_IOGroupPort IBMTSSVC_MemberOfClusterRedundancySet IBMTSSVC_NodeComponentOfIOGroup IBMTSSVC_StorageConfigurationService IBMTSSVC_StorageHardwareIDManagementService IBMTSSVC_StorageVolumeOnIOGroup

Properties

IdTypeRangeDescription
Key
CreationClassName string
Max Length256
CreationClassName indicates the name of the class or the subclass 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
The label by which the object is known. Format: cluster_ip:object_id
Read Only
Dedicated uint16
Not Dedicated0
Unknown1
Other2
Storage3
Router4
Switch5
Layer 3 Switch6
Central Office Switch7
Hub8
Access Server9
Firewall10
Print11
I/O12
Web Caching13
Management14
Block Server15
File Server16
Mobile User Device17
Repeater18
Bridge/Extender19
Gateway20
Enumeration indicating whether the ComputerSystem is a special-purpose System (ie, dedicated to a particular use), versus being'general purpose'. SAN Volume Controller is a dedicated storage device and will return {3,15} ("Storage","Block Server")
Description string
The Description property provides a textual description of the object.
EnabledDefault uint16
Enabled2
Disabled3
Not Applicable5
Enabled but Offline6
No Default7
DMTF Reserved8..32767
Vendor Reserved32768..65535
An enumerated value indicating an administrator's default or startup configuration for the Enabled State of an element. By default, the element is"Enabled"(value=2).
EnabledState uint16
Unknown0
Other1
Enabled2
Disabled3
Shutting Down4
Not Applicable5
Enabled but Offline6
In Test7
Deferred8
Quiesce9
Starting10
DMTF Reserved11..32767
Vendor Reserved32768..65535
EnabledState is an integer enumeration that indicates the enabled and disabled states of an element. It can also indicate the transitions between these requested states. For example, shutting down (value=4) and starting (value=10) are transient states between enabled and disabled. The following text briefly summarizes the various enabled and disabled states:Enabled (2) indicates that the element is or could be running commands, will process any queued commands, and queues new requests.Disabled (3) indicates that the element will not run commands and will drop any new requests.Shutting Down (4) indicates that the element is in the process of going to a Disabled state.Not Applicable (5) indicates the element does not support being enabled or disabled.Enabled but Offline (6) indicates that the element might be completing commands, and will drop any new requests.Test (7) indicates that the element is in a test state.Deferred (8) indicates that the element might be completing commands, but will queue any new requests.Quiesce (9) indicates that the element is enabled but in a restricted mode. The behavior of the element is similar to the Enabled state, but it processes only a restricted set of commands. All other requests are queued.Starting (10) indicates that the element is in the process of going to an Enabled state. New requests are queued.
FlashCopyFreeMemory uint32
The Free Memory available for Flash Copies.
FlashCopyTotalMemory uint32
The Total Memory available for Flash Copies.
IdentifyingDescriptions string
An array of free-form strings providing explanations and details behind the entries in the OtherIdentifying Info array. Note, each entry of this array is related to the entry in OtherIdentifyingInfo that is located at the same index.
MirrorFreeMemory uint32
The Free Memory available for mirroring metadata.
MirrorTotalMemory uint32
The Total Memory available for mirroring metadata.
NameFormat string
The NameFormat property identifies how the ComputerSystem Name is generated. SAN Volume Controller returns the node's id as Name, therefore this attribute is set to"Other"
NumberOfHosts uint32
The number of hosts associated with the group.
NumberOfNodes uint32
The number of nodes in the group.
NumberOfVolumes uint32
The number of virtual disk offered by the group.
OperationalStatus uint16
Unknown0
Other1
OK2
Degraded3
Stressed4
Predictive Failure5
Error6
Non-Recoverable Error7
Starting8
Stopping9
Stopped10
In Service11
No Contact12
Lost Communication13
Aborted14
Dormant15
Supporting Entity in Error16
Completed17
Power Mode18
DMTF Reserved..
Vendor Reserved0x8000..
No status information available on group level. Look for the individual nodes'status's
OtherDedicatedDescriptions string
A string describing how or why the system is dedicated when the Dedicated array includes the value 2,"Other".
OtherEnabledState string
A string that describes the enabled or disabled state of the element when the EnabledState property is set to 1 ("Other"). This property must be set to null when EnabledState is any value other than 1.
OtherIdentifyingInfo string
Max Length256
The IOGroup"Name","ID", and the"Name","ID"and"WWNN"of each Node in the IOGroup
RemoteCopyFreeMemory uint32
The Total Memory available for Remote Copies.
RemoteCopyTotalMemory uint32
The Total Memory available for Remote Copies.
RequestedState uint16
Enabled2
Disabled3
Shut Down4
No Change5
Offline6
Test7
Deferred8
Quiesce9
Reboot10
Reset11
Not Applicable12
DMTF Reserved..
Vendor Reserved32768..65535
RequestedState is an integer enumeration that indicates the last requested or desired state for the element. The actual state of the element is represented by EnabledState. This property is provided to compare the last requested and current enabled or disabled states. When EnabledState is set to 5 ("Not Applicable"), then this property has no meaning. By default, the RequestedState ofthe element is 5 ("No Change"). Refer to the EnabledState property description for explanations of the values in the RequestedState enumeration.It should be noted that there are two new values in RequestedState that build on the statuses of EnabledState. These are"Reboot"(10) and"Reset"(11). Reboot refers to doing a"Shut Down"and then moving to an"Enabled"state. Reset indicates that the element is first"Disabled"and then"Enabled". The distinction between requesting"Shut Down"and"Disabled"should also be noted. Shut Down requests an orderly transition to the Disabled state, and might involve removing power, to completely erase any existing state. The Disabled state requests an immediate disabling of the element, such that it will not run or accept any commands or processing requests.This property is set as the result of a method invocation (such as Start or StopService on CIM_Service), or can be overridden and defined as WRITEable in a subclass. The method approach is considered superior to a WRITEable property, because it allows an explicit invocation of the operation and the return of a result code.A particular instance of EnabledLogicalElement might not support RequestedStateChange. If this occurs, the value 12 ("Not Applicable") is used.
ResetCapability uint16
Other1
Unknown2
Disabled3
Enabled4
Not Implemented5
If enabled (value = 4), the ComputerSystem can be reset via hardware (for example, the power and reset buttons). If disabled (value = 3), hardware reset is not allowed. In addition to Enabled and Disabled, other Values for the property are also defined -"Not Implemented"(5),"Other"(1) and"Unknown"(2).
StatusDescriptions string
Strings describing the various OperationalStatus array values. For example, if"Stopping"is the value assigned to OperationalStatus, then this property may contain an explanation as to why an object is being stopped. Entries in this array are correlated with those at the same array index in OperationalStatus.
Read Write
Caption string
Max Length15
The Caption property is a short textual description (one-line string) of the object.
ElementName string
A user-friendly name for the object. This property allows each instance to define a user-friendly name in addition to its key properties, identity data, and description information.The Name property of ManagedSystemElement is also defined as a user-friendly name. But, it is often subclassed to be a Key. The same property cannot convey both identity and a user-friendly name, without inconsistencies. Where Name exists and is not a Key (such as for instances of LogicalDevice), the same information can be present in both the Name and ElementName properties.
 
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_System
NameFormat, PrimaryOwnerContact, PrimaryOwnerName, Roles
 
Inherited from class CIM_ComputerSystem
Dedicated, IdentifyingDescriptions, NameFormat, OtherDedicatedDescriptions, OtherIdentifyingInfo, PowerManagementCapabilities, ResetCapability
 

Method Summary

NameDescription
GetHostsThis method returns the names of associated Hosts.
SetFlashCopyMemoryThis method changes the amount of hardened memory for Flash Copies.
SetMirrorMemoryThis method changes the amount of hardened memory for Remote Copies.
SetRemoteCopyMemoryThis method changes the amount of hardened memory for Remote Copies.
 
Inherited from class CIM_EnabledLogicalElement
RequestStateChange
 
Inherited from class CIM_ComputerSystem
SetPowerState
 

Method Detail


GetHosts

Description

This method returns the names of associated Hosts. This method is not supported in cluster code levels prior to v3.1.0.

Parameters

IdTypeRangeDescription
In
HostNames string
The returned names of the associated Hosts. This method is not supported in cluster code levels prior to v3.1.0.
out
HostNames string
The returned names of the associated Hosts. This method is not supported in cluster code levels prior to v3.1.0.
Return Codes
none

SetFlashCopyMemory

Description

This method changes the amount of hardened memory for Flash Copies. This method is not supported in cluster code levels prior to v4.2.1.

Parameters

IdTypeRangeDescription
In
memory uint32
The amount of memory to allocation for copiesis not supported in cluster code levels prior to v4.2.1.
kilobytes boolean
If the memory listed is in KB instead of MB set this flag.If memory is in kilobytes it must be 0 for divisible by 4.Is not supported in cluster code levels prior to v4.2.1.
out
none
Return Codes
none

SetMirrorMemory

Description

This method changes the amount of hardened memory for Remote Copies. This method is not supported in cluster code levels prior to v4.3.0.

Parameters

IdTypeRangeDescription
In
memory uint32
The amount of memory to allocation for copiesis not supported in cluster code levels prior to v4.3.0.
kilobytes boolean
If the memory listed is in KB instead of MB set this flag.If memory is in kilobytes it must be 0 for divisible by 4.Is not supported in cluster code levels prior to v4.3.0.
out
none
Return Codes
none

SetRemoteCopyMemory

Description

This method changes the amount of hardened memory for Remote Copies. This method is not supported in cluster code levels prior to v4.2.1.

Parameters

IdTypeRangeDescription
In
memory uint32
The amount of memory to allocation for copiesis not supported in cluster code levels prior to v4.2.1.
kilobytes boolean
If the memory listed is in KB instead of MB set this flag.If memory is in kilobytes it must be 0 for divisible by 4.Is not supported in cluster code levels prior to v4.2.1.
out
none
Return Codes
none