Using Caché Objects - InterSystems Documentation

Object Synchronization
• Translating between GUIDs and OIDs
• Manually updating a SyncTime table
17.3.1 Translating Between GUIDs and OIDs
If you have the GUID or OID for an object and wish to ascertain its OID or GUID, there are
two methods available for this operation:
• %GUID.%GUIDFind(guid) is a class method of the %GUID class that takes a GUID
of an object instance and returns the OID associated with that instance.
• %Persistent.%GUID(oid) is a class method of the %Persistent class that takes an OID
of an object instance and returns the GUID associated with that instance; the method can
only be run if the class' GUIDENABLED parameter is TRUE. This method dispatches
polymorphically and determines the most-specific-type class if the OID does not contain
that information. If the instance has no GUID, the method returns an empty string.
17.3.2 Manually Updating a SyncTime Table
To perform a manual update on the SyncTime table for a database, invoke the SetlTrn method,
which sets the last transaction number:
Set Status=##class(%SyncTime).SetlTrn(syncSYSID, syncNSID, ltrn)
where
• syncSYSID is the ID of the source database's system. If the %occTransaction.inc header
file is included, this value is available through the $$$txSIDlocal macro.
• syncNSID is the ID of the relevant namespace. The $ZUtil(5) function returns the value
of the current namespace.
• ltrn is the last transaction number to be updated. You can get this value by invoking the
SyncSet's GetLastTransaction method.
154 Using Caché Objects