2600AS-901-01 Rev. B / September 2008 Return to Section Topics 19-55
Series 2600A System SourceMeter® Instruments Reference Manual Section 19: Remote Commands
errorqueue.next
Function Reads an entry from the error/event queue.
TSP-Link
accessibility
This function can be accessed from a remote TSP-Link node.
Usage errorcode, message, severity, node = errorqueue.next()
errorcode Returns the error code number for the entry.
message Returns the message that describes the entry.
severity Returns the severity level (0, 10, 20, 30 or 40).
node Returns the node number where the error originated.
Remarks • Entries are stored in a first-in, first-out (FIFO) queue. This function reads the oldest entry and
removes it from the queue.
• Error codes and messages are listed in Table A-2 in Appendix A.
• If there are no entries in the queue, code 0, “Queue Is Empty” is returned.
• Returned severity levels include the following:
• 0 Informational: Indicates no error: “Queue is Empty”.
• 10 Informational: Indicates an event or a minor error. Examples: “Reading Available” and
“Reading Overflow”.
• 20 Recoverable: Indicates possible invalid user input. Operation will continue but action
should be taken to correct the error. Examples: “Exponent Too Large” and “Numeric Data Not
Allowed”.
• 30 Serious: Indicates a serious error and may require technical assistance. Example: “Saved
calibration constants corrupted”.
• 40 Fatal: Indicates that the Series 2600A is non-operational and will require service. Contact
information for service is provided in Section 1. Examples: “Bad SMU AFPGA image size”,
“SMU is unresponsive”, and “Communication Timeout with DFPGA”.
• In an expanded system, each TSP-Link enabled instrument is assigned a node number. node
returns the node number where the error originated.
Details See Appendix A (Error and Status Messages) and Appendix C (Status Model).
Also see errorqueue.clear, errorqueue.count
Example Reads the oldest entry in the error/event queue:
errorcode, message = errorqueue.next()
print(errorcode, message)
Output: 0.000000e+00 Queue Is Empty
The above output indicates that the queue is empty.