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

Table 93 Parameter Matrix for CreateElementReplica (continued)
If non-NULL, then only
'Synchronized' is supported
Optional (onlyvalid option is
Inactive) – the clone will retain
association with the parent
Optional (only valid option is
Synchronized) – independent
clone will be created that
detaches automatically
WaitForCopyState:
NYYOutput Job?
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,
[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 us this is always NULL.
• TargetAccessPoint: NULL
Replication Services Profile 109