Tektronix DSA8300, Programmer'S Manual

Page: 21 / 455

Command Syntax
When concatenating commands and queries, you must follow these rules:
Separate completely different headers by a semicolon and by the beginning
colon on all commands except the
fi rst one. For example, the commands
TRIGger:MODe EYE
and
ACQuire:NUMAVg 10
, can be concatenated into
the following single command:
TRIGger:MODe EYE;:ACQuire:NUMAVg 10
If concatenated commands have headers that differ by only the last mnemonic,
you can abbreviate the second command and eliminate the beginning colon.
For example, you can concatenate the commands
ACQuire:MODe ENVelope
and
ACQuire:NUMAVg 10
into a single command:
ACQuire:MODe ENVelope; NUMAVg 10
The longer version works equally well:
ACQuire:MODe ENVelope;:ACQuire:NUMAVg 10
Never precede a star (*) command with a colon:
ACQuire:MODe ENVelope;*OPC
Any commands that follow will be processed as if the star command was not
there so the commands,
ACQuire:MODe ENVelope;*OPC;NUMAVg 10
will
set the acquisition mode to envelope and set the number of acquisitions for
averaging to 10.
When you concatenate queries, the responses to all the queries are
concatenated into a single response message. For example, if the TDR step
state for channel 1 is on and it's polarity is negative, the concatenated query
:TDR:CH1:STEP:STATE?;POLARITY?
will return the following.
If the header is on:
:TDR:CH1:STEP:STATE 1 :TDR:CH1:STEP:POLARITY MINUS
If the header is off:
1;MINUS
Set commands and queries may be concatenated in the same message. For
example,
ACQuire:MODe SAMple;NUMAVg?;STATE?
is a valid message that sets the acquisition mode to sample. The message then
queries the number of acquisitions for averaging and the acquisition state.
Concatenated commands and queries are executed in the order received.
Here are some invalid concatenations:
DISplay:STYle:NORMal;ACQuire:NUMAVg 10
(no colon before ACQuire)
DSA8300 Programmer Manual 2-5