Error Handling¶

:SYSTem:ERRor[:NEXT]?¶

Syntax	:SYSTem:ERRor[:NEXT]?
Description	Queries the next element in the Error Queue
Parameter	None
Explanation	Queries the next element in the Error Queue
Return Format	<NR1>, String
Example	-> :SYSTem:ERRor? <- -102, "Syntax error" -> :SYSTem:ERRor? <- -108, "Parameter not allowed" -> :SYSTem:ERRor? <- 0, "No error"

:SYSTem:ERRor:ALL?¶

Syntax	:SYSTem:ERRor:ALL?
Description	Queries all entries the Error Queue
Parameter	None
Explanation	Queries all entries the Error Queue
Return Format	<NR1>, String, <NR1>, String, …
Example	-> :SYSTem:ERRor:ALL? <- -102, "Syntax error", -108, "Parameter not allowed"

:SYSTem:ERRor:CODE[:NEXT]?¶

Syntax	:SYSTem:ERRor:CODE:NEXT?
Description	Queries next error code in the Error Queue
Parameter	None
Explanation	Queries next error code in the Error Queue
Return Format	<NR1>
Example	-> :SYSTem:ERRor:CODE? <- -102 -> :SYSTem:ERRor:CODE? <- -108

:SYSTem:ERRor:CODE:ALL?¶

Syntax	:SYSTem:ERRor:CODE:ALL?
Description	Queries all error codes in the Error Queue
Parameter	None
Explanation	Queries all error codes in the Error Queue
Return Format	<NR1>,<NR1>,…
Example	-> :SYSTem:ERRor:CODE:ALL? <- -102,-108

:SYSTem:ERRor:COUNt?¶

Syntax	:SYSTem:ERRor:COUNt?
Description	Queries the Error Queue number of elements
Parameter	None
Explanation	Queries the Error Queue number of elements
Return Format	<NR1>
Example	-> :SYSTem:ERRor:COUNt? <- 2

:SYSTem:ERRor:ENABle:ADD (<num>:<num>)¶

Syntax

:SYSTem:ERRor:ENABle:ADD (<num>:<num>)

Description

Add a range of error codes to be queued in the Error Queue

Parameter

Name	Type	Range	Default
<num>	Integer	-32768 to 32768	None

Explanation

Add a range of error codes to be queued in the Error Queue.

Example

-> :SYSTem:ERRor:ENABle:LIST?
<- (-499:-100,1:32767)
-> :SYSTem:ERRor:ENABle:ADD (-1000:-900)
-> :SYSTem:ERRor:ENABle:LIST?
<-  (-1000:-900,-499:-100,1:32767)

:SYSTem:ERRor:ENABle:DELete (<num>:<num>)¶

Syntax

:SYSTem:ERRor:ENABle:DELete (<num>:<num>)

Description

Delete a range of error codes to be queued in the Error Queue

Parameter

Name	Type	Range	Default
<num>	Integer	-32768 to 32768	None

Explanation

Delete a range of error codes to be queued in the Error Queue

Example

-> :SYSTem:ERRor:ENABle:LIST?
<- (-499:-100,1:32767)
-> :SYSTem:ERRor:ENABle:DELete (-199:-100)
-> :SYSTem:ERRor:ENABle:LIST?
<- (-499:-200,1:32767)

:SYSTem:ERRor:ENABle[:LIST]?¶

Syntax	:SYSTem:ERRor:ENABle:LIST?
Description	Queries the range of error codes to be queued in the Error Queue
Parameter	None
Explanation	Queries the range of error codes to be queued in the Error Queue
Return Format	(<NR1>:<NR1>,<NR1>:<NR1>)
Example	-> :SYSTem:ERRor:ENABle:LIST <- (-499:-100,1:32767)

Error Codes¶

Use the :SYSTem:ERRor:ALL? command to return all errors that have occurred. The errors returned have to following syntax <Error Code>,<Error Message>. The following table shows the error codes possible when interacting with OXYGEN software. SCPI defines the negative error codes, while the vendor specific error codes defined by DEWETRON GmbH are positive numbers (currently unused).

Error Code	Error Message	Description
0	No error
100	Command error
-102	Syntax error	Indicates that an unrecognized command or data type was encountered. For example, a string was received when the device does not accept strings.
-104	Data type error	The parser recognized a data element different than one allowed. For example, numeric or string data was expected but block data was encountered.
-108	Parameter not allowed	Indicates that less parameters were received than required for the header.
-109	Missing parameter	Indicates that more parameters were received than expected for the header
-113	Undefined header	Indicates the header is syntactically correct, but it is undefined for this specific device.
-114	Header suffix out of range	Indicates the value of a header suffix attached to a program mnemonic makes the header invalid.
-138	Suffix not allowed	Indicates that a suffix was encountered after a numeric element that does not allow suffixes.
-200	Execution error	General execution error.
-220	Parameter error	Indicates that a program data element related error occurred.
-221	Settings conflict	Indicates that a legal program data element was parsed but could not be executed due to the current device state.
-222	Data out of range	Indicates that a legal program data element was parsed but could not be executed because the interpreted value was outside the legal range defined by the devices.
-224	Illegal parameter value	Indicates that a program data element is ill-formed
-250	Mass storage error	Indicates that a mass storage error occurred.
-256	File name not found	Indicates that a legal program command or query could not be executed because the file name was not found on the media.
-294	Incompatible type
-300	Device-specific error
-350	Queue overflow
-400	Query error