HP 3PAR CIM API Programming Reference (OS 3.1.2 MU2) (QL226-97015, June 2013)

• TargetElement:
As an input, refers to a target element to use for a physical copy. This is NULL when
creating a snapshot. If this is NULL when creating a clone, the target clone will be created
automatically.
◦
◦ As an output, refers to the created target storage element (i.e., the replica). If a job is
created, the target element may not be available immediately.
• TargetAccessPoint: NULL
• ReplicationSettingData: NULL, as a client cannot modify the replication behavior of a copy
operation
• Job: If a Job is created as a side-effect of the execution of the method, then a reference to that
Job is returned through this parameter (may be NULL if job is completed).
• Synchronization: Refers to the created association between the source and the target element.
If a job is created, this parameter may be NULL, unless the association is actually formed.
• TargetSettingGoal: The definition for the StorageSetting to be maintained by the target storage
object (the replica). This is valid only for snapshot volumes (base ID, expiration timer, retention
timer).
◦ For snapshots only the following properties are applicable: BaseID, ExpirationTimer and
RetentionTimer.
◦ For clones only the following properties are applicable: ThinlyProvisioned, UserDSPName,
SnapDSPName
• TargetPool: The underlying storage for the target element (the replica) will be drawn from
TargetPool if specified, otherwise the allocation is implementation specific.
◦ For snapshots, this parameter if specified must be the DeltaReplicaStoragePool that is
associated with the source StorageVolume.
◦ For clones, this parameter if specified can be any DynamicStoragePool; if not specified,
the clone will be allocated from the same parent DynamicStoragePool as the source
volume
• WaitForCopyState: Before returning, the method shall wait until this CopyState is reached.
Table 93 Parameter Matrix for CreateElementReplica
Virtual copy (snapshot volume)Physical copyWhat to Create:
SnapshotCloneCloneSync Type:
Optional (default is SynchronousAsynchronousSynchronous (default)Mode:
Optional (if NULL, a name will
be auto-generated)
Optional (applicable only if
TargetElement is not supplied; if
Optional (applicable only if
TargetElement is not supplied; if
ElementName:
NULL, a name will be
auto-generated)
NULL, a name will be
auto-generated)
MandatoryMandatoryMandatorySourceElement:
NULLOptional (if NULL, the target
volume will be created)
Optional (if NULL, the target
volume will be created)
TargetElement:
OptionalOptionalOptionalTarget Setting
Pool
OptionalOptional (if NULL, clone will
have the same parent pool as
source volume)
Optional (if NULL, clone will
have the same parent pool as
source volume)
TargetPool
108 CIM API SMI-S Support