*ESE

34980A

*ESE

Syntax

*ESE <enable_value>

*ESE?

Description

This command enables bits in the enable register for the Standard Event Register group. The selected bits are then reported to bit 5 of the Status Byte Register.

For more information on the SCPI Status System for the Agilent 34980A, see Status System Introduction.

Parameters

Name

Type

Range of Values

Default Value

<enable_value>

Numeric

A decimal value which corresponds to the binary-weighted sum of the bits in the register (see table below).

This is a required parameter

Remarks

  • The following table lists the bit definitions for the Standard Event Register.

Bit Number

Decimal Value

Definition

0  Operation Complete

1

All commands prior to and including *OPC have been executed.

1  Not Used

Not Used

"0" is returned.

2  Query Error

4

The instrument tried to read the output buffer but it was empty. Or, a new command line was received before a previous query has been read. Or, both the input and output buffers are full.

3  Device Error

8

A self-test or calibration error occurred (an error in the -300 range or any positive error has been generated). For a complete listing of the error messages, see SCPI Error Messages.

4  Execution Error

16

An execution error occurred (an error in the -200 range has been generated).

5  Command Error

32

A command syntax error occurred (an error in the -100 range has been generated).

6  Not Used

Not Used

"0" is returned.

7  Power On

128

Power has been turned off and on since the last time the event register was read or cleared.

  • Use the <enable_value> parameter to specify which bits will be enabled. The decimal value specified corresponds to the binary-weighted sum of the bits you wish to enable in the register. For example, to enable bit 2 (decimal value = 4), bit 3 (decimal value = 8), and bit 7 (decimal value = 128), the corresponding decimal value would be 140 (4 + 8 + 128).

  • The *CLS (clear status) command will not clear the enable register but it does clear all bits in the event register.

  • An Instrument Preset (SYSTem:PRESet command) does not clear the bits in the Status Byte enable register.

Return Format

The query command reads the enable register and returns a decimal value which corresponds to the binary-weighted sum of all bits set in the register. For example, if bit 3 (decimal value = 8) and bit 7 (decimal value = 128) are enabled, the query command will return "+136".

Examples

The following command enables bit 4 (decimal value = 16) in the enable register. If an Execution Error occurs, this condition will be reported to the Status Byte Register (bit 5 will be set high).

*ESE 16

The following query returns which bits are enabled in the register.  

*ESE?

Typical Response:  +16

See Also

*ESR?