BlockServices
Class IBMTSDS_ExtentPool


CIM_ManagedElement
\_CIM_ManagedSystemElement
  \_CIM_LogicalElement
    \_CIM_StoragePool


Description

The ExtentPool represents the storage available on a single DS ExtentPool. This is a concrete pool that can be created from multiple RankPools. The Ranks in a single ExtentPool may different RAID types, but must have the same Extent type. ExtentPools are not preconfigured on the storage device and must be created by the Administrator.

Subclasses


Referenced By

IBMTSDS_AllocatedFromExtentPool IBMTSDS_AllocatedFromRankPool IBMTSDS_DiskExtentToExtentPool IBMTSDS_EncryptionGroupToExtentPool IBMTSDS_ExtentPoolStatisticalData IBMTSDS_ExtentPoolToCapabilities IBMTSDS_HostedExtentPool IBMTSDS_PrimordialToExtentPool IBMTSDS_STDVolumeAllocatedFromStoragePoolView IBMTSDS_VirtualPoolAllocatedFromExtentPool

Properties

IdTypeRangeDescription
Key
InstanceID string
The InstanceID of ExtentPool will be of the form IBMTSDS:'<StorageSystem.Name>-<ExtentPoolID>'.
Read Only
CapacityInMigratingSource uint64
The capacity of allocated Extents in the process of migrating out of this pool.
CapacityInMigratingTarget uint64
The capacity of allocated Extents in the process of being migrating into this pool.
ElementName string
A user-friendly name for the object.This corresponds to the Nickname in the DS Storage Manager and DSCLI.
EncryptionGroupID string
Indicating which EncryptionGroup the ExtentPool is configured in.If the ID is NULL, it means the ExtentPool is not encrypted.
ExtentType uint16
Not applicable0
Unknown1
Undefined2
Fixed Block3
Count Key Data4
33805
Describes the IBM-defined Extent Type. Currently multiple Extent Types for one object are not allowed, but the property is set to be an array for possible future use. On DS, does not differentiate between 3380 and 3390 and is simply considered Count Key Data for both
HealthState uint16
Unknown0
OK5
Degraded/Warning10
Minor failure15
Major failure20
Critical failure25
Non-recoverable error30
DMTF Reserved..
Indicates the current health of the element. This attribute expresses the health of this element but not necessarily that of its subcomponents. The possible values are 0 to 30, where 5 means the element is entirely healthy and 30 means the element is completely non-functional. The following continuum is defined:"Non-recoverable Error"(30) - The element has completely failed, and recovery is not possible. All functionality provided by this element has been lost."Critical Failure"(25) - The element is non-functional and recovery might not be possible."Major Failure"(20) - The element is failing. It is possible that some or all of the functionality of this component is degraded or not working."Minor Failure"(15) - All functionality is available but some might be degraded."Degraded/Warning"(10) - The element is in working order and all functionality is provided. However, the element is not working to the best of its abilities. For example, the element might not be operating at optimal performance or it might be reporting recoverable errors."OK"(5) - The element is fully functional and is operating within normal operational parameters and without error."Unknown"(0) - The implementation cannot report on HealthState at this time.DMTF has reserved the unused portion of the continuum for additional HealthStates in the future.
LSS string
LSS
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..
Operational status.
PoolID string
Max Length256
A unique name in the context of the System that identifies this pool. Same as InstanceID.
Primordial boolean
By definition, Primordial is false
RankGroup uint16
The RankGroup that this ExtentPool is assigned to. Valid values are 0 and 1.
RemainingManagedSpace uint64
The remaining amount of raw storage (in bytes) from the TotalManagedSpace of this StoragePool. This represents the amount of space not allocated to any Volumes.
TotalManagedSpace uint64
The total amount of raw storage (in bytes) managed by this StoragePool.
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
LowSpaceWarningThreshold, PoolID, Primordial, RemainingManagedSpace, TotalManagedSpace
 

Method Summary

NameDescription
GetSupportedSizeRangeThis method is to be used to find out what sizes of volumes of types Block512 or 3390.
GetSupportedSizesThis method is to be used to find out what sizes of volumes of types Block520Protected, Block520Unprotected, or 3380.
 
Inherited from class CIM_StoragePool
GetAvailableExtents, GetSupportedSizeRange, GetSupportedSizes
 

Method Detail


GetSupportedSizeRange

Description

This method is to be used to find out what sizes of volumes of types Block512 or 3390. Additionally is used to find out the sizes of the VirtualPool that can be created from a ExtentPool.The supported size ranges are:Block512: 512 bytes to 2199023255552(512 * 2^32)bytes, in multiples of 512.3390: 849960 bytes (1 cylinder ) to 223,257,293,280 bytes (262,668 cylinders).in multiples of 849960 bytes (1 cylinder)VirtualPool: 17179869184 for both FB and CKD to Remaining unallocated space in the extentPool.

Parameters

IdTypeRangeDescription
In
ElementType uint16
The type of element for which supported sizes are reported for. Only Storage Volume and Storage Pool are supported.When the input value for'ElementType'is 2, any input value for'Goal'will be ignored.
Goal IBMTSDS_DataTypeSetting
The StorageSetting for which supported sizes should be reported for. This should be an IBMTSDS_DataTypeSetting instance representing Block512 or 3390. Default values are Block512 or 3390 depending on the type of extentpool.
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.512 for FB Block512, 849960 for CKD 3390.This value is no meaning while creating virtual pool from this extent pool
Return Codes
none

GetSupportedSizes

Description

This method is to be used to find out what sizes of volumes of types Block520Protected, Block520Unprotected, or 3380. The supported sizes are:Block520Protected and Block520Unprotected: 8589934592, 17548967936, 35165044736,70564970496 , 141129940992 , or 282259881984 bytes3380: 1585223640 bytes (2226 cylinders) or 2377835460 bytes(3339 cylinders)

Parameters

IdTypeRangeDescription
In
ElementType uint16
The type of element for which supported sizes are reported for. Only Storage Volume is supported.
Goal IBMTSDS_DataTypeSetting
The StorageSetting for which supported sizes should be reported for. This should be an IBMTSDS_DataTypeSetting instance representing Block520Protected, Block520Unprotected, or 3380. Default values are Block520Protected or 3380 depending on the type of extentpool.
out
Sizes uint64
List of supported sizes for a Volume/Pool creation or modification.
Return Codes
none