DATA:REMove?
DATA:REMove?
Syntax
DATA:REMove? <num_rdgs>
Description
This query reads and clears the specified number of readings from the non-volatile memory. This allows you to continue a scan without losing data stored in memory (if memory becomes full, new readings will overwrite the first readings stored). The specified number of readings are cleared from memory, starting with the oldest reading.
Parameters
Name Type Range of Values Default Value <num_rdgs> Numeric An integer representing the number of readings to be read and erased from memory. This is a required parameter.
Remarks
- You can remove readings from memory at any time, even during a scan.
- You can store at least 50,000 readings in memory during a scan. Readings are stored only during a scan. If memory overflows, the new readings will overwrite the first (oldest) readings stored; the most recent readings are always preserved. In addition, bit 9 is set in the Questionable Data Register's condition register (see Status System Introduction).
- If fewer than the specified number of readings are currently in memory, an error will be generated. You can use the DATA:POINts? query to determine the total number of readings currently in memory.
- Each reading is returned with some combination of measurement units, time stamp, channel number, and alarm status information, depending on the settings set by the FORMat:READing commands. The time stamp is either in relative format (time in seconds since the beginning of the scan) or absolute format (time of day with date, based on the instrument's clock as set by the SYSTem:DATE and SYSTem:TIME commands). The choice of absolute and relative time is determined by the FORMat:READing:TIME:TYPE command.
- The instrument clears all readings from memory when a new scan is initiated, when any measurement parameters are changed (CONFigure and SENSe commands), and when the triggering configuration is changed (TRIGger commands).
- The instrument clears all readings from memory after a Factory Reset (*RST command), after an Instrument Preset (SYSTem:PRESet command), or when mainframe power is cycled.
Return Format
The query returns the specified number of readings (with formatting as set by the FORMat:READing commands) and then erases them from memory. Multiple responses are separated by commas.
Example
The following query returns three readings (starting with the oldest reading first) and erases them from memory.
DATA:REM? 3
Typical Response: +4.27150000E+02,+1.32130000E+03,+3.65300000E+03
See Also