248 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
8 :BUS<n> Commands
:BUS<n>:LABel
(see page 1138)
Command Syntax
:BUS<n>:LABel <quoted_string>
<quoted_string> ::= any series of 10 or less characters as a
quoted ASCII string.
<n> ::= An integer, 1 or 2, is attached as a suffix to BUS
and defines the bus that is affected by the command.
The :BUS<n>:LABel command sets the bus label to the quoted string.
Setting a label for a bus will also result in the name being added to the
label list.
Query Syntax
:BUS<n>:LABel?
The :BUS<n>:LABel? query returns the name of the specified bus.
Return Format
<quoted_string><NL>
<quoted_string> ::= any series of 10 or less characters as a
quoted ASCII string.
See Also • "Introduction to :BUS<n> Commands" on page 242
• ":BUS<n>:BIT<m>" on page 243
• ":BUS<n>:BITS" on page 244
• ":BUS<n>:CLEar" on page 246
• ":BUS<n>:DISPlay" on page 247
• ":BUS<n>:MASK" on page 249
• ":CHANnel<n>:LABel" on page 269
• ":DISPlay:LABList" on page 306
• ":DIGital<d>:LABel" on page 292
Example Code
' Set the bus 1 label to "Data":
myScope.WriteString ":BUS1:LABel 'Data'"
This command is only valid for the MSO models.
Label strings are 10 characters or less, and may contain any commonly used ASCII
characters. Labels with more than 10 characters are truncated to 10 characters.