
Section 9
:
Instrument Control Library (ICL)
Series 3700 System Switch/Multimeter Reference Manual
9-32
Document Number: 3700S-901-01 Rev. A / August 2007
channel.getlabel
Remarks
The parameter
ch_list
may contain more than one channel in it. If it does, a comma is
used to delineate the labels for the channels. The return string will list the labels in the
same order as the channels were specified.
The parameter string may contain ―slotX‖, where X equals 1 to 6, or ―allslots‖. It may
also contain a label. However, if the label exists, it will be in the returned response and
not the numerical channel number. For example, if Channel 1001 has a label of ―start‖,
then sending:
print(channel.getlabel("start"))
will print
"start"
and not the numeric of "1001".
An error will be generated if:
An empty parameter string.
a specified channel does not exist
Slot is empty.
Channel not on card.
a channel pattern is specified
the channel does not support a label setting
an analog backplane relay is specified
Command processing will stop as soon as an error is detected and a nil response will
be generated. No partial list of labels will be returned.
Also see
channel.setlabel
(on page 9-45)
Query commands
(on page 9-5)
Example
To query for the label of Channel 1 on Slot 1:
MyLabel = channel.getlabel("1001")
channel.getpole
Function
Queries the pole settings for the specified channels.
Usage
poles = channel.getpole(ch_list)
ch_list
: A string listing the channels to query for their pole setting
poles
: Returns a string consisting of the poles, comma separated, for ch_list