BlockServices
Class IBMTSSVC_PrimordialStoragePool


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.The SVC primordial StoragePool represents the total amount of storage on the device which corresponds to the sum of all Managed Disks on the Cluster.

Subclasses


Referenced By

IBMTSSVC_AllocatedFromPrimordialPool IBMTSSVC_HostedPrimordialPool IBMTSSVC_PrimordialPoolComponent IBMTSSVC_PrimordialPoolForController IBMTSSVC_PrimordialStoragePoolCapabilities

Properties

IdTypeRangeDescription
Key
InstanceID string
Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. In order to ensure uniqueness within the NameSpace, the value of InstanceID must 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 creating/defining the InstanceID, or is a registered ID that is assigned to the business entity by a recognized global authority (This 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 must not be re-used to identify different underlying (real-world) elements. If the above'preferred'algorithm is not used, the defining entity must assure that the resultant InstanceID is not re-used across any InstanceIDs produced by this or other providers for this instance's NameSpace. For DMTF defined instances, the'preferred'algorithm must be used with the<OrgID>set to'CIM'. For SVC, the singleton primordial pool ID will be of the form IBMTSSVC:<ClusterID>.
Read Only
Caption string
Max Length15
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.
Name string
Max Length1024
The pool's globally unique ID. The id's format is (Vendor)(id), in case of SAN Volume Controller IBMTSSVC:<ClusterID>.
PoolID string
Max Length256
A unique name in the context of the System that identifies this pool. For SVC, this is the ClusterID.
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 the singleton SVC primordial StoragePool, this value is always set to'true'.
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.For SVC, this will be equal to the sum of the capacities of all the Managed Disks that are not already part of a Managed Disk Pool.
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.In SVC terms, this value represents the sum of the raw capacities of all known Managed Disks.
Read Write
 
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.For the SVC Primordial pool, this method will always return (Use GetSupportedSizes instead).

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.Since only pools can be allocated from the SVC primordial Storage Pool,'Invalid Argument'will be returned if the ElementType is anything other than Storage Pool.

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