HP 3PAR CIM API Programming Reference (QL226-97722, March 2014)

• ReplicationGroup: A reference to an existing replication group.
• ServiceAccessPoint: NULL, which means the group is on the local system.
CreateElementReplica
uint32 ReplicationService.CreateElementReplica(
[IN] string ElementName,
[IN, Required] uint16 SyncType,
[IN] uint16 Mode,
[IN, Required] CIM_LogicalElement REF SourceElement,
[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 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.
Replication Services Profile 109