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

Table 97 Parameter Matrix for CreateGroupReplica (continued)
will be created that
detach automatically
CreateGroupReplicaFromElements
uint32 ReplicationService.CreateGroupReplicaFromElements(
[IN] string RelationshipName,
[IN, Required] uint16 SyncType,
[IN] uint16 Mode,
[IN, OUT] CIM_ReplicationGroup REF SourceGroup,
[IN] CIM_LogicalElement REF SourceElements[],
[IN, OUT] string SourceGroupName,
[IN] CIM_ServiceAccessPoint REF SourceAccessPoint,
[IN, OUT] SNIA_ReplicationGroup REF TargetGroup,
[IN] CIM_ServiceAccessPoint REF TargetAccessPoint,
[IN] uint16 Consistency,
[IN, EmbeddedInstance("CIM_ReplicationSettingData")]
string ReplicationSettingData,
[OUT] CIM_ConcreteJob REF Job,
[OUT] CIM_ConcreteJob REF Jobs[],
[OUT] CIM_Synchronized REF Synchronization,
[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) a new group of storage objects which
are replicas of the specified source storage objects (SourceElements), i.e., replications of virtual
volumes. This method combines the functionality of CreateGroup and CreateGroupReplica in that
the method accepts a list of source volumes and creates the source group (i.e. vvset), and the target
group, if not supplied.
CreateGroupReplicaFromElements will create both the source and the target vvset groups (for
snapshot copies) if they are not provided.
The parameters are as follows:
• RelationshipName: A mandatory user relevent 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:
As an input, refers to a group of source storage objects which may be of
TPD_ReplicationGroup or TPD_RemoteReplicationGroup, the latter applicable only for
◦
SyncType of Snapshot and Mode of Synchronous. Must be specified if SourceElements
is not specified.
◦ As a output, refers to the group containing the source storage objects. If neither
SourceGroup or SourceGroupName was specified as an input parameter, a name will
be assigned.
• SourceGroupName: the vvset name to create and assign to the SourceElements.
• SourceElements[ ]: Must be specified if SourceGroup is not. A list of StorageVolumes from
which to create a group replica of SyncType clone or snapshot.
116 CIM API SMI-S Support