The IBMTSSVC_StorageVolume class represents a device that is presented by the cluster that can be mapped as a SCSI LUN to host systems on the SAN. A volume is formed by allocating a set of extents from a pool.
The IBMTSSVC_StorageVolume class extends the CIM_StorageVolume class and has the properties shown in Table 1.
| Property | Type | Qualifier | Description |
|---|---|---|---|
| Access | Uint16 | Describes the media.
|
|
| AccessGranted | Boolean | ModelCorrespondence |
A quick interface to find devices with no AuthorizationSubject association to an AccessControl Information instance, either directly or by use of a controller. If set to true, the device has granted access to a consumer. If set to false, no access has been granted. |
Additional |
Uint16[] | Deprecated(CIM_Associated |
Additional availability and status of
the device, beyond that specified in the Availability property. The
Availability property denotes the primary status and availability
of the device. In some cases, it is not sufficient to denote the complete
status of the device. In those cases, the AdditionalAvailability property
can be used to provide further information.
|
| Availability | Uint16 | Deprecated(CIM_Associated |
The primary availability and status of
the device.
|
| BackendVolumeID | String | Expensive(TRUE) | The ID of the underlying BackendVolume. Only valid if Type=Image. |
BackendVolume |
String | Expensive(TRUE) | The name of the underlying BackendVolume. Only valid if Type=Image. |
| BlockSize | Uint64 | Units(Bytes) | The size in bytes of the blocks that form this StorageExtent. If the block size is variable, the maximum block size in bytes must be specified. If the block size is unknown or if a block concept is not valid (for example, for AggregateExtents, Memory, or LogicalDisks), enter a 1. |
| Caption | String | MaxLen(15), Write(TRUE), WriteRole(Administrator) | A short textual description (one-line string) of the object. |
| CacheMode | Uint16 |
|
|
| CacheState | Uint16 | Expensive(TRUE) | The cache state of the volume.
|
| ConsumableBlocks | Uint64 | The maximum number of blocks, of size BlockSize, that are available for consumption when layering StorageExtents using the BasedOn association. This property is used when this StorageExtent is an Antecedent reference in a BasedOn relationship. For example, a StorageExtent can be composed of 120 blocks. However, the extent itself can use 20 blocks for redundancy data. If another StorageExtent is BasedOn this extent, only 100 blocks are available to it. This information (100 blocks are available for consumption) is indicated in the ConsumableBlocks property. | |
| Controlled | Boolean | A quick interface to find devices with no ControlledBy associations to controllers. If set to true, the device is connected to one or more ports by use of controllers. If set to false, the device exists but is not connected to a port. | |
CreationClass |
String | MaxLen(256) | 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. |
| DataOrganization | Uint16 | The type of data organization that is
used.
|
|
| DataRedundancy | Uint16 | ModelCorrespondence |
The number of complete copies of data that are maintained. |
| DeltaReservation | Uint8 | MinValue(0), MaxValue(100), |
The current value for Delta reservation. |
| Description | String | A textual description of the object. | |
| DeviceID | String | MaxLen(64) | The ID of the StorageVolume. A numeric value that is only unique for instances of the StorageVolume class. |
| ElementName | String | MaxLen(15), Write(TRUE), WriteRole(Administrator) | The user-friendly name of the volume. |
| EnabledDefault | Uint16 | Write(TRUE) | The default or startup configuration
for an element's EnabledStatus. By default, the EnabledStatus is 2
(Enabled).
|
| EnabledState | Uint16 | ModelCorrespondence |
The operational state of the element.
|
| ErrorCleared | Boolean | Deprecated(CIM_Managed |
This property is not supported. |
| ErrorDescription | String | Deprecated(CIM_Device |
This property is not supported. |
| ErrorMethodology | String | This property is not supported. | |
| ExtentStatus | Uint16[] | StorageExtents have additional status
information beyond that captured in the Availability and StatusInfo
properties, inherited from the ManagedSystem Element. This additional
information is captured in the VolumeStatus property.
|
|
| FCID | String | The FlashCopy ID of the volume. | |
| FCName | String | The FlashCopy name of the volume. | |
| FlashCopyMapCount | Uint16 | The number of FlashCopy mappings that contain this volume. | |
| GroupID | String | The ID of the scoping RedundancyGroup. | |
| GroupName | String | The name of the scoping RedundancyGroup. | |
| Identifying Descriptions | String[] | ArrayType(Indexed), |
An array of free-form strings that provides explanations and details behind the entries in the OtherIdentifyingInfo array. Each entry of this array is related to the entry in OtherIdentifyingInfo that is located at the same index. |
| InstallDate | Date- |
This property is not supported. | |
| IsBasedOn Underlying Redundancy | Boolean | A value of true indicates that the underlying StorageExtent(s) participate in a StorageRedundancy Group. | |
| IsFormatted | Boolean | Expensive(TRUE) | A value of true indicates that the volume has been formatted by the SAN Volume Controller. |
| LastErrorCode | Uint32 | Deprecated(CIM_Device |
This property is not supported. |
| MaxQuiesceTime | Uint64 | Deprecated(No value), Units(MilliSeconds) | This property is not supported. |
| Name | String | ModelCorrespondence |
A unique identifier for the volume. |
| NameFormat | Uint16 | ModelCorrespondence |
Format of the Name property. For non
SCSI volumes, SNVM is the most appropriate choice.
|
| NameNamespace | Uint16 | ModelCorrespondence |
The preferred source for volume names
is SCSI vital product data (VPD) Page 83 responses. Page 83 returns
a list of identifiers for various device elements. The metadata for
each identifier includes an association field, identifiers with association
of 0 apply to volumes. Page 83 supports several namespaces specified
in the type field in the identifier metadata.
|
| NativeStatus | Uint16 | The native operational status of the
volume.
|
|
NoSinglePoint |
Boolean | ModelCorrespondence |
Indicates if a single point of failure exists. |
| NumberOfBlocks | Uint64 | The total number of logically contiguous blocks, of size BlockSize, that form this extent. The total size of the extent can be calculated by multiplying BlockSize by NumberOfBlocks. If the BlockSize is 1, this property is the total size of the extent. | |
| OperationalStatus | Uint16[] | ArrayType(Indexed), |
The status of the volume.
|
| OtherEnabledState | String | ModelCorrespondence |
The state of the element when the EnabledStatus property is set to 1 (Other). This property must be set to null when EnabledStatus is any value other than 1. |
| OtherIdentifyinInfo | String[] | MaxLen(256), |
Additional data, beyond DeviceID information, that can be used to identify a LogicalDevice. For example, the Operating System's user-friendly name for the device. |
| OtherNameFormat | String | ModelCorrespondence |
The description of the format of the Name property when NameFormat includes the value 1 (Other). |
OtherName |
String | ModelCorrespondence |
The description of the namespace of the Name property when NameNamespace includes the value 1 (Other). |
| PackageRedundancy | Uint16 | ModelCorrespondence |
The number of disk spindles that can fail without data loss. |
| PoolID | String | The ID of the hosting storage pool. | |
| PoolName | String | The name of the pool from which this volume was allocated. | |
| PowerManagement Capabilities | Uint16[] | Deprecated(CIM_Power |
An enumerated array that describes the
power management capabilities of the device. This property is deprecated.
Instead, the PowerCapabilites property in an associated PowerManagement
Capabilities class must be used.
|
PowerManagement |
Boolean | Deprecated(CIM_Power |
Indicates if the device can be power managed. This property is deprecated. Instead, the existence of an associated PowerManagement Capabilities class (associated using the ElementCapabilities relationhip) indicates that power management is supported. |
| PowerOnHours | Uint64 | Deprecated(CIM_Powered |
This property is not supported. |
| PreferredNode | String | Expensive(TRUE) | The ID of the preferred node. |
| Primordial | Boolean | Indicates if the containing system does not have the ability to create or delete this operational element. | |
| Purpose | String | The description of the media and its use. | |
| RequestedState | Uint16 | ModelCorrespondence |
The state change for the element that
must be made at the next opportunity. The SAN Volume Controller does
not evaluate this attribute and therefore no action is taken when
it changes.
|
| SCID | String | The sync copy ID of the volume. | |
| SCName | String | The sync copy name of the volume. | |
| SequentialAccess | Boolean | Indicates if storage is sequentially accessed by a MediaAccessDevice. For example, a TapePartition is a sequentially accessed StorageExtent. StorageVolumes, DiskPartitions, and LogicalDisks are random-access extents. | |
| Status | String | MaxLen(10), Deprecated(CIM_ |
Deprecated property that is set to unknown. See OperationalStatus for status information. |
| StatusDescriptions | String[] | ArrayType(Indexed), |
The description of the status that is used when the OperationalStatus property is set to 1 (Other). |
| StatusInfo | Uint16 | Deprecated(CIM_Enabled |
Deprecated porperty. See CIM_Enabled
LogicalElement. EnabledState instead.
|
SystemCreation |
String | Propagated(CIM_System. |
The CreationClassName of the scoping system. |
| SystemName | String | Propagated(CIM_System. |
The IP address of the scoping cluster. |
| Throttle | Uint64 | Units(IOs per second), Write(TRUE), WriteRole(Administrator), Expensive(TRUE) | The maximum bandwidth of the volume. |
TimeOfLast |
Date- |
This property is not supported. | |
TotalPowerOn |
Uint64 | Deprecated(CIM_Powered |
This property is not supported. |
| Type | Uint32 | Value(Sequential Striped Router Image) | The type of volume. |
| UnitDeviceID | Uint16 | The unit device identifier of the volume as defined by OpenVMS. |