The destination system directs the datacheck protocol.
This class provides control methods for starting and stopping the system.
See System for overview.
To create a new DataCheck system:
Create a new DataCheck Destination object on the destination system,
passing the appropriate parameters to the %New constructor
(see %OnNew()). Its related objects will be created
automatically.
Set up information about the source system in the
Configuration object, referenced by the
Configuration property.
Modify the RunParameters object, referenced
by the RunParameters property. It defines performance
characteristics and what globals should be checked, with conservative but
usable defaults.
If needed, modify the Workflow object, referenced
by the Workflow property. It defines the strategy for
performing the check and has defaults that are often suitable.
Call %Save on the destination object to save it and, implicitly, its
referenced objects.
Ensure that the source system has %Service_DataCheck enabled
Important: Once created, the destination object is modified by the DataCheck
daemons on a running system only, and should be treated as read-only for all
other purposes. Users should call %Save on this object only once as part of
creating the DataCheck destination system.
To modify an existing DataCheck system, modify the Configuration,
RunParameters, or Workflow objects as needed,
adhering to the following guidelines:
All of the referenced objects (as well as the Destination object itself)
have, as their ID, the name of the Destination object. Each object can be
opened with %OpenId(name) directly or referenced through the namesake property
of the destination object.
Call the %Save method of the referenced object that has been modified
only. Do not call %Save on the destination object.
The RunParameters and Workflow objects can be
saved while the system is running to change it's behavior dynamically. The
system must be stopped to save changes to the Configuration object.
The referenced objects should not be deleted or recreated, only modified.
To delete a Datacheck system, call %DeleteId(name). All related objects and
DataCheck results are deleted automatically.
Current phase of workflow. This property is modified by the DataCheck daemons
on a running system only, and should be treated as read-only for all other purposes.
Current phase number. This property is modified by the DataCheck daemons
on a running system only, and should be treated as read-only for all other purposes.
method %OnNew(name As %String, mirrorname="") as %Status
Constructor for creating a new DataCheck destination system. Specify a unique
name for this DataCheck system as the first parameter. If this DataCheck
system is to be based on a mirror configuration, pass the mirror name as the
second parameter.
Starts the system if not already started. Returns %Status. If the 'restartworkflow'
parameter is set to true, the workflow will be set to restart at phase #1 rather
than resume where it left off.
Any changes to the destination object or related objects must be saved
before calling this method.
Note: A return of $$$OK return here does not indicate the system started successfully
See the GetState() method to check the running state