:DELete

CARDIAC. If you specify one of the built-in waveforms, a +782, “Cannot overwrite a built-in arb waveform” error is generated.

If you copy to a waveform name that already exists, the previous waveform is overwritten (no error is generated). The five built-in waveforms are protected; you cannot overwrite any of them.

Up to four user-defined waveforms can be stored in non-volatile memory. If memory is full and you try to copy a new waveform to non-volatile memory, a +781, “Not enough memory” error is generated. Use the DATA:DEL command to delete the waveform in VOLATILE memory or any of the four user-defined waveforms in non-volatile memory. Use the DATA:CAT? command to list all waveforms currently stored in volatile and non-volatile memory.

Example The following statement uses the DATA:COPY command to copy the waveform currently in volatile memory to non-volatile memory with file name ARB_1:

"DATA:COPY ARB_1, VOLATILE"

"DATA:COPY ARB_1"(optional "VOLATILE" parameter omitted)

:DELete

DATA:DELete <arb name> deletes the specified arbitrary waveform from memory. You can delete the waveform in volatile memory or any of the four user-defined waveforms in non-volatile memory.

Parameters The arb name may contain up to 8 characters. The first character must be a letter (A-Z), but the remaining characters can be numbers (0-9) or the underscore character (“ _ ”). Blank spaces are not allowed. If you specify a name with more than 8 characters, a +783, “Arb waveform name too long” error is generated.

The function generator does not distinguish between upper- and lower-case letters for the arbitrary waveform name. Therefore, ARB_1 and arb_1 are the same name. All characters are converted to upper case.

Comments You cannot delete the arbitrary waveform that is currently being output. If you attempt to delete the waveform being output, a +787, “Cannot delete an active arb waveform” error is generated.

You cannot delete any of the five built-in arbitrary waveforms. If you attempt to delete one of the built-in waveforms, a +786, “Cannot delete a built-in arb waveform” error is generated.

Use the DATA:DEL:ALL command to delete the waveform in VOLATILE memory and all user-defined non-volatile waveforms all at once.

If one of the waveforms is currently being output, a +787, “Cannot delete an active arb waveform” error is generated. The active waveform is not deleted but all of the other waveforms are deleted.

82 Agilent E1441A SCPI Command Reference

Chapter 3

Page 82
Image 82
Agilent Technologies E1441A user service DELete