DATA:POINts:EVENt:THReshold <num_rdgs>
DATA:POINts:EVENt:THReshold?
Sets the number of readings to store in reading memory before setting bit 9 (reading memory threshold bit) in the
Standard Operation Register group event register to 1. An event register is a read-only register that latches events
from the condition register. While an event bit is set, subsequent events corresponding to that bit are ignored. For
more information, see STATus Subsystem.
Parameter Typical return
<num_rdgs> = Any integer from 1 to 100,000 readings (none)
Sets the reading memory threshold to 125 readings:
DATA:POIN:EVEN:THR 125
Typical response: +125
– To report any subsequent events, the reading count must first drop below the programmed reading memory
threshold before reaching the threshold again. Use R? or DATA:REMove? to remove readings from reading
memory.
– Use STATus:OPERation:ENABle to enable the bit 9 to be reported to the Status Byte Register.
– Once the bit 9 is set, it remains set until cleared by STATus:OPERation[:EVENt]? or *CLS (clear status) command.
– This parameter is set to its default value after a Factory Reset (*RST command) or Instrument Preset
(SYSTem:PRESet).
DATA:REMove? <num_rdgs> [, WAIT]
Reads and erases <num_rdgs> readings from the reading memory. If fewer than <num_rdgs> readings are avail-
able, the query returns an error unless the WAIT parameter is specified, in which case the query waits until <num_
rdgs> readings are available.
Parameter Typical return
<num_rdgs> = Any integer from 1 to 100,000 readings (none)
Read and erase the three oldest readings from reading memory:
DATA:REM? 3
Typical response: +4.27150000E+02,+1.32130000E+03,+3.65300000E+03
– You can remove readings from reading memory at any time, even during a scan.
– You can save up to 100,000 readings in reading memory and all readings are automatically time stamped. If read-
ing memory overflows, the new readings will overwrite the first (oldest) readings saved; the most recent readings
are always preserved. No error is generated, but the Reading Memory Overflow bit (bit 12) is set in the Ques-
tionable Data Register's condition register (see STATus Subsystem).
– You can use the DATA:POINts? query to determine the total number of readings currently in reading memory.
– The instrument clears all readings from reading memory when a new scan is initiated, or after a Factory Reset
(*RST command).
110
Keysight DAQ970A/DAQ973A Programming Guide
2 SCPI Programming