SYS.Shadowing.DataSource
abstract class SYS.Shadowing.DataSource
API for current Cache system acting as a data source of shadowingMethod Inventory
Methods
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.
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.
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.
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 Cache 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()
Returns details about errors.