Using Caché Objects - InterSystems Documentation

Object Synchronization
Do SrcSyncSet.AddTransactions(,,ExcludedDB)
This gets all transactions, beginning with the first unsynchronized transaction to the most
recent transaction. The method uses information in the SyncTime table to determine the
values.
ExcludedDB is a $List assembled from the code:
Set ExcludedDB = $ListBuild(##class(%SYS.System).InstanceGUID(),$ZUtil(5))
where
• ##class(%SYS.System).InstanceGUID() returns the value of the GUID that has
been established for the local Caché instance.
• $ZUtil(5) returns the value of the current namespace for the local Caché instance.
3. After running AddTransactions, run the ErrCount method to determine how many
errors were encountered. If there have been errors, the SyncSet.Errors query provides
more detailed information.
4. Export the data to a local file using the ExportFile method:
Do SrcSyncSet.ExportFile(file,displaymode,bUpdate)
where
• file is the file to which the transactions are being exported; it is a name with a relative
or absolute path.
• displaymode specifies whether or not output appears for the method's actions, where
“d” specifies that output appears and “-d” specifies that it is silent.
• bUpdate is a boolean that specifies whether or not the SyncTime table is updated
(where the default is 1, meaning True). It may be helpful to explicitly set this to 0 at
this point, and then set it to 1 after the source receives assurance that the target has
indeed received the data and performed the synchronization.
5. Move the exported file from the source database's machine to the target database's machine.
You can do this using various facilities available within Caché, such as Web services.
6. Create a SyncSet object on the target machine using the SyncSet.%New method. Use
the same value for the argument of %New as on the source machine — this is what
identifies the source of the synchronized transactions.
7. Read the SyncSet object into the Caché instance on the target machine using the Import
method:
152 Using Caché Objects