Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [%SYS] >  [SYS] >  [Shadowing] >  [DataSource]
Private  Storage   

abstract class SYS.Shadowing.DataSource

API for current InterSystems IRIS instance acting as a data source of shadowing

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
11 2


Summary

Methods
Close Disable GetLatency


Methods

• classmethod Close(WaitTime As %Integer = 15) as %Status
To close existing shadow connections. To deny future incoming connections as well, one should configure %Service_Shadow accordingly before calling this method or simply call Disable, which disables %Service_Shadow.
• classmethod Disable(WaitTime As %Integer = 15) as %Status
To deny future incoming connections by disabling %Service_Shadow and close existing shadow connections. WaitTime specifies how long (in seconds) to wait for existing connections to close before returning. 0 means no wait, in which case one may query for existing connections afterwards. The default is 15 seconds. Returns 0 (no error description) if wait timed out.
• classmethod GetLatency(pid As %Integer) as %Integer
Latency of transferring journal files to the shadow side (destination)
The latency is the time (in seconds) needed to transfer the remaining journal data, projected based on the current transfer rate. -1 if latency is (temporarily) unavailable.

Queries

• query Connections()
Selects Port As %String, Shadow IP As %String, Journal As %String, PID As %Integer, Latency As %String, Shadowing Rate As %String
Returns details about current connections from shadows:
  • Port: The port number of TCP device receiving the incoming shadow connection;
  • Shadow IP: IP address of the incoming shadow connection;
  • Journal: The path of the source journal file currently being sent to the shadow;
  • PID: process ID of the job sending source journal file to the shadow;
  • Latency: A string typically consisting of a number and a time unit (seconds, minutes or hours), e.g., "0 second", or "N/A" if latency figure is (temporarily) unavailable;
  • Shadowing Rate: Rate of transferring journal files to the shadow, in units such as bytes/sec, KB/sec, etc. (e.g., "10 MB/sec"), or "N/A" if the rate is (temporarily) unavailable.
• query Errors()
Selects Time As %TimeStamp, $ZE As %String, Info As %String, Occurrences As %Integer
Returns details about errors.


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