Series 3700 System Switch/Multimeter Reference Manual
Section 9
:
Instrument Control Library (ICL)
Document Number: 3700S-901-01 Rev. A / August 2007
9-35
channel.open
Remarks
This function will open the specified channels for switching aspects. The items specified
in ch_list may include analog backplane relays. For the items specified to open, the
channels associated with them will open along with the associated analog backplane
relays for each. For channel patterns, the analog backplane relays that get opened are
the ones that were specified when the pattern was created (see channel.pattern.set and
channel.pattern.snapshot). However, for channels, they are the ones specified with the
channel.setbackplane function. Another option for getting analog backplane relays to be
opened by this command is to include them in the
ch_list
parameter.
This command has no effect on how the DMM is configured.
To open all channels on a specific slot, use ―slotX‖ where X = 1 to 6 in the parameter
string. To open all channels on all slots, use ―allslots‖ in the parameter string. Using
―allslots‖ has no effect on empty slots or slots that don‘t support the open command.
The ―allslots‖ only applies to slots with channels that support being opened and ignores
the ones that don‘t. This allows you to use ―allslots‖ to open all channels and not worry
about a
n error if one of the slots is empty or doesn‘t support open channels. Using
―slotX‖ has no effect on empty slots and doesn‘t generate an error.
The settling time and user delay associated with a channel will need to elapse before
the command completes (see
channel.getdelay
(on page 9-29)).
The parameter string may contain ―slotX‖, where X equals 1 to 6, or ―allslots‖.
An error will be generated if:
syntax error in parameter string.
an empty parameter string.
a specified channel or channel pattern is invalid
channel number does not exist for slot specified.
slot is empty.
channel pattern does not exist.
does not support being opened like a digital I/O channel.
channel is paired with another bank for a multi-wire application.
the slotX specified does not support open like a digital I/O card.
Once a parsing error is detected, the command stops processing and no channels are
opened. Channels open only if no syntax errors exist in parameter and all channels are
valid for opening.
Details
for delay time see
channel.setdelay
(on page 9-44)
for connection method see slot[X].connectionmethod
for forbidden channels see channel.setforbidden
for analog backplane relays with channels, see
channel.setbackplane
(on page 9-42)
for channels associated with a channel see
channel.getimage
(on page 9-30)
for channels associated with a channel pattern see
channel.pattern.getimage
(on page
9-37)
for channel states (open/close) see
channel.getstate
(on page 9-33)
for closed channels see
channel.getclose
(on page 9-27)
Also see
channel.exclusiveclose
(on page 9-21),
dmm.close
(on page 9-77),
dmm.open
(on page
9-106)