TM1 Replication

[michael_gcph]

Hi! I've been trying to study TM1' APIs and is currently on learning replication.

I wanted to ask about these API calls in particular:
1. TM1ObjectReplicate
2. TM1ConnectionCreate
3. TM1ObjectReplicationConnection


for (1), the parameters as per IBM docs are:
- hPool is a valid pool handle obtained with TM1ValPoolCreate.
- hObject is a handle of the object to be replicated. This is typically a cube handle.
Am i correct in the understanding that this object or cube is the source?

for (2), the parameters as per IBM docs are:
- hPool is a valid pool handle obtained with TM1ValPoolCreate.
- hServer is a handle of the server on which the connection will be created.
- sMasterServerName is a string value containing the name of the star server.
- sUsername is a string value containing the name of the IBM® Cognos® TM1® client.
- sPassword is a string value containing the password.

hServer is the Target Server? sMasterServerName is the name of the Source server?

for (3), this is a property to be updated, define as per IBM:
- A connection object handle, as returned from TM1ConnectionCreate or the IBM® Cognos® TM1® server list property TM1ServerConnections

So, does it mean, you need to create the connection, then assign this connection as a property of the object/cube (source) to be replicated? Or this connection is to be assigned as a property to the target object/cube? I read that there are other properties as well to be set before you can call ObjectReplicate.

Just trying to further understand the TM1 APIs for now.