Series 3700A System Switch/Multimeter Reference Manual
Section 11: TSP command reference
3700AS-901-01 Rev. D/June 2018
11-91
Example
channel.setforbidden("2002,2004,2006,2008")
Marks channels 2, 4, 6, and 8 of slot 2 as
forbidden to close.
channel.setforbidden("slot3")
Marks all channels and analog backplane relays
on slot 3 as forbidden to close.
Also see
(on page 11-46)
(on page 11-62)
channel.setlabel()
This function sets the label associated with a channel.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Instrument reset
Channel reset
Recall setup
Power cycle
Create configuration script
Save setup
No label
Usage
channel.setlabel("
channelList
", "
labelname
")
channelList
A string that lists the channel to which to set the label; the string cannot contain
spaces
labelname
A string that contains the label for the channel in
channelList
, up to 19 characters
Details
This command sets the label of the specified channel to the label value. The channel attributes
associated with the channel remain unchanged except for the label.
The label must be unique. In addition, it cannot be the same as the name of a channel pattern. If you
specify a label that already exists, an error message is generated that indicates a parameter error
and channel that that is already associated the specified label.
For example, channel one on slot 4 has a label of
start
. If you send
channel.setlabel("5001", "start")
, error code 1115, "Parameter error label already used
with channel 4001," is generated.
To clear a label, set it to an empty string (
""
).
After defining a label, you can use it to specify the channel instead of using the channel specifier.
Example 1
channel.setlabel("3001", "start")
channel.close("start")
print(channel.getclose("allslots"))
Sets the label for channel 1 on slot 3 to
"start" and closes "start".
Output:
3001
Example 2
channel.setlabel("3001", "")
Clears the label for channel 1 on slot 3 back
to "3001".
