![background image](http://html1.mh-extra.com/html/keithley/3700-series/3700-series_reference-manual_3931523182.webp)
Section 9
:
Instrument Control Library (ICL)
Series 3700 System Switch/Multimeter Reference Manual
9-38
Document Number: 3700S-901-01 Rev. A / August 2007
channel.pattern.setimage
Function
Creates a channel pattern and associates it with the specified name.
Usage
channel.pattern.setimage(ch_list, name)
ch_list
A string listing the channels, channel patterns and/or analog backplane relays to
use when creating the new channel pattern.
Name
A string representing the name to associate with the new channel pattern.
Remarks
If the name specified is being used for an existing channel pattern then, that pattern will
be overwritten with the new pattern channel image if no errors occur. The previous
image associated with the name will be lost. The DMM configuration associated with the
pattern remains unchanged in this scenario.
An error will be 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 in the forbidden list.
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 will not be created if an error is detected. You may 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
may or may not be used in the current scan list). Creating a new pattern is okay.