HP 3PAR InForm OS 3.1.1 CIM API (QL226-96591, July 2012)
[IN] CIM_ServiceAccessPoint REF SourceAccessPoint,
[IN, OUT] CIM_LogicalElement REF TargetElement,
[IN] CIM_ServiceAccessPoint REF TargetAccessPoint,
[IN, EmbeddedInstance("SNIA_ReplicationSettingData")]
string ReplicationSettingData,
[OUT] CIM_ConcreteJob REF Job,
[OUT] CIM_Synchronized REF Synchronization,
[IN] CIM_SettingData REF TargetSettingGoal,
[IN] CIM_ResourcePool REF TargetPool,
[IN] uint16 WaitForCopyState);
Use to create (or start a job to create) a new storage object which is a replica of the specified
source storage object (SourceElement). Parameters are:
• ElementName: For virtual copy, this is the end user relevant name for the element being created.
The value will be stored in the 'ElementName' property for the created element. This is NULL
for physical copy.
• SyncType: Describes the type of copy that will be made. For example, Mirror, Snapshot, and
Clone.
• Mode: Describes whether the target elements will be updated synchronously or asynchronously.
• SourceElement: The source storage object which may be a StorageVolume
• SourceAccessPoint: NULL
• TargetElement:
As an input, refers to a target element to use for a physical copy. This is NULL for virtual
copy.
◦
◦ 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).
• TargetPool: The underlying storage for the target element (the replica) will be drawn from
TargetPool if specified, otherwise the allocation is implementation specific. This is valid only
for snapshot volumes, and if specified, this must be the DeltaReplicaStoragePool that is
associated with the source StorageVolume.
• WaitForCopyState: Before returning, the method shall wait until this CopyState is reached.
Table 90 Parameter Matrix for CreateElementReplica
Virtual copy (snapshot volume)Physical copyWhat to Create:
SnapshotCloneSync Type:
Optional (default is SynchronousOptional (default is Synchronous)Mode:
Replication Services Profile 99