4-5
IM 701730-17E
Before Programming
4
4.3
Response
On receiving a query from the controller, this
instrument returns a response message to the
controller. A response message is sent in one of the
following two forms.
• Response Consisting of a Header and Data
If the query can be used as a program message
without any change, a command header is attached
to the query, which is then returned.
Example
:ACQUire:MODE?<PMT>
->
:ACQUire:MODE NORMAL<RMT>
• Response Consisting of Data Only
If the query cannot be used as a program message
unless changes are made to it (i.e. it is a query-only
command), no header is attached and only the data
is returned. Some query-only commands can be
returned after a header is attached to them.
Example
:MEASure:CHANnel1:PTOPeak:
VALue?<PMT>
-> 10.0E+00<RMT>
When Returning a Response without a Header
It is possible to remove the header from a response
consisting of a header and data. The
"COMMunicate:HEADer"
command is used to do
this.
Abbreviated Form
Normally, the lowercase part is removed from a
response header before the response is returned to
the controller. Naturally, the full form of the header can
also be used. For this, the
"COMMunicate:VERBose"
command is used. The
part enclosed by [ ] is also omitted in the abbreviated
form.
4.4
Data
Data
A data section comes after the header. A space must
be included between the header and the data. The
data contains conditions and values. Data is classified
as below.
Data
Description
<Decimal>
Value expressed as a decimal number
(Example: CH2’s probe attenuation
->
CHANnel2:PROBe 100
)
<Voltage><Time>
Physical value
<Frequency><Current>
(Example: Time axis range
->
TIMebase:TDIV 1US
)
<Register>
Register value expressed as either binary,octal, decimal
or hexadecimal
(Example: Extended event register value
->
STATus:EESE #HFE
)
<Character data>
Specified character string (mnemonic).
Can be selected from { }
(Example: CH2 input coupling
->
CHANnel2:COUPling {AC|DC|GND}
)
<Boolean>
Indicates ON/OFF. Set to ON, OFF or value
(Example: CH2 display ON
->
CHANnel2:DISPlay ON
)
<Character string data>
Arbitrary character string
(Example: Comment on screen-data output
->
HCOPy:COMMent "ABCDEF"
)
<Filename>
Gives the name of a file.
(Example: Name of file to be saved
->
FILE:SAVE:WAVeform:NAME "CASE1"
)
<Block data>
Arbitrary 8-bit data
(Example: Response to acquired waveform data
->
#800000010ABCDEFGHIJ
)
<Decimal>
<Decimal> indicates a value expressed as a decimal
number, as shown in the table below. Decimal values
are given in the NR form specified in ANSI X3. 42-
1975.
Symbol
Description
Example
<NR1>
Integer
125 –1 +1000
<NR2>
Fixed point number
125.0 –.90 +001.
<NR3>
Floating point number
125.0E+0 –9E–1 +.1E4
<NRf>
Any of the forms <NR1> to <NR3> is allowed.
• Decimal values which are sent from the controller to
this instrument can be sent in any of the forms to
<NR3>. In this case, <NRf> appears.
• For response messages which are returned from
this instrument to the controller, the form (<NR1> to
<NR3> to be used) is determined by the query. The
same form is used, irrespective of whether the value
is large or small.
• In the case of <NR3>, the
"+"
after the
"E"
can be
omitted, but the
"–"
cannot.
• If a value outside the setting range is entered, the
value will be normalized so that it is just inside the
range.
• If the value has more than the significant number of
digits, the value will be rounded.
4.3 Response/4.4 Data
