DATA:REMove?

34980A

DATA:REMove?

Syntax

DATA:REMove? <num_readings>

Description

This command reads and erases the specified number of readings from memory. The readings are erased from memory starting with the oldest reading first. The purpose of this command is to allow you to periodically remove readings from memory during a scan than would normally cause reading memory to overflow (for example, during a scan with an infinite trigger count).   

Used With:

  • 34921A through 34925A Multiplexer Modules

  • 34950A Digital I/O Module (digital input and counter channels only)

  • 34952A Multifunction Module (digital input and totalizer channels only)

Parameters

Name

Type

Range of Values

Default Value

<num_readings>

Numeric

Specific 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 or a series of internal DMM measurements

  • You can store at least 500,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 12 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? command to determine the total number of readings currently in memory.

  • The output from this command is affected by the settings of the FORMat:READing commands. Depending on the formats selected, each reading may or may not be stored with measurement units, time stamp, channel number, and alarm status information.

  • 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 command 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 3 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

DATA:POINts?

FORMat:READing