NAME

Get-DcsChunkReclamationMap

SYNOPSIS

Returns storage allocation unit (SAU) data for SAUs in reclamation in a disk pool. Data returned can be used to determine the distribution for SAUs in reclamation in a pool.

SYNTAX

Get-DcsChunkReclamationMap [ -Server <String> ] -Pool <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]

DESCRIPTION

Gets the storage allocation unit (SAU) data for SAUs in reclamation in a disk pool. Data returned can be used to determine the distribution for SAUs in reclamation in a pool.

PARAMETERS

-Server<String>: Computer name or ID of the server. The computer name must be unique or the name must be fully qualified.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-Pool<Object>: DiskPoolData object, name, or ID that identifies the disk pool. To resolve by name, the name must be unique to the server group or the server must be specified.; Required: true; Position: named; Default value:; Accept pipeline input: true (ByValue); Accept wildcard characters: false
-Connection<String>: Alias of the connection to the server group. If not specified, the default connection is used.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-PipelineVariable<String>: Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false

INPUTS

DiskPoolData : Object that identifies and describes the pool.

OUTPUTS

DiskAllocationInfoData : Object that associates the location for each SAU in reclamation within the respective physical disks.

NOTES

Also see Get-DcsPool, Get-DcsChunkAllocation, Get-DcsChunkAllocationMap.

EXAMPLES

-------------- Example 1 Returns the reclamation map for a specified disk pool --------------

$ReclaimMap = Get-DcsChunkReclamationMap -Pool "Disk pool 1"
$ReclaimMap
PoolMemberId                                                          ChunkMap
------------                                                          --------
c358e4a6-26e0-4f07-aa9e-e780fff049bb                                  DataCore.Executive.BitArrayEx
4407d9de-8022-40d3-be64-5db8eaf44260                                  DataCore.Executive.BitArrayEx
$ReclaimMap = Get-DcsChunkReclamationMap -Pool "Disk pool 1"
ForEach ($d in $ReclaimMap)
{
Write-Host (Get-DcsPhysicalDisk -PoolMember $d.PoolMemberid).ExtendedCaption
Write-Host
Write-Host "number of Bits in BitMap =" $d.ChunkMap.Count
Write-Host "BitMap:"
Write-Host $d.ChunkMap.BitMap
Write-Host
}

The cmdlet is invoked to obtain the reclamation map for the pool named "Disk pool 1" on the server "SSV1" and is stored in the variable $ReclaimMap. The output for the variable is displayed. Two physical disks are in the pool. The Pool Member ID and Chunk Map are returned for the disks. The PowerShell cmdlet Get-Member can be used to get the properties of the ChunkMap object, which are Bitmap and Count (total number of bits). A script file shows one way to output the ChunkMap data for each disk. The cmdlet Get-DcsPhysicalDisk is used to get the disk name from the PoolMemberId. The variable $ReclaimMap is used to get the total number of bits and the actual bitmap for each disk that has SAUs that are being reclaimed. When reclamation is complete, the BitMap will have no bits set. The bitmap is displayed in a series of bytes in decimal that represent a bitmap of the SAUs in reclamation on a disk. The disk size divided by the SAU size is equal to the number of SAUs or bits.

Disk 5 on SSV1
number of Bits in BitMap = 397
BitMap:
112 255 255 239 255 191 255 255 255 247 255 255 191 187 127 255 239 255 29 180 255 123 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Disk 6 on SSV1
number of Bits in BitMap = 397
BitMap:
248 255 255 255 255 255 255 255 255 255 255 255 255 255 255 255 255 255 21 249 255 127 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0