User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-124 3700S-901-01 Rev. C / July 2008
dmm.close()
Remarks
The actions associate with this function includes:
Opens previously closed channels if they interfere with measurement including
analog backplane relays 1, 2, and common-side ohms on all slots, if needed. The
opening and closing of channels mimics that of channel.exclusiveslotclose() (on
page 13-43). Therefore, when using a for-loop with dmm.close() (on page 13-123)
command, the last channel on each slot will be closed at the end of the for loop
execution. To have additional analog backplane relays 3 through 6 closed, use
them on an alternate slot or if need to be on same slot then create a channel
pattern. To have additional channels closed, then use patterns. Using patterns, you
must specify all items to close, including analog backplane relays 1 and 2. With
patterns, there is no auto manipulation of analog backplane relays 1 and 2 like
there is with channels.
Any amp channels will open as well. If there is a need to have multiple amp
channels closed at a time then create a channel pattern.
Next, this command will close the associated channels and analog backplane
relays which include analog backplane relay 1 and 2 as needed based on
configuration associated with channel (see dmm.getconfig() (on page 13-139))
Analog backplane relays specified by channel.setbackplane() (on page 13-70) are
not used.
This command will configure the DMM based on the configuration associated with
the channel or channel pattern being closed (see dmm.getconfig() (on page 13-
139)). If the configuration is a default name, the function of that configuration will
be reset back to factory default settings. User must create a unique DMM
configuration to avoid using factory default settings when assigning to a channel
(see dmm.configure.set() (on page 13-129) and dmm.setconfig() (on page 13-168)
commands.)
Details
An error will be generated if:
There is a syntax error in parameter string.
An empty parameter string is specified.
The specified channel or channel pattern is invalid.
The channel number does not exist for slot specified.
The slot is empty.
The channel pattern does not exist.
A forbidden item is specified.
The specified channel does not support being closed (like a digital I/O channel).
More than 1 channel or channel pattern specified.
The channel is paired with another bank for a multi-wire application.
The channel is an analog backplane relay.
The channel‟s configuration is 'nofunction'.
Once an error is detected, the command stops processing. Channels will open and
close, and the DMM will be reconfigured only if no error is detected. Otherwise,
channels and DMM remain unchanged.
This command allows you to separate the closing of channels from measuring.
Therefore, you may execute any number of commands between the close and
measure commands to satisfy your application needs.