Agilent Technologies InfiniiVision 3000 Programmer's Manual page 1094

38
More About Oscilloscope Commands
:<subsystem>:<function><separator><data>;<function><separator><data><ter
minator>
For example:
myScope.WriteString ":TIMebase:RANGe 0.5;POSition 0"
The colon between TIMebase and RANGe is necessary because TIMebase:RANGe is a
N O T E
compound command. The semicolon between the RANGe command and the POSition
command is the required program message unit separator. The POSition command does not
need TIMebase preceding it because the TIMebase:RANGe command sets the parser to the
TIMebase node in the tree.
Example 2:
myScope.WriteString ":TIMebase:REFerence CENTer;POSition 0.00001"
Program
or
Message
Terminator Sets
myScope.WriteString ":TIMebase:REFerence CENTer"
Parser Back to
myScope.WriteString ":TIMebase:POSition 0.00001"
Root
In the first line of example 2, the subsystem selector is implied for the POSition command in
N O T E
the compound command. The POSition command must be in the same program message as
the REFerence command because the program message terminator places the parser back
at the root of the command tree.
A second way to send these commands is by placing TIMebase: before the
POSition command as shown in the second part of example 2. The space
after POSition is required.
Example 3:
You can send multiple program commands and program queries for
Selecting different subsystems on the same line by separating each command with a
Multiple
semicolon. The colon following the semicolon enables you to enter a new
Subsystems
subsystem. For example:
<program mnemonic><data>;:<program mnemonic><data><terminator>
For example:
myScope.WriteString ":TIMebase:REFerence CENTer;:DISPlay:VECTors ON"
The leading colon before DISPlay:VECTors ON tells the parser to go back to the root of the
N O T E
command tree. The parser can then see the DISPlay:VECTors ON command. The space
between REFerence and CENter is required; so is the space between VECTors and ON.
Multiple commands may be any combination of compound and simple
commands.
1094 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide