The destination system directs the datacheck protocol. More...
Public Member Functions | |
_.Library.Status | Start (_.Library.Boolean restartworkflow) |
Starts the system if not already started. More... | |
_.Library.Status | Stop () |
Requests the system to stop if running. More... | |
![]() | |
_.Library.String | GetState (SYS.DataCheck.StateReason reason) |
DataCheck Overview More... | |
Public Attributes | |
Configuration | |
Configuration object for this system. More... | |
GUID | |
Used on the Source to compute a unique name for this connection. More... | |
Phase | |
Current phase of workflow. More... | |
PhaseNumber | |
Current phase number. More... | |
RunParameters | |
Running Parameters object for this system. More... | |
Workflow | |
Workflow object for this system. More... | |
![]() | |
MirrorName | |
Name of the mirror that this system is checking or null if not mirrorized. More... | |
Name | |
Unique name of the system. More... | |
Private Member Functions | |
_.Library.Status | OnNew (_.Library.String name, mirrorname) |
Constructor for creating a new DataCheck destination system. More... | |
Additional Inherited Members | |
![]() | |
_.Library.String | GetStateBySystem (SYS.DataCheck.SystemName systemname, SYS.DataCheck.StateReason reason) |
Returns current running state of specified system or null on error. More... | |
The destination system directs the datacheck protocol.
This class provides control methods for starting and stopping the system. See <CLASS>System</CLASS> 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 <METHOD>OnNew</METHOD>). Its related objects will be created automatically. Set up information about the source system in the <CLASS>Configuration</CLASS> object, referenced by the <PROPERTY>Configuration</PROPERTY> property. Modify the <CLASS>RunParameters</CLASS> object, referenced by the <PROPERTY>RunParameters</PROPERTY> property. It defines performance characteristics and what globals should be checked, with conservative but usable defaults. If needed, modify the <CLASS>Workflow</CLASS> object, referenced by the <PROPERTY>Workflow</PROPERTY> 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 Use <METHOD>Start</METHOD> to start the check.
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 <CLASS>Configuration</CLASS>, <CLASS>RunParameters</CLASS>, or <CLASS>Workflow</CLASS> 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 <CLASS>RunParameters</CLASS> and <CLASS>Workflow</CLASS> 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.
|
private |
_.Library.Status Start | ( | _.Library.Boolean | restartworkflow | ) |
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 <METHOD>GetState()</METHOD> method to check the running state
_.Library.Status Stop | ( | ) |
Requests the system to stop if running.
Upon restart, the system will resume
processing the queries that it was last running.
Note: The system is not necessarily stopped upon returning from this method See the <METHOD>GetState()</METHOD> method to check the running state
Configuration object for this system.
GUID |
Used on the Source to compute a unique name for this connection.
Phase |
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.
PhaseNumber |
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.
Running Parameters object for this system.