Agilent Technologies Infiniium 90000 Q-Series, Programmer'S Manual

Page: 810 / 1186

810 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
31
System Commands
:SYSTem:ERRor?
Query
:SYSTem:ERRor? [{NUMBer | STRing}]
The :SYSTem:ERRor? query outputs the next error number in the error
queue over the remote interface. When either NUMBer or no parameter is
specified in the query, only the numeric error code is output. When
STRing is specified, the error number is output followed by a comma and
a quoted string describing the error.
Table 30 lists the error numbers and
their corresponding error messages.
Returned Format
[:SYSTem:ERRor] <error_number>[,<quoted_string>]<NL>
<error_number> A numeric error code.
<quoted_string>
A quoted string describing the error.
Example This example reads the oldest error number and message in the error
queue into the string variable, strCondition, then prints the contents of the
variable to the computer's screen.
Dim strCondition As String ' Dimension variable.
myScope.WriteString ":SYSTEM:ERROR? STRING"
strCondition = myScope.ReadString
Debug.Print strCondition
Infiniium Oscilloscopes have an error queue that is 30 errors deep and
operates on a first- in, first- out (FIFO) basis. Successively sending the
:SYSTem:ERRor? query returns the error numbers in the order that they
occurred until the queue is empty. When the queue is empty, this query
returns headers of 0, "No error." Any further queries return zeros until
another error occurs. Note that front- panel generated errors are also
inserted in the error queue and the Event Status Register.
See Also
The "Error Messages" chapter for more information on error messages and
their possible causes.
N O T E
Send *CLS Before Other Commands or Queries
Send the *CLS common command to clear the error queue and Event Status Register before
you send any other commands or queries.