Agilent Technologies Agilent 86120C manual Queues, Output queue, Error queue

Programming

Monitoring the Instrument

Queues

There are two queues in the instrument: the output queue and the error queue. The values in the output queue and the error queue can be queried.

Output queue

The output queue stores the instrument responses that are generated by certain commands and queries that you send to the instrument. The output queue generates the Message Available summary bit when the output queue contains one or more bytes. This summary bit sets the MAV bit (bit 4) in the Status Byte Register. The method used to read the Output Queue depends upon the programming language and envi- ronment. For example, with HP BASIC, the output queue may be read using the ENTER statement.

Error queue

As errors are detected, they are placed in an error queue. Instrument specific errors are indicated by positive values. General errors have negative values. You can clear the error queue by reading its contents, sending the *CLS command, or by cycling the instrument’s power.

The error queue is first in, first out. If the error queue overflows, the last error in the queue is replaced with error - 350, “Queue overflow.” Any time the queue overflows, the least recent errors remain in the queue, and the most recent error is discarded. The length of the instrument’s error queue is 30 (29 positions for the error messages, and 1 position for the “Queue overflow” message).

The error queue is read with the SYSTEM:ERROR? query. Executing this query reads and removes the oldest error from the head of the queue, which opens a position at the tail of the queue for a new error. When all the errors have been read from the queue, subsequent error queries return 0, “No error.”

For more information on reading the error queue, refer to “ERRor” on page 4- 98. For a list of errors messages, refer to “Error Messages” on page 7- 11.

3-22