Agilent Technologies InfiniiVision 5000 Series Programmer's Manual page 602

11
More About Oscilloscope Commands
• A leading colon (<NL> or EOI true on the last byte) places the parser at
• In the command tree, use the last mnemonic in the compound header
The output statements in the examples are written using the Agilent VISA
COM library in Visual Basic. The quoted string is placed on the bus,
followed by a carriage return and linefeed (CRLF).
To execute more than one function within the same subsystem, separate
the functions with a semicolon (;):
:<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.
602
the root of the command tree. A leading colon is a colon that is the
first character of a program header. Executing a subsystem command
lets you access that subsystem until a leading colon or a program
message terminator (<NL>) or EOI true is found.
as the reference point (for example, RANGe). Then find the last colon
above that mnemonic (TIMebase:). That is the point where the parser
resides. Any command below that point can be sent within the current
program message without sending the mnemonics which appear above
them (for example, POSition).
Agilent InfiniiVision 5000 Series Oscilloscopes Programmer's Guide