BlockServices
Class IBMTSSVC_ConcreteStoragePool


CIM_ManagedElement
\_CIM_ManagedSystemElement
  \_CIM_LogicalElement
    \_CIM_StoragePool


Description

A pool of Storage that is managed within the scope of a particular System. StoragePools may consist of component StoragePools or StorageExtents. StorageExtents that belong to the StoragePool have a Component relationship to the StoragePool. StorageExtents/StoragePools that are elements of a pool have their available space aggregated into the pool. StoragePools and StorageVolumes may be created from StoragePools. This is indicated by the AllocatedFromStoragePool association. StoragePool is scoped to a system by the HostedStoragePool association.For SVC concrete storage pools, this corresponds to a Managed Disk Group from which Virtual Disks can be allocated. SVC concrete StoragePools are not preconfigured and must be created by the storage administrator.

Subclasses


Referenced By

IBMTSSVC_AllocatedFromConcretePool IBMTSSVC_AllocatedFromPrimordialPool IBMTSSVC_ConcreteStoragePoolCapabilities IBMTSSVC_HostedConcretePool IBMTSSVC_MirrorExtentAllocatedFromConcretePool IBMTSSVC_StorageConfigurationService IBMTSSVC_StoragePoolComponent

Properties

IdTypeRangeDescription
Key
InstanceID string
The label by which the object is known.
Read Only
Caption string
Max Length64
The Caption property is a short textual description (one-line string) of the object.
Description string
The Description property provides a textual description of the object.
ExtentSize uint16
The extent size of the pool. Volumes allocated from this pool have a space occupation which is a muliple of the extent size.
NativeStatus uint16
Offline0
Online1
Degraded2
The pool's native operational status. Can be either0 ("Offline"),1 ("Online") or2 ("Degraded").
NumberOfBackendVolumes uint16
The number of BackendVolumes belonging to the pool.
NumberOfStorageVolumes uint16
The number of StorageVolumes allocated from the pool.
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..
The pool's operational status. Values are2 ("OK") for"online","10 ("Stopped") for"offline",1 ("Other") for"empty"or1 ("Other") for"invalid"
Overallocation uint64
Percentage overallocation of space efficent storagevolumes.
PoolID string
Max Length256
The pool's ID. This ID is numeric and only unique in terms of the hosting SAN Volume Controller cluster.
Primordial boolean
If true,"Primordial"indicates that the containing System does not have the ability to create or delete this operational element. This is important because higher-level StoragePools may be assembled using the Component or AllocatedFromStoragePool associations. Although the higher-level abstractions can be created and deleted, the most basic, (that is. primordial), hardware-based StoragePools cannot. They are physically realized as part of the System, or are actually managed by some other System and imported as if they were physically realized. For SVC concrete pools, Primordial is always false.
RealCapacity uint64
Space-Efficient property. Total real capacity of associated Storage Volumes.
RemainingManagedSpace uint64
The remaining amount of raw storage (in bytes) from the TotalManagedSpace of this StoragePool. This property is maintained here to provide efficient access to this information. However, note that it is possible to compute RemainingManagedSpace as (TotalManagedSpace minus the sum of SpaceConsumed from all of the AllocatedFromStoragePool references from this StoragePool). SpaceConsumed remains useful to determine the amount of raw storage consumed by a particular allocated element.
StatusDescriptions string
A string describing the status - used when the OperationalStatus property is set to 1 ("Other").
TotalManagedSpace uint64
The total amount of raw storage (in bytes) managed by this StoragePool. This includes all of the bytes consumed to create the storage surfaced by this StoragePool, including all of the overhead bytes that are not reflected in the size of the logical storage allocated from this StoragePool.Conceptually TotalManagedSpace reflects all storage known via Component associations to underlying StorageExtents or via AllocatedFromStoragePool associations to underlying StoragePools. However, note that this underlying storage may not be surfaced by the instrumentation.
UsedCapacity uint64
Space-Efficient property. Capacity used of associated Storage Volumes. If the storage volume is Space-Efficient then its used capacity is included, otherwise used capacity and real capacity are identical
VirtualCapacity uint64
Space-Efficient property. Virtual capacity of associated Storage Volumes
Warning uint8
Ratio of used vs real capacity at which point an indication is triggered
Read Write
ElementName string
Max Length15
The Storage Pool's user-friendly name.
 
Inherited from class CIM_ManagedElement
Caption, Description, ElementName
 
Inherited from class CIM_ManagedSystemElement
HealthState, InstallDate, Name, OperationalStatus, Status, StatusDescriptions
 
Inherited from class CIM_StoragePool
PoolID, Primordial, RemainingManagedSpace, TotalManagedSpace
 

Method Summary

NameDescription
GetSupportedSizeRangeFor pools that that support a range of sizes for volume or pool creation, this method can be used to retrieve the supported range.
GetSupportedSizesFor pools that support discrete sizes for volume or pool creation, this method can be used to retrieve a list of supported sizes.
 
Inherited from class CIM_StoragePool
GetAvailableExtents, GetSupportedSizeRange, GetSupportedSizes
 

Method Detail


GetSupportedSizeRange

Description

For pools that that support a range of sizes for volume or pool creation, this method can be used to retrieve the supported range. Different pool implementations may support either or both the GetSupportedSizes and GetSupportedSizeRanges methods at different times, depending on Pool configuration. Also note that the advertised sizes may change after the call due to requests from other clients. If the pool currently only supports discrete sizes, then the return value will be set to 1.Since only volumes can be allocated from SVC concrete pools,'Invalid Argument'will be returned if the ElementType is anything other than Storage Volume.

Parameters

IdTypeRangeDescription
In
ElementType uint16
The type of element for which supported size ranges are reported for.
Goal CIM_StorageSetting
The StorageSetting for which supported size ranges should be reported for.
MinimumVolumeSize uint64
The minimum size for a volume/pool in bytes.
MaximumVolumeSize uint64
The maximum size for a volume/pool in bytes.
VolumeSizeDivisor uint64
A volume/pool size must be a multiple of this value which is specified in bytes.
out
MinimumVolumeSize uint64
The minimum size for a volume/pool in bytes.
MaximumVolumeSize uint64
The maximum size for a volume/pool in bytes.
VolumeSizeDivisor uint64
A volume/pool size must be a multiple of this value which is specified in bytes.
Return Codes
none

GetSupportedSizes

Description

For pools that support discrete sizes for volume or pool creation, this method can be used to retrieve a list of supported sizes. Different pool implementations may support either or both the GetSupportedSizes and GetSupportedSizeRanges methods at different times, depending on Pool configuration. Also note that the advertised sizes may change after the call due to requests from other clients. If the pool currently only supports a range of sizes, then the return value will be set to 1.For a SVC concrete storage pool, this method will always return 2 -"Use GetSupportedSizeRanges instead".

Parameters

IdTypeRangeDescription
In
ElementType uint16
The type of element for which supported sizes are reported for.
Goal CIM_StorageSetting
The StorageSetting for which supported sizes should be reported for.
Sizes uint64
List of supported sizes for a Volume/Pool creation or modification.
out
Sizes uint64
List of supported sizes for a Volume/Pool creation or modification.
Return Codes
none