Section 11: TSP command reference
channel.pattern.snapshot()
This function creates a channel pattern.
Type
TSP-Link accessible
Function
Yes
Usage
channel.pattern.snapshot("name")
name
Details
This command stores an image of presently closed channels and analog backplane relays and
associates them with the name parameter.
If name is already used for an existing channel pattern, that pattern is overwritten with the new pattern
channel image (if no errors occur). The DMM configuration associated with the pattern remains
unchanged.
The following restrictions exist when naming a channel pattern:
•
The name must contain only letters, numbers, or underscores
•
The name must start with a letter
•
The name is case sensitive
Examples of valid names:
•
Channels
•
Chans
•
chans
•
Path1
•
Path20
•
path_3
Examples of invalid names:
•
1path (invalid because it starts with a number)
•
my chans (invalid because it contains a space)
•
My,chans (invalid because it contains a comma)
•
Path1:10 ( invalid because it contains a colon)
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
•
The pattern name exceeds 19 characters or contains a space
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 does not invalidate the existing scan list.
11-82
Affected by
Instrument reset
Channel reset
Recall setup
Pole setting change
A string representing the name to associate with the present state of channels and
analog backplane relays
Series 3700A System Switch/Multimeter Reference Manual
Where saved
Default value
Create configuration script
Not applicable
Save setup
3700AS-901-01 Rev. D/June 2018