3PAR CIM API Programming Reference for InForm OS 2.3.1 (320-200164 Rev B, February 2010)

5.70
Copy Services Subprofile
CIM API Programming Reference InForm OS Version 2.3.1
pool. Space used by SA is not included in TotalManagedSpace, but is included in the
TPD_AllocatedFromStoragePool.SpaceConsumed value, so to deduce the raw SA space,
one can deduct
Pool.TotalManagedSpace from SpaceConsumed. The
UpdateDeltaSnapshotSpace() method should be called to prevent the value of
RemainingManagedSpace from getting too stale
Pool.TotalManagedSpace = raw SD size
Pool.RemainingManagedSpace = raw SD size – SUM(space used by snapshots)
SpaceConsumed of the TPD_AllocatedFromStoragePool between the parent DSP and
TPD_DeltaReplicaStoragePool equals to the sum of the raw admin and raw snap user
size.
SpaceConsumed by Replica Pool from DSP = raw SD size + raw SA size
SpaceConsumed of the TPD_AllocatedFromStoragePool between
TPD_DeltaReplicaStoragePool and a snapshot volume equals the space consumed by the
snapshot. This value should be updated via the
UpdateDeltaSnapshotSpace() method to
prevent it from getting too stale.
SpaceConsumed by Snapshot Vol from Replica Pool = space used by a snapshot
5.10.3.3.3 UpdateDeltaSnapshotSpace() Method
It is important to note that calculation of space consumed by a snapshot volume can
potentially be a long process, and it is not updated real-time by sysmgr. One has to issue the
command “
updatesnapspace <snapshot vol name>” from CLI (from which a task is
generated) to start the calculation of SA/SD space used by a snapshot. Hence, when a CIM
client retrieves the
RemainingManagedSpace value for a SA/SD pool or the SpaceConsumed
value for a snapshot volume, it can potentially be stale if
updatesnapspace has not been
done for a while. As a result, a new 3PAR-specific extrinsic method is defined in
TPD_StorageConfigurationService class called UpdateDeltaSnapshotSpace() which
mirrors the CLI
updatesnapspace command.
A client wishing to obtain a more accurate picture of the aforementioned capacity values must
first call this method, monitor the returned job for its completion, then finally get at the
properties.
uint32 UpdateDeltaSnapshotSpace(
[In] TPD_StorageVolume ref SnapshotVolume[],
[Out] TPD_ConcreteJob ref Job);