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

CreateGroupReplica
uint32 ReplicationService.CreateGroupReplica(
[IN] string RelationshipName,
[IN, Required] uint16 SyncType,
[IN] uint16 Mode,
[IN] SNIA_ReplicationGroup REF SourceGroup,
[IN] CIM_LogicalElement REF SourceElement,
[IN] CIM_ServiceAccessPoint REF SourceAccessPoint,
[IN, OUT] SNIA_ReplicationGroup REF TargetGroup,
[IN] uint64 TargetElementCount,
[IN] CIM_ServiceAccessPoint REF TargetAccessPoint,
[IN] uint16 Consistency,
[IN, EmbeddedInstance("SNIA_ReplicationSettingData")]
string ReplicationSettingData,
[OUT] CIM_ConcreteJob REF Job,
[OUT] CIM_Synchronized REF Synchronization,
[OUT] CIM_Synchronized REF Synchronizations [ ],
[IN] CIM_SettingData REF TargetSettingGoal,
[IN] CIM_ResourcePool REF TargetPool,
[IN] uint16 WaitForCopyState);
Use to create (or start a job to create) a new group of storage objects which are replicas of the
specified source storage or a group of source storage objects (SourceElements), i.e., replications
of vv sets. Parameters are:
• RelationshipName: A mandatory user relevant name for the relationship between the source
and target groups or between a source element and a target group (i.e. one-to-many). For
SV, each of the name of the individual target volumes (ElementName) would be constructed
using RelationshipName as prefix followed by \"_n\" sequence number, where n is a number
beginning with 1.
• SyncType
• Mode
• SourceGroup: A group of source storage objects which may be of TPD_ReplicationGroup or
TPD_RemoteReplicationGroup, the latter applicable only for Snapshot SyncType and
Synchronous Mode.
• SourceElement: This is not supported and should be NULL.
• SourceAccessPoint: NULL
• TargetGroup:
As an input, refers to a target group to use.◦
◦ As an output, refers to the created target group (i.e., the replica group). If a job is created,
the target group may not be available immediately. If TargetGroup is supplied,
TargetElementCount shall be NULL.
• TargetElementCount: This parameter applies to one-source-to-many-target elements. If
TargetGroup is supplied, this parameter shall be NULL. For HP, this is always NULL.
• TargetAccessPoint: NULL
• Consistency: This parameter overrides the default group consistency. For example, "No
Consistency", "Sequential Consistency". For HP, this can only be "Sequential Consistency".
• ReplicationSettingData: NULL
• Job: For physical copy of vv sets, HP 3PAR OS actually spawns one task for each of the vv
pair in the set 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.
114 CIM API SMI-S Support