User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-74 3700S-901-01 Rev. C / July 2008
channel.setforbidden()
Function
Prevents the closing of specified channels.
Usage
channel.setforbidden(<ch_list>)
ch_list: A string listing the channels to make forbidden to close.
Remarks
The ch_list parameter indicates the scope of channels affected and may include:
allslots or 'slotX' (where X equals 1 to 6).
Channel ranges or individual channels
Analog backplane relays.
This function prevents all items contained in the channel list parameter from closing
(applies the "forbidden to close" attribute to channels specified ). To remove the
"forbidden to close" attribute, use channel.clearforbidden (on page 13-36).
An error will be generated if:
The specified channel or analog backplane relay does not exist for card installed in
a slot.
The specified channel or analog backplane relay is for an empty slot.
There is a parameter syntax error in the channel specified.
An empty channel list is parsed.
Command processing will stop as soon as an error is detected. If an error is found, the
forbidden setting is not updated. With no errors, items in the list are marked as being
forbidden to close. The previous ones are not lost.
After the forbidden list is updated, the existing channel patterns are reviewed. Any of
the patterns that contain an item (channel or analog backplane relay) that is now
forbidden to close will be deleted. A channel pattern may be specified in the channel
list parameter. However, doing this will cause the pattern to be deleted because it
contains items that are forbidden to close.
Making a channel or backplane forbidden that is involved in scanning invalidates the
existing scan list.
Also see
channel.clearforbidden() (on page 13-36)
channel.getforbidden() (on page 13-50)
Example
To mark Channels 2, 4, 6, and 8 of Slot 2 as forbidden to close:
channel.setforbidden('2002,2004,2006,2008')
To mark Slot 3 as forbidden to close:
channel.setforbidden('slot3')
channel.setlabel()
Function
Sets the label associated with a channel.
Usage
channel.setlabel(<ch_list>, label)
ch_list: A string listing the channel to set the label associated with it.
Label: A string representing the label for items in ch_list.