For information on converting to InterSystems IRIS, see the
InterSystems IRIS Adoption Guide
and the InterSystems IRIS In-Place Conversion Guide,
both available on the WRC Distributions page (login required).
%SYNC.SyncSetObject models a record in a %SYNC.SyncSet. SyncSets are globals containing records corresponding to
filing events. A filing event is an insert of a new object, update of an existing object or delete of an existing object.
Each time a filing event occurs in a class that is OBJJOURNALENABLED, the event is recorded in the %ObjectJournalTransaction class.
SyncSets are created from the %ObjectJournalTransaction class and each record in the SyncSet corresponds to a %ObjectJournalRecord.
%ObjectJournalRecords are individual filing events that occur with a transaction, the transaction being an instance of %ObjectJournalTransaction.
The SyncSetObject contains information that identifies the SyncSet as well as specific information about the filing event
described by a record in the SyncSet.
BackwardLink is a link to the SyncSet instance that caused this SyncSet instance to be created. Creating a new
SyncSet instance is triggered by the Requeue mechanism. Requeue is the operation triggered by a failure to successfully
synchronize an object, usually because of an unresolvable reference. When a SyncSet instance is requeued the system
is basically saying to 'try this operation again later'. The idea being that the cause of the sync failure will have been
resolved by the time we process the requeued instance.
ForwardLink is a link to another SyncSet instance in the same SyncSet. ForwardLinks are
created when an object cannot be synchronized due to some error. Errors that produce forward
links are typically unresolvable references to other objects. The most common unresolvable reference
in a properly constructed SyncSet will be a reference to an object that has not yet been created because
it occurs later in the SyncSet.
sId is the global identifier and it is used to qualify the global name. Sync sets are constructed on
a system and then exported to other systems for synchronizing the objects it contains with a database
on the target system. The sId is used to generate a unique name for this sync set on the target system.
Overridden SSObject Get method. This method looks up the object in the local GUID index.
If the GUID is found then attempt to open the object associated with the GUID and return the result.
If the GUID is not found in the GUID index then return NULLOREF.