User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-64 3700S-901-01 Rev. C / July 2008
channel.pattern.setimage()
Remarks
If the name specified is being used for an existing channel pattern, that pattern is
overwritten with the new pattern channel image if no errors occur. The previous image
associated with the name is lost. The DMM configuration associated with the pattern
remains unchanged in this scenario.
An error is generated if
The name parameter already exists as a label.
An invalid channel is specified in the channel list parameter.
Slot is empty.
Channel does not exist on slot specified.
Channel is forbidden to close.
A non-existent channel pattern is specified in channel list parameter.
A syntax error exists in either parameter.
Insufficient memory exists to create the channel pattern.
The parameter string contains 'slotX', where X equals 1 to 6, or 'allslots'.
The name parameter contains a space character.
Pattern name exceeds 20 characters.
The channel pattern is not created if an error is detected. You can create a channel
pattern with an empty ch_list parameter (this would be equivalent to an open
all).
A channel pattern must include the analog backplane relays as well as desired
channels. Once a channel pattern is created, the only way to add a channel or analog
backplane relay to an existing pattern is to delete the old and recreate with the new
desired items. Or, include the additional channel(s) or analog backplane relay(s) in the
channel parameter list with the channel pattern when using.
Issuing this function on an existing pattern invalidates the existing scan list (the pattern
might or might not be used in the current scan list). Creating a new pattern is okay.
Including any channels of type digital I/O, DAC, and totalizer generates an error.