Section 9
:
Instrument Control Library (ICL)
Series 3700 System Switch/Multimeter Reference Manual
9-22
Document Number: 3700S-901-01 Rev. A / August 2007
channel.exclusiveclose
Remarks
This function manipulates the channels and analog backplane relays for switching
aspects so
only
those specified by
ch_list
are closed.
Actions associated with this function include:
opens previously closed channels and analog backplane relays if they are no longer
being specified for closure, then closes the desired channels and analog backplane
relays as indicated by the items in
ch_list.
settling times will be incurred before command processing is complete. The function
has no effect on how the DMM is configured and does not use analog backplane
relays associated with DMM configuration.
analog backplane relays may be specified in parameter list.
For channel patterns, the analog backplane relays that get manipulated (closed or
opened) are the ones that were specified when the pattern was created (see
channel.pattern.setimage
(on page 9-38)). However, for channels, they are the ones
specified with the
channel.setbackplane
(on page 9-42) function. Another option for
getting analog backplane relays closed by the command is to include them in the ch_list
parameter.
If the channel list parameter is an empty string or a string of spaces then, all channels
and analog backplane relays that are closed will be opened. Therefore, when channels
or backplane relays are closed, sending
channel.exclusiveclose("")
is
equivalent to
channel.open(channel.getclose("allslots"))
However, sending the equivalent commands when nothing is closed generates an error
since nil (the response of channel.getclose('allslots') is being sent to the open command.
Remarks
(continued)
An error will be generated if
syntax error in parameter string.
the parameter string contains ―slotX‖, where X = 1 to 6, or ―allslots‖.
a specified channel or channel pattern is invalid.
channel number does not exist for slot specified.
slot is empty.
channel pattern does not exist.
a forbidden item is specified
does not support being closed like a digital I/O channel.
channel is paired with another bank for a multi-wire application.
Once an error is detected, the command stops processing. Channels will open or close
only if no errors are found and will remain unchanged with any parsing or syntax error.
This command allows you to bundle the closing of channels with opening since any
currently closed channel or analog backplane relay will open if not specified for closure
in the parameter. It guarantees that only the specified items are closed and no others.
