Class CIM_ReplicationService
extends CIM_Service

The ReplicationService class provides methods to allow a client to manage copy operations on storage objects, including management of replication groups, manipulation of replication operations, and retrieval of replication relationships.

Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods


Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_ManagedSystemElement
   |
   +--CIM_LogicalElement
   |
   +--CIM_EnabledLogicalElement
   |
   +--CIM_Service
   |
   +--CIM_ReplicationService

Direct Known Subclasses

Class Qualifiers

NameData TypeValue
DescriptionstringThe ReplicationService class provides methods to allow a client to manage copy operations on storage objects, including management of replication groups, manipulation of replication operations, and retrieval of replication relationships.
UMLPackagePathstringCIM::Device::StorageServices
Versionstring2.49.0

Class Properties

Inherited Properties

NameData TypeClass Origin
CaptionstringCIM_ManagedElement
CommunicationStatusuint16CIM_ManagedSystemElement
CreationClassNamestringCIM_Service
DescriptionstringCIM_ManagedElement
DetailedStatusuint16CIM_ManagedSystemElement
ElementNamestringCIM_ManagedElement
EnabledDefaultuint16CIM_EnabledLogicalElement
EnabledStateuint16CIM_EnabledLogicalElement
Generationuint64CIM_ManagedElement
HealthStateuint16CIM_ManagedSystemElement
InstallDatedatetimeCIM_ManagedSystemElement
InstanceIDstringCIM_ManagedElement
LoSIDstringCIM_Service
LoSOrgIDstringCIM_Service
NamestringCIM_Service
OperatingStatusuint16CIM_ManagedSystemElement
OtherEnabledStatestringCIM_EnabledLogicalElement
PrimaryOwnerContactstringCIM_Service
PrimaryOwnerNamestringCIM_Service
PrimaryStatusuint16CIM_ManagedSystemElement
RequestedStateuint16CIM_EnabledLogicalElement
StartedbooleanCIM_Service
StartModestringCIM_Service
StatusstringCIM_ManagedSystemElement
SystemCreationClassNamestringCIM_Service
SystemNamestringCIM_Service
TimeOfLastStateChangedatetimeCIM_EnabledLogicalElement
TransitioningToStateuint16CIM_EnabledLogicalElement
AvailableRequestedStatesuint16[]CIM_EnabledLogicalElement
OperationalStatusuint16[]CIM_ManagedSystemElement
StatusDescriptionsstring[]CIM_ManagedSystemElement

Class Methods

Local Class Methods

CreateGroup (uint32)

Method Qualifiers (CreateGroup)

NameData TypeValue
DescriptionstringCreate a new replication group.
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, .., 0x8000..
ValuesstringSuccess, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, Groups are not nameable, DMTF Reserved, Vendor Specific

Method Parameters (CreateGroup)

NameTypeQualifiers
NameData TypeValue
DeleteOnEmptyElementboolean
DescriptionstringIf true and empty groups are allowed, the group will be deleted when the last element is removed from the group. If empty groups are not allowed, the group will be deleted automatically when the group becomes empty. If this parameter is not NULL, its value will be used to set the group's DeleteOnEmptyElement property. Use the intrinsic method ModifyInstance to change this property after the group is created.
DeleteOnUnassociatedboolean
DescriptionstringIf true, the group will be deleted when the group is no longer associated with another group. This can happen if all synchronization associations to the individual elements of the group are dissolved. If this parameter is not NULL, its value will be used to set the group's DeleteOnUnassociated property. Use the intrinsic method ModifyInstance to change this property after the group is created.
GroupNamestring
DescriptionstringIf nameable, an end user relevant name for the group being created. If NULL or not nameable, then system assigns a name.
Persistentboolean
DescriptionstringIf false, the group, not the elements associated with the group, may be deleted at the completion of a copy operation. Use the intrinsic method ModifyInstance to change Persistency of a group.
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings for the method. For example, to supply the "Description" for the created group.
EmbeddedInstancestringCIM_ReplicationSettingData
ReservedAsuint16
DescriptionstringThe created group is reserved to be the source or the target of a copy operation. If not supplied, the group can be either the source or the target (4).
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSource Only, Target Only, Source or Target, DMTF Reserved, Vendor Specific
MembersCIM_LogicalElement[]
DescriptionstringList of elements to add to the group -- order is maintained. If NULL, the group will be empty -- if empty groups are supported.
ReplicationGroup REF CIM_ReplicationGroup
DescriptionstringReference to the created group.
INbooleanfalse
OUTbooleantrue
ServiceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to access point information to allow the service to create a group on a remote system. If NULL, the group is created on the local system.

DeleteGroup (uint32)

Method Qualifiers (DeleteGroup)

NameData TypeValue
DescriptionstringDelete a replication group.
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, .., 0x8000..
ValuesstringSuccess, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, One or more elements in a replication relationship, DMTF Reserved, Vendor Specific

Method Parameters (DeleteGroup)

NameTypeQualifiers
NameData TypeValue
RemoveElementsboolean
DescriptionstringDelete the group even if it is not empty. If one or more elements in the group are in a replication relationship, RemoveElements has no effect.
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings for the method. For example, what should happen OnGroupOrListError.
EmbeddedInstancestringCIM_ReplicationSettingData
ReplicationGroup REF CIM_ReplicationGroup
DescriptionstringReference to a replication group.
Requiredbooleantrue
ServiceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to access point information to allow the service to delete the group on a remote system.

AddMembers (uint32)

Method Qualifiers (AddMembers)

NameData TypeValue
DescriptionstringAdd members to an existing replication group.
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, .., 0x8000..
ValuesstringSuccess, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, Group does not exist, DMTF Reserved, Vendor Specific

Method Parameters (AddMembers)

NameTypeQualifiers
NameData TypeValue
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings for the method. For example, what should happen OnGroupOrListError.
EmbeddedInstancestringCIM_ReplicationSettingData
MembersCIM_LogicalElement[]
DescriptionstringList of elements to add to the group. New members are added, in the order supplied, to the end of the existing members of the group. It is not an error, if a new member is already in the group.
ReplicationGroup REF CIM_ReplicationGroup
DescriptionstringReference to an existing replication group.
Requiredbooleantrue
ServiceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to access point information to allow the service to access the group on a remote system.

RemoveMembers (uint32)

Method Qualifiers (RemoveMembers)

NameData TypeValue
DescriptionstringRemove members from a replication group.
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, 8, .., 0x8000..
ValuesstringSuccess, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, Group does not exist, Member not in group, DMTF Reserved, Vendor Specific

Method Parameters (RemoveMembers)

NameTypeQualifiers
NameData TypeValue
DeleteOnEmptyElementboolean
DescriptionstringIf true and removal of the members causes the group to become empty, the group will be deleted. Note, if empty groups are not allowed, the group will be deleted automatically when the group becomes empty. If this parameter is not NULL, it overrides the group's property DeleteOnEmptyElement.
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings for the method. For example, what should happen OnGroupOrListError.
EmbeddedInstancestringCIM_ReplicationSettingData
MembersCIM_LogicalElement[]
DescriptionstringList of elements to remove from a group. A member can not be removed if it is in a replication relationship. Deleting all members of a group is equivalent to deleting the group if empty groups are not supported by the implementation.
ReplicationGroup REF CIM_ReplicationGroup
DescriptionstringReference to an existing replication group.
Requiredbooleantrue
ServiceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to access point information to allow the service to access the group on a remote system.

CreateElementReplica (uint32)

Method Qualifiers (CreateElementReplica)

NameData TypeValue
DescriptionstringCreate (or start a job to create) a new storage object, which is a replica of the specified source storage object (SourceElement). Note that using the input parameter, SyncType, this function can be used to instantiate the replica, and to create an ongoing association between the source and replica. If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateElementReplica)

NameTypeQualifiers
NameData TypeValue
ElementNamestring
DescriptionstringA end user relevant name for the element being created. If NULL, then a system supplied default name can be used. The value will be stored in the 'ElementName' property for the created element.
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringSyncType describes the type of copy that will be made.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress.
ModelCorrespondencestringCIM_Synchronized.CopyState
CollectionsCIM_Collection[]
DescriptionstringThe target elements are added to each referenced collection, for example, DeviceMaskingGroups.
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringReference to the ConnectivityCollection - for example, a RemoteReplicationCollection. Since a RemoteReplicationCollection aggregates the ProtocolEndpoints that provide the paths to a remote system, generally, it is not necessary to supply both the ConnectivityCollection and the ServiceAccessPoint.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source element.
SourceElement REF CIM_LogicalElement
DescriptionstringThe source storage object which may be a StorageVolume or other storage objects.
Requiredbooleantrue
Synchronization REF CIM_Synchronized
DescriptionstringReference 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.
INbooleanfalse
OUTbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target elements.
TargetElement REF CIM_LogicalElement
DescriptionstringOptionally, as an input, refers to a target element to use. 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.
OUTbooleantrue
TargetPool REF CIM_ResourcePool
DescriptionstringThe underlying storage for the target element (the replica) will be drawn from TargetPool if specified, otherwise the allocation is implementation specific. If a target element is supplied, this parameter shall be NULL.
TargetSettingGoal REF CIM_SettingData
DescriptionstringThe definition for the SettingData to be maintained by the target storage object (the replica). If a target element is supplied, this parameter shall be NULL.

CreateGroupReplica (uint32)

Method Qualifiers (CreateGroupReplica)

NameData TypeValue
DescriptionstringCreate (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). Note that using the input parameter, SyncType, this function can be used to instantiate the replicas, and to create an ongoing association between the source(s) and replicas. If 0 is returned, the function completed successfully and no ConcreteJob instance is created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateGroupReplica)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringOverrides the default group consistency.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
RelationshipNamestring
DescriptionstringA 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). If NULL, the implementation assigns a name. If the individual target elements require an ElementName, the implementation constructs an appropriate ElementName using the RelationshipName. For example, RelationshipName as a prefix followed by "_n" sequence number, where n is a number beginning with 1.
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringSyncType describes the type of copy that will be made.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
TargetElementCountuint64
DescriptionstringThis parameter applies to one-source-to-many-target- elements. It is possible to create multiple copies of a source element. If TargetGroup is supplied, this parameter shall be NULL.
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress.
ModelCorrespondencestringCIM_Synchronized.CopyState
CollectionsCIM_Collection[]
DescriptionstringThe target elements are added to each referenced collection, for example, DeviceMaskingGroups.
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringReference to the ConnectivityCollection - for example, a RemoteReplicationCollection. Since a RemoteReplicationCollection aggregates the ProtocolEndpoints that provide the paths to a remote system, generally, it is not necessary to supply both the ConnectivityCollection and the ServiceAccessPoint.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source element.
SourceElement REF CIM_LogicalElement
DescriptionstringThe source storage object which may be a StorageVolume or other storage objects. If this parameter is not supplied, SourceGroup is required. Both SourceGroup and SourceElement shall not be supplied.
SourceGroup REF CIM_ReplicationGroup
DescriptionstringA group of source storage objects which may be one or more StorageVolumes or other storage objects. If this parameter is not supplied, SourceElement is required. Both SourceGroup and SourceElement shall not be supplied.
Synchronization REF CIM_Synchronized
DescriptionstringReference to the created group association between the source and the target elements. If a job is created, this parameter may be NULL until the association is actually formed.
INbooleanfalse
OUTbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target element/group.
TargetGroup REF CIM_ReplicationGroup
DescriptionstringOptionally, 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.
OUTbooleantrue
TargetPool REF CIM_ResourcePool
DescriptionstringThe underlying storage for the target elements (the replicas) will be drawn from TargetPool if specified, otherwise the allocation is implementation specific. If target elements are supplied, this parameter shall be NULL.
TargetSettingGoal REF CIM_SettingData
DescriptionstringThe definition for the SettingData to be maintained by the target storage objects (the replicas). If target elements are supplied, this parameter shall be NULL.

CreateSynchronizationAspect (uint32)

Method Qualifiers (CreateSynchronizationAspect)

NameData TypeValue
DescriptionstringCreate (or start a job to create) a new point-in-time representation of a source element. This representation may be of a form of pointers that keep track of data at the time the point-in-time was created, or a series checkpoints that capture the view of data on the source elements at the time of point-in-time. This method does not include a target element, however, a target element can be added subsequently using the ModifySettingsDefineState method. If the method executes successfully, a SettingsDefineState association is created between the source element and the SynchronizationAspect, which will have the datetime of the point-in-time.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateSynchronizationAspect)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringOverrides the default group consistency.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
Namestring
DescriptionstringA end user relevant name for the element or relationship being created. If NULL, then a system supplied default name can be used. The value will be stored in the ElementName or relationship name depending on whether an element is created or a group.
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringSyncType describes the type of copy that will be made.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SettingsState REF CIM_SettingsDefineState
DescriptionstringReference to the created association between the source element or group and an instance of SynchronizationAspect. If a job is created, this parameter may be NULL unless the association is actually formed.
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source element/group.
SourceElement REF CIM_ManagedElement
DescriptionstringThe source storage object which may be a StorageVolume or other storage objects. If this parameter is not supplied, SourceGroup is required. Both SourceGroup and SourceElement shall not be supplied.
SourceGroup REF CIM_ReplicationGroup
DescriptionstringA group of source storage objects which may be one or more StorageVolumes or other storage objects. If this parameter is not supplied, SourceElement is required. Both SourceGroup and SourceElement shall not be supplied.

ModifyReplicaSynchronization (uint32)

Method Qualifiers (ModifyReplicaSynchronization)

NameData TypeValue
DescriptionstringModify (or start a job to modify) the synchronization association between two storage objects or replication groups. If 0 is returned, the function completed successfully and no ConcreteJob instance was created. If 0x1000 is returned, a ConcreteJob was started and a reference to this Job is returned in the Job output parameter. A return value of 1 indicates the method is not supported. All other values indicate some type of error condition.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (ModifyReplicaSynchronization)

NameTypeQualifiers
NameData TypeValue
Forceboolean
DescriptionstringSome operations may cause an inconsistency among the target elements. If true, the client is not warned and the operation is performed.
Operationuint16
DescriptionstringOperation describes the type of modification to be made to the replica and/or to the related associations. Abort: Abort the copy operation if it is possible. Activate Consistency: if consistency was not requested when CreateGroupReplica was called. If Consistency is already active, no modification is made. Activate: Activate an inactive or prepared Synchronized association. AddSyncPair: Add pairs of elements already in a relationship to source and target groups -- see SyncPair parameter. Deactivate Consistency: Deactivate consistency. If consistency was not enabled, this operation has no effect. Deactivate: Stop the data flow. Writes to source element are not copied to target. For Snapshots, writes to target are lost as the pointers to changed data are deleted. Detach: 'Forget' the synchronization between two storage objects. Start to treat the objects as independent. Dissolve: Dissolve the synchronization between two storage objects, however, the target element continues to exist. Failover: Use the target element as the source elements. Failback: Reverse the effect of failback. Fracture: Suspend the synchronization between two storage objects. The association and (typically) changes are remembered to allow a fast resynchronization. This may be used during a backup cycle to allow one of the objects to be copied while the other remains in production. RemoveSyncPair: Remove the pair associated via StorageSynchronized from the source and target groups. The pair continue to remain associated but not in the groups. Resync Replica: Re-establish the synchronization. This will negate the action of a previous Fracture/Split operation. Recreate a Point In Time image for a Snapshot or a Clone replication. Restart a Broken or Aborted synchronization relationship. Restore from Replica: Renew the contents of the original storage object from a replica. Resume: Continue the copy operation of a suspended association. Reset To Sync: Change the Mode of the copy operation to Synchronous (e.g., from the Asynchronous Mode). Reset To Async: Change the Mode of the copy operation to Asynchronous (e.g., from the Synchronous Mode). Return to ResourcePool: Dissolve a snapshot and free up its space back to the storage pool. Reverse Roles: Source element becomes the target element and vise versa. Split: Same as Fracture, however steps are taken to ensure the target elements are consistent. For example, stop I/O to source elements, wait for in-transit copy operations between source and target elements to stop, then instantly split source/target groups/elements. Suspend: Stop the background copy previously started. Unprepare: note, this operation has been deprecated. Use "Prepare" instead. Prepare: Causes the synchronization to be reinitialized. Reset To Adaptive: Change the Mode of the copy operation to Adaptive. Reset to Active: Change the Mode of the copy operation to Active. Reset Replica: Causes replica to go back to its original point-in-time.
Requiredbooleantrue
ValueMapstring2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, .., 0x8000..0xFFFF
ValuesstringAbort, Activate Consistency, Activate, AddSyncPair, Deactivate Consistency, Deactivate, Detach, Dissolve, Failover, Failback, Fracture, RemoveSyncPair, Resync Replica, Restore from Replica, Resume, Reset To Sync, Reset To Async, Return To ResourcePool, Reverse Roles, Split, Suspend, Unprepare, Prepare, Reset to Adaptive, Reset to Active, Reset Replica, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress. Fractured/Split: Target elements are separated from the source elements. Etc.
ModelCorrespondencestringCIM_Synchronized.CopyState
SyncPairCIM_Synchronized[]
DescriptionstringThis parameter applies to AddSyncPair/RemoveSyncPair Operations.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue
SettingsState REF CIM_SettingsDefineState
DescriptionstringReference to the association between the source element and an instance of SynchronizationAspect. This parameters applies to operations such as Dissolve, which dissolves the Synchronized relationship, but causes the SettingDefineState association to be created.
INbooleanfalse
OUTbooleantrue
Synchronization REF CIM_Synchronized
DescriptionstringThe reference to the replication association describing the elements/groups relationship.
Requiredbooleantrue
UpdatedSynchronization REF CIM_Synchronized
DescriptionstringIf the operation updates the keys of the supplied Synchronization parameter, a reference to the updated Synchronization parameter is returned in this parameter.
INbooleanfalse
OUTbooleantrue

ModifyListSynchronization (uint32)

Method Qualifiers (ModifyListSynchronization)

NameData TypeValue
DescriptionstringModify (or start a job to modify) an array of synchronization associations between two storage objects or replication groups. If 0 is returned, the function completed successfully and no ConcreteJob instance was created. If 4096 is returned, a ConcreteJob was started and a reference to this Job is returned in the Job output parameter. A return value of 1 indicates the method is not supported. All other values indicate some type of error condition.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (ModifyListSynchronization)

NameTypeQualifiers
NameData TypeValue
Forceboolean
DescriptionstringSome operations may cause an inconsistency among the target elements. If true, the client is not warned and the operation is performed.
Operationuint16
DescriptionstringOperation describes the type of modification to be made to the replica and/or to the related associations. Abort: Abort the copy operation if it is possible. Activate: Activate an inactive or prepared Synchronized association. Deactivate: Stop the data flow. Writes to source element are not copied to target. For Snapshots, writes to target are lost as the pointers to changed data are deleted. Detach: 'Forget' the synchronization between two storage objects. Start to treat the objects as independent. Dissolve: Dissolve the synchronization between two storage objects, however, the target element continues to exist. Failover: Use the target element as the source elements. Failback: Reverse the effect of failback. Fracture: Suspend the synchronization between two storage objects using Mirror or Snapshot replication. The association and (typically) changes are remembered to allow a fast resynchronization. This may be used during a backup cycle to allow one of the objects to be copied while the other remains in production. Resync Replica: Re-establish the synchronization. This will negate the action of a previous Fracture/Split operation. Recreate a Point In Time image for a Snapshot or a Clone replication. Restart a Broken or Aborted synchronization relationship. Restore from Replica: Renew the contents of the original storage object from a replica. Resume: Continue the copy operation of a suspended association. Reset To Sync: Change the Mode of the copy operations to Synchronous (e.g., from the Asynchronous Mode). Reset To Async: Change the Mode of the copy operations to Asynchronous (e.g., from the Synchronous Mode). Return to ResourcePool: Dissolve a snapshot and free up its space back to the storage pool. Reverse Roles: Source element becomes the target element and vise versa. Split: Same as Fracture, however steps are taken to ensure the target elements are consistent. For example, stop I/O to source elements, wait for in-transit copy operations between source and target elements to stop, then instantly split source/target groups/elements. Suspend: Stop the background copy previously started. Unprepare: note, this operation has been deprecated. Use "Prepare" instead. Prepare: Causes the synchronization to be reinitialized. Reset To Adaptive: Change the Mode of the copy operation to Adaptive. Reset to Active: Change the Mode of the copy operation to Active. Reset Replica: Causes replica to go back to its original point-in-time.
Requiredbooleantrue
ValueMapstring2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, .., 0x8000..0xFFFF
ValuesstringAbort, DMTF Reserved, Activate, DMTF Reserved, DMTF Reserved, Deactivate, Detach, Dissolve, Failover, Failback, Fracture, DMTF Reserved, Resync Replica, Restore from Replica, Resume, Reset To Sync, Reset To Async, Return To ResourcePool, Reverse Roles, Split, Suspend, Unprepare, Prepare, Reset to Adaptive, Reset to Active, Reset Replica, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress. Fractured/Split: Target elements are separated from the source elements. Etc.
ModelCorrespondencestringCIM_Synchronized.CopyState
SettingsStateCIM_SettingsDefineState[]
DescriptionstringReferences to the associations between the source element and an instance of SynchronizationAspect. This parameters applies to operations such as Dissolve, which dissolves the Synchronized relationship, but causes the SettingDefineState association to be created..
INbooleanfalse
OUTbooleantrue
SynchronizationCIM_Synchronized[]
DescriptionstringArray of replication associations describing the elements/groups relationship. All elements of this array shall be the same concrete class, i.e. StorageSynchronized or GroupSynchronized, and shall have the same SyncType, the same Mode, and the Operation must be valid for the ReplicationType -- SyncType, Mode, Local/Remote.
Requiredbooleantrue
UpdatedSynchronizationsCIM_Synchronized[]
DescriptionstringIf the operation updates the keys of the supplied synchronizations in the Synchronization parameter, references to the updated synchronizations are returned in this parameter.
INbooleanfalse
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue

ModifySettingsDefineState (uint32)

Method Qualifiers (ModifySettingsDefineState)

NameData TypeValue
DescriptionstringModify (or start a job to modify) the SettingsDefineState association between the storage objects and SynchronizationAspect. The modification could range from introducing the target elements, which creates a new StorageSynchronized association to dissolving the SettingsDefineState association. If 0 is returned, the function completed successfully and no ConcreteJob instance was created. If 4096/0x1000 is returned, a ConcreteJob was started and a reference to this Job is returned in the Job output parameter. A return value of 1 indicates the method is not supported. All other values indicate some type of error condition.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (ModifySettingsDefineState)

NameTypeQualifiers
NameData TypeValue
ElementNamestring
DescriptionstringA end user relevant name for the element being created. If NULL, then a system supplied default name can be used. The value will be stored in the 'ElementName' property for the created element.
Operationuint16
DescriptionstringOperation describes the type of modification to be made to the related associations. Activate Consistency: if consistency was not requested when CreateSynchronizationAspect was called. If Consistency is already active, no modification is made. Deactivate Consistency: Deactivate consistency. If consistency was not enabled, this operation has no effect. Delete: Remove the SettingsDefineState association and the associated SynchronizationAspect. Copy To Target: Introduces the target elements and forms the necessary associations between the source and the target elements i.e. StorageSynchronized and GroupSynchronized. Detach: Removes the association between the SynchronizationAspect and the target element. Restore: Restore the source element from the associated SynchronizationAspect. Attach To Target: Same as Copy To Target except no data is copied.
Requiredbooleantrue
ValueMapstring2, 3, 4, 5, 6, 7, 8, .., 0x8000..0xFFFF
ValuesstringActivate Consistency, Deactivate Consistency, Delete, Copy To Target, Detach, Restore, Attach To Target, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
TargetElementCountuint64
DescriptionstringThis parameter applies to one-source-to-many-target- elements. It is possible to create multiple copies of a source element. If TargetCount is supplied, TargetElement and TargetGroup shall be NULL.
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress. Fractured/Split: Target elements are separated from the source elements. Etc.
ModelCorrespondencestringCIM_Synchronized.CopyState
CollectionsCIM_Collection[]
DescriptionstringThe target elements are added to each referenced collection, for example, DeviceMaskingGroups.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue
SettingsState REF CIM_SettingsDefineState
DescriptionstringReference to the association between the source element and an instance of SynchronizationAspect.
Requiredbooleantrue
Synchronization REF CIM_Synchronized
DescriptionstringThe reference to the created replication association describing the elements/groups relationship.
INbooleanfalse
OUTbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target elements/group.
TargetElement REF CIM_LogicalElement
DescriptionstringOptionally, as an input, refers to a target element to use. If TargetElement is supplied, TargetGroup and TargetCount shall be NULL. 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.
OUTbooleantrue
TargetGroup REF CIM_ReplicationGroup
DescriptionstringOptionally, as an input, refers to a target group to use. If TargetGroup is supplied, TargetElement and TargetCount shall be NULL. 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.
OUTbooleantrue
TargetPool REF CIM_ResourcePool
DescriptionstringThe underlying storage for the target element (the replica) will be drawn from TargetPool if specified, otherwise the allocation is implementation specific. If a target element is supplied, this parameter shall be NULL.
TargetSettingGoal REF CIM_SettingData
DescriptionstringThe definition for the SettingData to be maintained by the target storage object (the replica). If a target element is supplied, this parameter shall be NULL.

GetAvailableTargetElements (uint32)

Method Qualifiers (GetAvailableTargetElements)

NameData TypeValue
DescriptionstringGet (or start a job to get) all of the candidate target elements for the supplied source element. If a job is started, once the job completes, examine the AffectedJobElement associations for candidate targets.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetAvailableTargetElements)

NameTypeQualifiers
NameData TypeValue
MaxElementCountuint16
DescriptionstringSpecifies the maximum number of elements to be returned by the method.
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringSyncType describes the type of copy.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
CandidatesCIM_LogicalElement[]
DescriptionstringThe list of the candidate target elements.
OUTbooleantrue
TargetPoolsCIM_ResourcePool[]
DescriptionstringThe storage pools for the target elements. If NULL, all storage pools (on the given system) will be examined.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue
SourceElement REF CIM_LogicalElement
DescriptionstringThe source storage object which may be a StorageVolume or other storage objects.
Requiredbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to access point information. If NULL, only local system is examined.
TargetSettingGoal REF CIM_SettingData
DescriptionstringDesired target SettingData. If NULL, settings of the source element will be used.

GetPeerSystems (uint32)

Method Qualifiers (GetPeerSystems)

NameData TypeValue
DescriptionstringGet (or start a job to get) all of the peer systems. A peer system is a system that is known and visible to the Replication Service. Peer systems are discovered through discovery services and/or implementation specific services.If a job is started, once the job completes, examine the AffectedJobElement associations for the peer systems.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetPeerSystems)

NameTypeQualifiers
NameData TypeValue
Optionsuint16
DescriptionstringThis parameter specifies which peer systems to return. If NULL, all known systems are returned, whether those systems are currently reachable or not.
ValueMapstring2, 3, .., 0x8000..
ValuesstringOnly systems currently reachable, Include access points for systems currently reachable, DMTF Reserved, Vendor Specific
LocalAccessPointsCIM_ServiceAccessPoint[]
ArrayTypestringIndexed
DescriptionstringAn array of references to local ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
ModelCorrespondencestringCIM_ReplicationService.GetPeerSystems(Systems)
OUTbooleantrue
RemoteAccessPointsCIM_ServiceAccessPoint[]
ArrayTypestringIndexed
DescriptionstringAn array of references to remote ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
ModelCorrespondencestringCIM_ReplicationService.GetPeerSystems(Systems)
OUTbooleantrue
SystemsCIM_ComputerSystem[]
ArrayTypestringIndexed
DescriptionstringList of peer ComputerSystems.
ModelCorrespondencestringCIM_ReplicationService.GetPeerSystems(LocalAccessPoints), CIM_ReplicationService.GetPeerSystems(RemoteAccessPoints)
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue

GetReplicationRelationships (uint32)

Method Qualifiers (GetReplicationRelationships)

NameData TypeValue
DescriptionstringGet (or start a job to get) all of the synchronization relationships known to the processing replication service. If a job is started, once the job completes, examine the AffectedJobElement associations for the synchronization relationships.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetReplicationRelationships)

NameTypeQualifiers
NameData TypeValue
CopyStateuint16
DescriptionstringOnly retrieve synchronization relationships that are currently in this CopyState. If this parameter is not supplied, relationships are retrieved regardless of their current CopyState.
ModelCorrespondencestringCIM_Synchronized.CopyState
Localityuint16
DescriptionstringDescribes the desired locality. If this parameter is not supplied, all replication relationships are retrieved, regardless of the locality of elements. Local only: Source and target elements are contained in the same system. Remote only: Source and target elements are contained in two different systems.
ValueMapstring2, 3, .., 0x8000..
ValuesstringLocal only, Remote only, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringDescribes the desired mode. If this parameter is not supplied, both all modes are retrieved. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings to consider in locating the replication relationships, for example, the CopyMethodology -- which indicates how the copy operation is carried out -- for example, full or incremental mirroring.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringDescribes the desired synchronization type. If this parameter is not specified, all SyncType are retrieved.
ModelCorrespondencestringCIM_Synchronized.SyncType
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
Typeuint16
DescriptionstringThe type of synchronization relationships, for example, StorageSynchronized or GroupSynchronized. If this parameter is not supplied, all such relationships are retrieved.
ValueMapstring2, 3, .., 0x8000..
ValuesstringStorageSynchronized, GroupSynchronized, DMTF Reserved, Vendor Specific
SynchronizationsCIM_Synchronized[]
DescriptionstringAn array of elements found.
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue

GetServiceAccessPoints (uint32)

Method Qualifiers (GetServiceAccessPoints)

NameData TypeValue
DescriptionstringGet (or start a job to get) ServiceAccessPoints associated with a peer system. If a job is started, once the job completes, examine the AffectedJobElement associations for the peer system's ServiceAccessPoints.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetServiceAccessPoints)

NameTypeQualifiers
NameData TypeValue
ServiceAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringList of ServiceAccessPoints for the supplied System.
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue
System REF CIM_ComputerSystem
DescriptionstringThis parameter specifies the peer system.
Requiredbooleantrue

AddReplicationEntity (uint32)

Method Qualifiers (AddReplicationEntity)

NameData TypeValue
DescriptionstringIntroduces a new instance of ReplicationEntity in the specified Namespace.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Vendor Specific

Method Parameters (AddReplicationEntity)

NameTypeQualifiers
NameData TypeValue
InstanceNamespacestring
DescriptionstringNamespace of created instance. If null, created instance will be in the same namespace as the service.
Persistentboolean
DescriptionstringIf true, the instance must persist across Management Server reboot. If NULL, the value will be based on the default value of the class in the MOF. Use the intrinsic method ModifyInstance to change the Persistency value.
ReplicationEntitystring
EmbeddedInstancestringCIM_ReplicationEntity
Requiredbooleantrue
ReplicationEntityPath REF CIM_ReplicationEntity
DescriptionstringReference to the created instance.
OUTbooleantrue

AddServiceAccessPoint (uint32)

Method Qualifiers (AddServiceAccessPoint)

NameData TypeValue
DescriptionstringIntroduces a new instance of a ServiceAccessPoint, or one of its subclasses, for example, a RemoteServiceAccessPoint in the specified namespace.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Vendor Specific

Method Parameters (AddServiceAccessPoint)

NameTypeQualifiers
NameData TypeValue
InstanceNamespacestring
DescriptionstringNamespace of created instance. If null, created instance will be in the same namespace as the service.
ServiceAccessPointstring
EmbeddedInstancestringCIM_ServiceAccessPoint
Requiredbooleantrue
ServiceAccessPointPath REF CIM_ServiceAccessPoint
DescriptionstringReference to the created instance.
OUTbooleantrue

AddSharedSecret (uint32)

Method Qualifiers (AddSharedSecret)

NameData TypeValue
DescriptionstringIntroduces a new instance of SharedSecret in the specified namespace and optionally associates it to an instance of a ServiceAccessPoint.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Vendor Specific

Method Parameters (AddSharedSecret)

NameTypeQualifiers
NameData TypeValue
InstanceNamespacestring
DescriptionstringNamespace of created instance. If null, created instance will be in the same namespace as the the service.
SharedSecretstring
EmbeddedInstancestringCIM_SharedSecret
Requiredbooleantrue
ServiceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringAssociate created instance to this ServiceAccessPoint. If null, no such association is established.
SharedSecretPath REF CIM_SharedSecret
DescriptionstringReference to the created instance.
OUTbooleantrue

CreateListReplica (uint32)

Method Qualifiers (CreateListReplica)

NameData TypeValue
DescriptionstringCreate (or start a job to create) new storage objects, which are replicas of the specified source storage objects (SourceElements). Note that using the input parameter, SyncType, this function can be used to instantiate the replicas, and to create an ongoing association between the source and replica elements. If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateListReplica)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringSpecifies whether consistency is to be maintained across the list of created replication relationships.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the provider uses the default replication setting data. The same ReplicationSettingData applies to all SourceElements entries.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringSyncType describes the type of copy that will be made. The same SyncType applies to all elements in the list.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the copy operation remains idle until it is activated. Synchronized: Replicas are an exact copy of the sources. UnSynchronized: Copy operation is in progress. If this parameter is supplied, then all the created replication relationships shall have this supplied CopyState before the method returns.
ModelCorrespondencestringCIM_Synchronized.CopyState
ElementNamesstring[]
DescriptionstringAn array of end user relevant names for the elements being created. If NULL, then a system supplied name is used. The value will be stored in the 'ElementName' property for the created element. The first element of the array ElementNames is assigned to the first replica, the second element to the second replica and so on. If there are more SourceElements entries than ElementNames, the system supplied name is used.
CollectionsCIM_Collection[]
DescriptionstringThe target elements are added to each referenced collection, for example, DeviceMaskingGroups.
SourceElementsCIM_LogicalElement[]
DescriptionstringA list of source storage objects which may be StorageVolumes or other storage objects. All the source elements shall be of the same type -- for example, all StorageVolumes.
Requiredbooleantrue
SynchronizationsCIM_Synchronized[]
DescriptionstringReference to the created associations between the source and the target elements. If a job is created, this parameter may be NULL unless the associations are actually formed.
INbooleanfalse
OUTbooleantrue
TargetElementsCIM_LogicalElement[]
DescriptionstringOptionally, as an input, refers to the target elements to use. If specified, the elements will match one to one with SourceElements[]. As an output, refers to the created target storage elements (i.e., the replicas). If a job is created, the target elements may not be available immediately.
OUTbooleantrue
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringReference to the ConnectivityCollection - for example, a RemoteReplicationCollection. Since a RemoteReplicationCollection aggregates the ProtocolEndpoints that provide the paths to a remote system, generally, it is not necessary to supply both the ConnectivityCollection and the ServiceAccessPoint.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source element. This parameter applies to all elements in the source list.
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target elements. This parameter applies to all elements in the target list.
TargetPool REF CIM_ResourcePool
DescriptionstringThe underlying storage for the target elements (the replicas) will be drawn from TargetPool if specified, otherwise the allocation is implementation specific. If the target elements are supplied, this parameter shall be NULL. This parameter applies to all elements in the target list.
TargetSettingGoal REF CIM_SettingData
DescriptionstringThe definition for the SettingData to be maintained by the target storage objects (the replicas). If the target elements are supplied, this parameter shall be NULL. This parameter applies to all elements in the target list.

CreateGroupReplicaFromElements (uint32)

Method Qualifiers (CreateGroupReplicaFromElements)

NameData TypeValue
DescriptionstringCreate (or start a job to create) new storage objects, which are replicas of the specified source storage objects (SourceElements). Note that using the input parameter, SyncType, this function can be used to instantiate the replicas, and to create an ongoing association between the source and replica elements. If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter. This method combines the functionality of CreateGroup and CreateGroupReplica, in one call.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateGroupReplicaFromElements)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringOverrides the default group consistency.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
RelationshipNamestring
DescriptionstringA 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). If NULL, the implementation assigns a name. If the individual target elements require an ElementName, the implementation constructs an appropriate ElementName using the RelationshipName. For example, RelationshipName as a prefix followed by "_n" sequence number, where n is a number beginning with 1.
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SourceGroupNamestring
DescriptionstringAs in parameter, the name of the group to be created. If the name is not supplied, the implementation may assign a group name and return it in this parameter.
OUTbooleantrue
SyncTypeuint16
DescriptionstringSyncType describes the type of copy that will be made.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
TargetGroupNamestring
DescriptionstringAs in parameter, the name of the group to be created. If the name is not supplied, the implementation may assign a group name and return it in this parameter.
OUTbooleantrue
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress.
ModelCorrespondencestringCIM_Synchronized.CopyState
TargetElementNamesstring[]
DescriptionstringAn array of end user relevant names for the elements being created. If NULL, then a system supplied name is used. The value will be stored in the 'ElementName' property for the created elements.
CollectionsCIM_Collection[]
DescriptionstringThe target elements are added to each referenced collection, for example, DeviceMaskingGroups.
SourceElementsCIM_LogicalElement[]
DescriptionstringA list of source storage objects which may be StorageVolumes or other storage objects. All the source elements shall be of the same type -- for example, all StorageVolumes.
Requiredbooleantrue
TargetElementsCIM_LogicalElement[]
DescriptionstringA list of target storage objects which may be StorageVolumes or other storage objects. All the target elements shall be of the same type -- for example, all StorageVolumes.
TargetPoolsCIM_ResourcePool[]
DescriptionstringThe underlying storage for the target elements (the replicas) will be drawn from TargetPools if specified, otherwise the allocation is implementation specific. If target elements are supplied, this parameter shall be NULL.supplied, this parameter shall be NULL. If TargetPools supplied, TargetPool shall be NULL.
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringReference to the ConnectivityCollection - for example, a RemoteReplicationCollection. Since a RemoteReplicationCollection aggregates the ProtocolEndpoints that provide the paths to a remote system, generally, it is not necessary to supply both the ConnectivityCollection and the ServiceAccessPoint.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source elements.
SourceGroup REF CIM_ReplicationGroup
DescriptionstringOptionally, as an input, refers to a source group to use. As an output, refers to the created source group (i.e., the replica group). If a job is created, the source group may not be available immediately.
OUTbooleantrue
Synchronization REF CIM_Synchronized
DescriptionstringReference to the created group association between the source and the target elements. If a job is created, this parameter may be NULL until the association is actually formed.
INbooleanfalse
OUTbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target element/group.
TargetGroup REF CIM_ReplicationGroup
DescriptionstringOptionally, 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.
OUTbooleantrue
TargetPool REF CIM_ResourcePool
DescriptionstringThe underlying storage for the target elements (the replicas) will be drawn from TargetPool if specified, otherwise the allocation is implementation specific. If target elements are supplied, this parameter shall be NULL. If TargetPool supplied, TargetPools shall be NULL.
TargetSettingGoal REF CIM_SettingData
DescriptionstringThe definition for the SettingData to be maintained by the target storage objects (the replicas). If target elements are supplied, this parameter shall be NULL.

GetReplicationRelationshipInstances (uint32)

Method Qualifiers (GetReplicationRelationshipInstances)

NameData TypeValue
DescriptionstringGet (or start a job to get) all of the synchronization relationships known to the processing replication service. If a job is started, once the job completes, examine the AffectedJobElement associations for the synchronization relationships. This method is similar to GetReplicationRelationships, except that this method returns the instances as opposed to object paths.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetReplicationRelationshipInstances)

NameTypeQualifiers
NameData TypeValue
CopyStateuint16
DescriptionstringOnly retrieve synchronization relationships that are currently in this CopyState. If this parameter is not supplied, relationships are retrieved regardless of their current CopyState.
ModelCorrespondencestringCIM_Synchronized.CopyState
Localityuint16
DescriptionstringDescribes the desired locality. If this parameter is not supplied, all replication relationships are retrieved, regardless of the locality of elements. Local only: Source and target elements are contained in the same system. Remote only: Source and target elements are contained in two different systems.
ValueMapstring2, 3, .., 0x8000..
ValuesstringLocal only, Remote only, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringDescribes the desired mode. If this parameter is not supplied, all modes are retrieved. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings to consider in locating the replication relationships, for example, the CopyMethodology -- which indicates how the copy operation is carried out -- for example, full or incremental mirroring.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringDescribes the desired synchronization type. If this parameter is not specified, all SyncType are retrieved.
ModelCorrespondencestringCIM_Synchronized.SyncType
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
Typeuint16
DescriptionstringThe type of synchronization relationships, for example, StorageSynchronized or GroupSynchronized. If this parameter is not supplied, all such relationships are retrieved.
ValueMapstring2, 3, .., 0x8000..
ValuesstringStorageSynchronized, GroupSynchronized, DMTF Reserved, Vendor Specific
Synchronizationsstring[]
DescriptionstringAn array of instances found.
EmbeddedInstancestringCIM_Synchronized
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue

ModifyListSettingsDefineState (uint32)

Method Qualifiers (ModifyListSettingsDefineState)

NameData TypeValue
DescriptionstringModify (or start a job to modify) the SettingsDefineState associations between the storage objects and instances of SynchronizationAspect. The modification could range from introducing the target elements, which creates new StorageSynchronized associations to dissolving the SettingsDefineState associations. If 0 is returned, the function completed successfully and no ConcreteJob instance was created. If 4096/0x1000 is returned, a ConcreteJob was started and a reference to this Job is returned in the Job output parameter. A return value of 1 indicates the method is not supported. All other values indicate some type of error condition.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (ModifyListSettingsDefineState)

NameTypeQualifiers
NameData TypeValue
Operationuint16
DescriptionstringOperation describes the type of modification to be made to the related associations. Activate Consistency: if consistency was not requested when CreateListSynchronizationAspect was called. If Consistency is already active, no modification is made. Deactivate Consistency: Deactivate consistency. If consistency was not enabled, this operation has no effect. Delete: Remove the SettingsDefineState association. Copy To Target: Introduces the target elements and forms the necessary associations between the source and the target elements i.e. StorageSynchronized and GroupSynchronized. Detach: Removes the association between the SynchronizationAspect and the target element. Restore: Restore the source element from the associated SynchronizationAspect. Attach To Target: Same as Copy To Target except no data is copied.
Requiredbooleantrue
ValueMapstring2, 3, 4, 5, 6, 7, 8, .., 0x8000..0xFFFF
ValuesstringActivate Consistency, Deactivate Consistency, Delete, Copy To Target, Detach, Restore, Attach To Target, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
TargetElementCountuint64
DescriptionstringThis parameter applies to one-source-to-many-target- elements. It is possible to create multiple copies of the source elements. If TargetCount is supplied, TargetElements and TargetGroups shall be NULL.
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress. Fractured/Split: Target elements are separated from the source elements. Etc.
ModelCorrespondencestringCIM_Synchronized.CopyState
ElementNamesstring[]
DescriptionstringA end user relevant name for the elements being created. If NULL, then a system supplied default names can be used. The value will be stored in the 'ElementName' property for the created elements.
CollectionsCIM_Collection[]
DescriptionstringThe target elements are added to each referenced collection, for example, DeviceMaskingGroups.
SettingsStatesCIM_SettingsDefineState[]
DescriptionstringReferences to the associations between the source elements and instances of SynchronizationAspect.
Requiredbooleantrue
SynchronizationsCIM_Synchronized[]
DescriptionstringReferences to the created replication associations describing the elements/groups relationships.
INbooleanfalse
OUTbooleantrue
TargetElementsCIM_LogicalElement[]
DescriptionstringOptionally, as an input, refers to target elements to use. If TargetElements are supplied, TargetGroups and TargetCount shall be NULL. As an output, refers to the created target storage elements (i.e., the replicas). If a job is created, the target elements may not be available immediately.
OUTbooleantrue
TargetGroupsCIM_ReplicationGroup[]
DescriptionstringOptionally, as an input, refers to a target groups to use. If TargetGroups are supplied, TargetElements and TargetCount shall be NULL. As an output, refers to the created target groups (i.e., the replica groups). If a job is created, the target groups may not be available immediately. If TargetGroups are supplied, TargetElementCount shall be NULL.
OUTbooleantrue
TargetPoolsCIM_ResourcePool[]
DescriptionstringThe underlying storage for the target elements (the replicas) will be drawn from TargetPools if specified, otherwise the allocation is implementation specific. If target elements are supplied, this parameter shall be NULL.
TargetSettingGoalsCIM_SettingData[]
DescriptionstringThe definition for the SettingData to be maintained by the target storage objects (the replicas). If the target elementsare supplied, this parameter shall be NULL.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target elements/groups.

AddToRemoteReplicationCollection (uint32)

Method Qualifiers (AddToRemoteReplicationCollection)

NameData TypeValue
DescriptionstringAdd (or start a job to add) additional service access points (i.e. ProtocolEndpoints) and/or remote systems associations to an existing instance of RemoteReplicationCollection.If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter. If parameter AccessPoints is NULL, then only the RemoteComputerSystem is added for the existing AccessPoints associated to the RemoteReplicationCollection. If RemoteComputerSystem is NULL, then only AccessPoints are added for the existing remote ComputerSystems known to the RemoteReplicationCollection.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (AddToRemoteReplicationCollection)

NameTypeQualifiers
NameData TypeValue
LocalAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringAn array of references to local ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
RemoteAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringAn array of references to remote ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringThe reference to the RemoteReplicationCollection to be expanded.
Requiredbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
RemoteComputerSystem REF CIM_ComputerSystem
DescriptionstringA reference to the remote system.

CreateRemoteReplicationCollection (uint32)

Method Qualifiers (CreateRemoteReplicationCollection)

NameData TypeValue
DescriptionstringCreate (or start a job to create) a new instance of RemoteReplicationCollection, and optionally supply the remote system and the paths (i.e. ProtocolEndpoints) that are used to perform replication operations to/from the remote system. If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter. Once the job completes, examine the AffectedJobElement associations for the created instance of RemoteReplicationCollection.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateRemoteReplicationCollection)

NameTypeQualifiers
NameData TypeValue
Activeboolean
DescriptionstringIf true, the instance of RemoteReplicationCollection will be enabled and allows replication operations to to the remote system. Use the intrinsic method ModifyInstance to change this property after the RemoteReplicationCollection is created.
DeleteOnUnassociatedboolean
DescriptionstringIf true, the instance of RemoteReplicationCollection will be deleted when it is no longer associated to a ServiceAccessPoint. Use the intrinsic method ModifyInstance to change this property after the RemoteReplicationCollection is created.
ElementNamestring
DescriptionstringA end user relevant name for the element being created. If NULL, then a system supplied default name can be used. The value will be stored in the 'ElementName' property for the created element.
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings for the method. For example, enable data compression.
EmbeddedInstancestringCIM_ReplicationSettingData
LocalAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringAn array of references to local ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
RemoteAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringAn array of references to remote ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringReference to the created instance of RemoteReplicationCollection.
INbooleanfalse
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
RemoteComputerSystem REF CIM_ComputerSystem
DescriptionstringA reference to the remote system.

RemoveFromRemoteReplicationCollection (uint32)

Method Qualifiers (RemoveFromRemoteReplicationCollection)

NameData TypeValue
DescriptionstringRemove (or start a job to remove) service access points (i.e. ProtocolEndpoints) and/or remote systems associations from an existing instance of RemoteReplicationCollection.If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter. If parameter AccessPoints is NULL, then only the remote ComputerSystem is removed for the existing AccessPoints associated to the RemoteReplicationCollection. If ComputerSystem is NULL, then only AccessPoints are removed from the existing remote ComputerSystems known to the RemoteReplicationCollection.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (RemoveFromRemoteReplicationCollection)

NameTypeQualifiers
NameData TypeValue
LocalAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringAn array of references to local ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
RemoteAccessPointsCIM_ServiceAccessPoint[]
DescriptionstringAn array of references to remote ServiceAccessPoints (for example, ProtocolEndpoints) that allow communication to the remote system.
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringThe reference to the RemoteReplicationCollection to affect.
Requiredbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
RemoteComputerSystem REF CIM_ComputerSystem
DescriptionstringA reference to the remote system to remove.

AddElementsToGroupSynchronized (uint32)

Method Qualifiers (AddElementsToGroupSynchronized)

NameData TypeValue
DescriptionstringAdd elements (or start a job to add elements) to replication groups of a GroupSynchronized association. The implementation then creates StorageSynchronized associations between the matching added elements. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (AddElementsToGroupSynchronized)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringOverrides the default group consistency.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress.
ModelCorrespondencestringCIM_Synchronized.CopyState
SourceElementsCIM_LogicalElement[]
ArrayTypestringIndexed
DescriptionstringReference to the elements to add to the source group.
ModelCorrespondencestringCIM_ReplicationService.AddElementsToGroupSynchronized(TargetElements)
SynchronizationsCIM_Synchronized[]
DescriptionstringReference to the created associations between the source and the target elements. If a job is created, this parameter may be NULL until the associations is actually formed.
INbooleanfalse
OUTbooleantrue
TargetElementsCIM_LogicalElement[]
ArrayTypestringIndexed
DescriptionstringReference to the elements to add to the target group. Pairing of source and target elements is controlled by the Pairing property of ReplicationSettingData if supplied, otherwise, based on default ReplicationSettingData.
ModelCorrespondencestringCIM_ReplicationService.AddElementsToGroupSynchronized(SourceElements)
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source element/group.
Synchronized REF CIM_Synchronized
DescriptionstringReference to the Synchronized association.
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target element/group.

ConfirmTargetData (uint32)

Method Qualifiers (ConfirmTargetData)

NameData TypeValue
DescriptionstringConfirm data written to the source elements has been replicated to the target elements. This method is useful for asynchronous replication where data written to the source elements may not be replicated to the target elements right away. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.
ValueMapstring0, 1, 2, 3, 4, 5, 6, 7, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, Unable to confirm target data, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (ConfirmTargetData)

NameTypeQualifiers
NameData TypeValue
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
WaitTimedatetime
DescriptionstringIt specifies the interval of time to wait to confirm data is written to the target elements. For example, to wait 5 minutes, the value would be 00000000000500.000000:000, using the CIM interval format. If NULL or 0, the implementation decides the interval. If the WaitTime expires before the target data is confirmed, the method will return "3" (Timeout).
ConnectivityCollection REF CIM_ConnectivityCollection
DescriptionstringReference to the ConnectivityCollection - for example, a RemoteReplicationCollection. Since a RemoteReplicationCollection aggregates the ProtocolEndpoints that provide the paths to a remote system, generally, it is not necessary to supply both the ConnectivityCollection and the ServiceAccessPoint.
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source element/group.
Synchronized REF CIM_Synchronized
DescriptionstringReference to the Synchronized association. For example, a StorageSynchronized or a GroupSynchronized.
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target element/group.

CreateGroupReplicaFromElementSynchronizations (uint32)

Method Qualifiers (CreateGroupReplicaFromElementSynchronizations)

NameData TypeValue
DescriptionstringBased on existing storage element synchronizations, create (or start a job to create) the source and target groups, add the elements into the groups and create an ongoing association between the groups. If 0 is returned, the function completed successfully and no ConcreteJob instance created. If 4096/0x1000 is returned, a ConcreteJob is started, a reference to which is returned in the Job output parameter.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateGroupReplicaFromElementSynchronizations)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringOverrides the default group consistency.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
RelationshipNamestring
DescriptionstringA user relevant name for the relationship between the source and target group. If NULL, the implementation assigns a name. If the target group requires an ElementName, the implementation constructs an appropriate ElementName using the RelationshipName. For example, RelationshipName as a prefix followed by "_n" sequence number, where n is a number beginning with 1.
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SourceGroupNamestring
DescriptionstringAs in parameter, the name of the source group to be created. If the name is not supplied, the implementation may assign a group name and return it in this parameter.
OUTbooleantrue
TargetGroupNamestring
DescriptionstringAs in parameter, the name of the target group to be created. If the name is not supplied, the implementation may assign a group name and return it in this parameter.
OUTbooleantrue
WaitForCopyStateuint16
DescriptionstringMethod must wait until this CopyState is reached before returning. Only a subset of valid CopyStates apply. For example, Initialized: Associations have been established, but there is no data flow. Inactive: Initialization is complete, but the data flow remains idle until it is activated. Synchronized: Replicas are an exact copy of the source. UnSynchronized: Copy operation is in progress.
ModelCorrespondencestringCIM_Synchronized.CopyState
ElementSynchronizationsCIM_Synchronized[]
DescriptionstringReference to the associations between the source and the target elements.
GroupSynchronization REF CIM_Synchronized
DescriptionstringReference to the created group association between the source and the target elements. If a job is created, this parameter may be NULL until the association is actually formed.
INbooleanfalse
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source elements.
SourceGroup REF CIM_ReplicationGroup
DescriptionstringOptionally, as an input, refers to a source group to use. As an output, refers to the created source group (i.e., the replica group). If a job is created, the source group may not be available immediately.
OUTbooleantrue
TargetAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to target access point information. If NULL, service does not need access information to access the target element/group.
TargetGroup REF CIM_ReplicationGroup
DescriptionstringOptionally, 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.
OUTbooleantrue

GetSynchronizationAspectInstances (uint32)

Method Qualifiers (GetSynchronizationAspectInstances)

NameData TypeValue
DescriptionstringGet (or start a job to get) all of the instances of synchronization aspects known to the processing replication service. If a job is started, once the job completes, examine the AffectedJobElement associations for the synchronization aspects.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetSynchronizationAspectInstances)

NameTypeQualifiers
NameData TypeValue
CachedDataboolean
DescriptionstringIf true, for faster response, retrieve the data from the local cache. If false retrieve the most up-to-date data by examining each relationship's updated state. If not specified, the implementation decides.
Localityuint16
DescriptionstringDescribes the desired locality. If this parameter is not supplied, all synchronization aspects are retrieved, regardless of the locality of elements. Local only: Source and aspect are contained in the same system. Remote only: Source and aspect elements are contained in two different systems.
ValueMapstring2, 3, .., 0x8000..
ValuesstringLocal only, Remote only, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringDescribes the desired mode. If this parameter is not supplied, all modes are retrieved. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings to consider in locating the replication relationships, for example, the CopyMethodology.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncStateuint16
DescriptionstringOnly retrieve synchronization aspects that are currently in this SyncState. If this parameter is not supplied, synchronization aspects are retrieved regardless of their current SyncState.
ModelCorrespondencestringCIM_SynchronizationAspect.SyncState
SyncTypeuint16
DescriptionstringDescribes the desired synchronization type. If this parameter is not specified, all SyncType are retrieved.
ModelCorrespondencestringCIM_Synchronized.SyncType
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
SynchronizationAspectsstring[]
DescriptionstringAn array of instances found.
EmbeddedInstancestringCIM_SynchronizationAspect
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue

GetSynchronizationAspects (uint32)

Method Qualifiers (GetSynchronizationAspects)

NameData TypeValue
DescriptionstringGet (or start a job to get) all of the synchronization aspects known to the processing replication service. If a job is started, once the job completes, examine the AffectedJobElement associations for the synchronization aspects.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unspecified Error, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (GetSynchronizationAspects)

NameTypeQualifiers
NameData TypeValue
CachedDataboolean
DescriptionstringIf true, for faster response, retrieve the data from the local cache. If false retrieve the most up-to-date data by examining each relationship's updated state. If not specified, the implementation decides.
Localityuint16
DescriptionstringDescribes the desired locality. If this parameter is not supplied, all synchronization aspects are retrieved, regardless of the locality of elements. Local only: Source and aspect are contained in the same system. Remote only: Source and aspect elements are contained in two different systems.
ValueMapstring2, 3, .., 0x8000..
ValuesstringLocal only, Remote only, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringDescribes the desired mode. If this parameter is not supplied, all modes are retrieved. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf supplied, it provides additional replication settings to consider in locating the replication relationships, for example, the CopyMethodology.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncStateuint16
DescriptionstringOnly retrieve synchronization aspects that are currently in this SyncState. If this parameter is not supplied, synchronization aspects are retrieved regardless of their current SyncState.
ModelCorrespondencestringCIM_SynchronizationAspect.SyncState
SyncTypeuint16
DescriptionstringDescribes the desired synchronization type. If this parameter is not specified, all SyncType are retrieved.
ModelCorrespondencestringCIM_Synchronized.SyncType
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
SynchronizationAspectsCIM_SynchronizationAspect[]
DescriptionstringAn array of elements found.
OUTbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if the task completed).
INbooleanfalse
OUTbooleantrue

CreateListSynchronizationAspect (uint32)

Method Qualifiers (CreateListSynchronizationAspect)

NameData TypeValue
DescriptionstringCreate (or start a job to create) new point-in-time representations of source elements. These representations may be of a form of pointers that keep track of data at the time the point-in-time was created, or a series of checkpoints that capture the view of data on the source elements at the time of point-in-time. This method does not include target elements, however, target elements can be added subsequently using the ModifyListSettingsDefineState method. If the method executes successfully, SettingsDefineState associations are created between the source elements and the SynchronizationAspect instances, which will have the datetime of the point-in-time.
ValueMapstring0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 0x8000..
ValuesstringCompleted with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific

Method Parameters (CreateListSynchronizationAspect)

NameTypeQualifiers
NameData TypeValue
Consistencyuint16
DescriptionstringSpecifies whether consistency is to be maintained across the list of created replication relationships.
ValueMapstring2, 3, .., 0x8000..
ValuesstringNo Consistency, Sequential Consistency, DMTF Reserved, Vendor Specific
Modeuint16
DescriptionstringMode describes whether the target elements will be updated synchronously or asynchronously. Adaptive: Allows implementation to dynamically switch between synchronous and asynchronous modes. If NULL, implementation decides the mode.
ModelCorrespondencestringCIM_Synchronized.Mode
ValueMapstring2, 3, 4, .., 0x8000..
ValuesstringSynchronous, Asynchronous, Adaptive, DMTF Reserved, Vendor Specific
ReplicationSettingDatastring
DescriptionstringIf provided, it overrides the default replication setting data for the given SyncType. If not provided, the management server uses the default replication setting data.
EmbeddedInstancestringCIM_ReplicationSettingData
SyncTypeuint16
DescriptionstringSyncType describes the type of copy that will be made.
ModelCorrespondencestringCIM_Synchronized.SyncType
Requiredbooleantrue
ValueMapstring.., 6, 7, 8, 9, .., 0x8000..
ValuesstringDMTF Reserved, Mirror, Snapshot, Clone, TokenizedClone, DMTF Reserved, Vendor Specific
Namesstring[]
DescriptionstringA end user relevant names for the elements created. If NULL, then system supplied default names can be used. The value will be stored in the elements' ElementName.
SettingsStatesCIM_SettingsDefineState[]
DescriptionstringReferences to the created associations between the source elements and the instances of SynchronizationAspect. If a job is created, this parameter may be NULL unless the associations are actually formed.
INbooleanfalse
OUTbooleantrue
SourceElementsCIM_ManagedElement[]
DescriptionstringThe source storage objects which may be StorageVolumes or other storage objects.
Requiredbooleantrue
Job REF CIM_ConcreteJob
DescriptionstringReference to the job (may be NULL if job is completed).
INbooleanfalse
OUTbooleantrue
SourceAccessPoint REF CIM_ServiceAccessPoint
DescriptionstringReference to source access point information. If NULL, service does not need access information to access the source elements.

Inherited Class Methods

NameReturn TypeClass Origin
ChangeAffectedElementsAssignedSequenceuint32CIM_Service
RequestStateChangeuint32CIM_EnabledLogicalElement
StartServiceuint32CIM_Service
StopServiceuint32CIM_Service