User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-47
channel.getclose()
Remarks
The returned string lists the closed channels. If more than one channel is closed, they
are comma delimited in the string. If ch_list equals 'slotX' where X is 1 to 6,
the response indicates the channels that are closed on that specific slot, along with
any backplane relays. Likewise, if ch_list equals 'allslots', the response
indicates all channels and analog backplane relays that are closed within the system.
For channels, the format is SCCC (MUX channels) or SRCC (matrix channels). When
the channel list contains a channel pattern, only the channels in that image which are
closed are returned.
If a single slot is being queried and that slot is empty or does not support the close
channel concept, the response is an empty string, meaning no channels are closed on
that slot. This allows you to use 'allslots' to query for all channels closed and
not worry about an error if one of the slots is empty or does not support close
channels.
The ch_list parameter indicates the scope of channels affected and can include:
allslots or slotX (where X equals 1 to 6).
Channel ranges, individual channels, or channel patterns.
Analog backplane relays.
If nothing is closed within the specified scope, a nil response is returned.
An error is generated if:
There is a syntax error in a parameter string.
An empty parameter string is specified.
A non-existent channel or analog backplane relay is specified.
A non-existent channel pattern is specified.
Channels of type DAC, totalizer, and digital I/O are omitted from the list.
Also see
channel.close() (on page 13-37)
channel.exclusiveclose() (on page 13-41)
channel.getstate() (on page 13-56)
channel.open() (on page 13-59)
channel functions and attributes (on page 13-24)
Query commands (on page 13-6)