Class Reference
SYS.DataCheck.Destination
Server:irisdocs2
Instance:IRISLATEST
User:UnknownUser
 
-
  [%SYS] >  [SYS] >  [DataCheck] >  [Destination]
Private  Storage

persistent class SYS.DataCheck.Destination extends SYS.DataCheck.System

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
  • Use Start 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 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.

    Inventory

    Parameters Properties Methods Queries Indices ForeignKeys Triggers
    8 28


    Summary

    Properties

    • property Configuration as Configuration;
    Configuration object for this system
    • property GUID as %String;
    Used on the Source to compute a unique name for this connection
    • property Phase as Phase(CLASSNAME=1);
    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.
    • property PhaseNumber as %Integer;
    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.
    • property RunParameters as RunParameters;
    Running Parameters object for this system
    • property Workflow as Workflow;
    Workflow object for this system

    Methods

    • 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.
    • method Start(restartworkflow As %Boolean) as %Status
    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

    • method Stop() as %Status
    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 GetState() method to check the running state



    Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.