HP 3PAR CIM API Programming Reference

[IN, Required] CIM_LogicalElement REF SourceElements[],
[IN] CIM_ServiceAccessPoint REF SourceAccessPoint,
[IN, OUT] CIM_LogicalElement REF TargetElements[],
[IN] CIM_ServiceAccessPoint REF TargetAccessPoint,
[IN, EmbeddedInstance("CIM_ReplicationSettingData")]
string ReplicationSettingData,
[OUT] CIM_ConcreteJob REF Job,
[OUT] CIM_ConcreteJob REF Jobs[],
[OUT] CIM_Synchronized REF Synchronizations[],
[IN] CIM_SettingData REF TargetSettingGoal,
[IN] CIM_ResourcePool REF TargetPool,
[IN] uint16 WaitForCopyState);
This method allows a client to create (or start a job to create) new storage objects which are replicas
of the specified source storage objects (SourceElements). The parameters are as follows:
• ElementNames[]: For virtual copy, these are the end user relevant names for the elements being
created. Each value will be stored in the ‘ElementName' property of a created element. The
first element is the array ElementNames is assigned to the first replica created from the first
entry in SourceElements, the second element to the second replica, and so on. Missing or Null
ElementName entries will be supplied by the system.
• SyncType: Describes the type of copy that will be made. For example: Snapshot, or Clone.
• Mode: Describes whether the target elements will be updated synchronously or asynchronously.
• SourceElements[]: An array of references to source storage objects, such as StorageVolumes.
All the source elements must be of the same type.
• SourceAccessPoint: NULL
• TargetElements[]:
As an input, refers to the target elements 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. If specified, the elements must match 1-to-1 with each entry in
SourceElements.
◦ 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). For physical copy,
HP 3PAR OS actually spawns one task for each of the vv pair and not one task for the whole
set. However, this job parameter can only contain reference to one job, so as a compromise,
only the job of the first vv pair copy will be returned.
• Jobs[]: 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). For physical
copy, HP 3PAR OS actually spawns one job for each of the vv pairs and not one job for the
whole set. The jobs parameter contains an array of references to each job.
• Synchronizations: A list that refers to the created associations between the source and the
target elements. If jobs are created, this parameter may be NULL, unless the associations are
actually formed.
110 CIM API SMI-S Support