User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-67
channel.pattern.snapshot()
Remarks
This command stores the image of closed and opened channels, along with analog
backplane relays in the system, and associates them with the name parameter in
persistent memory.
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.
Insufficient memory exists to save the channel pattern and name in persistent
memory.
Pattern name exceeds 20 characters or contains a space.
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.
Channels of type DAC, totalizer, and digital I/O are ignored.
Details
Not persistent through a power cycle. Channel patterns are stored when a
setup.save() (on page 13-254) command is executed. Use setup.recall()
(on page 13-253) to restore them.
NOTE See channel.pattern.setimage() (on page 13-63) for valid name
examples.
Also see
channel.pattern.catalog() (on page 13-61)
channel.pattern.delete() (on page 13-62)
channel.pattern.setimage() (on page 13-63)
Example
To take a snapshot of the current state and name it mysnapshot:
channel.pattern.snapshot("mysnapshot")
channel.read()
Function
Reads a value from a channel.
Usage
<value> = channel.read(<ch_list>, [<width>], [<rbuffer>])
value: Return string listing the comma-delimited states for channels in ch_list.
ch_list: String specifying channels to read using normal channel list syntax.
width: Optional value that specifies reading over multiple consecutive channels.
rbuffer: Optional reading buffer to store values read from the channel list.