Keithley 3700 series Reference Manual page 182

Section 9: Instrument Control Library (ICL)
channel.pattern.setimage
Function
Usage
Remarks
9-38
Creates a channel pattern and associates it with the specified name.
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.
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.
Series 3700 System Switch/Multimeter Reference Manual
Document Number: 3700S-901-01 Rev. A / August 2007