Series 3700 System Switch/Multimeter Reference Manual
Section 9
:
Instrument Control Library (ICL)
Document Number: 3700S-901-01 Rev. A / August 2007
9-33
channel.getpole
Remarks
The parameter string may contain ―slotX‖, where X equals 1 to 6, or ―allslots‖.
An error message will be generated for the following reasons:
An empty parameter string.
The specified channel does not exist for card installed in slot.
Parameter syntax error such as incorrect format for ch_list.
A channel pattern was specified.
An analog backplane relay was specified.
Channel does not support pole setting like a digital I/O.
Command processing stops as soon as an error is detected. No partial list is returned.
The response will be the numerical value representing the pole selection and not the
text. For example, 4-pole selection will be 4 and not channel.POLES_FOUR.
For channels, the user manipulates the analog backplane relay channels for the desired
pole setting (see
channel.setbackplane
(on page 9-42)). Recall channel patterns do not
have a pole setting associated with them and have their analog backplane relay
channels specified when created (see
channel.pattern.getimage
(on page 9-37) and
channel.pattern.snapshot
(on page 9-40)).
When the channel list parameter for this function is
slotX
, the response will first list the
channels starting from lowest to highest.
When the channel list parameter for this function is
allslots
, the response will start with
Slot 1 and increase to Slot 6. Each slot is processed completely before going to the
next. Keeping this in mind, all Slot 1 channels are listed before Slot 2 channels.
If an error is detected, or the slot is empty, the response will be nil.
Also see
channel.setpole
(on page 9-46)
Query commands
(on page 9-5)
Example
To query channels 1 and 3 on Slot 5 for pole setting:
mypoles = channel.getpole("5001, 5003")
channel.getstate
Function
Queries for the state (opened or closed) for specified items.
Usage
mystate = channel.getstate(ch_list)
ch_list
: String listing the items to query. Items can include channels, backplane relays,
and channel patterns.
mystate
: String listing the states, comma delimited, for channels in
ch_list