DATA:REMove?
Syntax
DATA:REMove? <count> [,WAIT]
Description
This query reads and erases the specified number of measurements from the reading memory. The meas-
urements are erased from memory starting with the oldest measurement first. This allows you to peri-
odically remove measurements from memory during a series of measurements to avoid a reading memory
overflow.
Parameters
Name Type Range of Values Default Value
<count> Numeric 1 to 1,000,000, limited by number
of measurements currently in read-
ing memory
This is a required parameter
Remarks
l You can read and erase measurements from memory at any time, even during a series of meas-
urements.
l If no measurements are available or in progress, error -230,"Data corrupt or stale" will be generated,
and no data will be returned.
l If WAIT is not specified and fewer than the specified number of measurements are currently in memory,
error -222,"Data out of range" will be generated and no data will be returned. You can use the
DATA:POINts? command to determine the total number of measurements currently in memory. If WAIT
is specified, the command will wait for the requested number of measurements to be completed.
l You can store up to 1,000,000 measurements in the reading memory. If memory overflows, the new
measurements will overwrite the first (oldest) measurements stored; the most recent measurements are
always preserved. No error is generated, but the Reading Mem Ovfl bit (bit 14) is set in the Questionable
Data Register.
l The instrument clears all measurements from memory after a Factory Reset (*RST command), after an
Instrument Preset (SYSTem:PRESet command), or when mainframe power is cycled.
l The instrument clears all measurements from memory when the measurement function is changed,
when the INITiate:IMMediate, MEASure:<function>? or READ? commands are executed, after a Factory
Reset (*RST command) or after an Instrument Preset (SYSTem:PRESet command).
Return Format
The query returns the specified number of measurements and then erases them from memory. The format
of the measurements is controlled by the FORMat Subsystem commands.
DATA:REMove?
162 Keysight 53220A/53230A Programmer's Reference
To Next Page
Loading...
