Section 14: TSP command reference
2470 High Voltage SourceMeter Instrument Reference Manual
14-156
2470-901-01 Rev. A /
May
2019
smu.source.configlist.recall()
This function recalls a specific configuration index in a specific source configuration list and an optional measure
configuration list.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
smu.source.configlist.recall("
list
N
ame
",
index
)
smu.source.configlist.recall("
listName
",
index
, "
measureListName
")
smu.source.configlist.recall("
listName
",
index
, "
measureListName
",
measureIndex
)
listName
A string that represents the name of a source configuration list
index
A number that defines a specific configuration index in the source configuration list
measureListName
A string that represents the name of a measure configuration list
measureIndex
A number that defines a specific configuration index in the measure configuration list
Details
Use this command to recall the settings stored in a specific configuration index in a specific source
configuration list. If you do not specify an index when you send the command, it recalls the settings
stored in the first configuration index in the specified source configuration list of that index.
You can optionally specify a measure configuration list and index to recall with the source settings. If
you do not specify a measure index, the measure index defaults to match the source index. Specify a
source and measure list together with this command to allow the instrument to coordinate the
application of the settings in the two lists appropriately. If you do not need have the application of the
source and measure configuration lists coordinated, you can specify just the source configuration list
with this command and use the
smu.measure.configlist.recall()
(on page 14-118) command to recall
measure settings separately in your application.
If you recall an invalid index (for example, calling index 3 when there are only two indexes in the
configuration list) or try to recall an index from an empty configuration list, event code 2790,
"Configuration list, error, does not exist" is displayed.
Each index contains the settings for the selected function of that index. Settings for other functions
are not affected when the configuration list index is recalled. To see the settings that are recalled with
an index, use the
(on page 14-155) command.
Note:
To recall a source configuration list separately (not with this command), recall the source
configuration list before the measure configuration list. This order ensures that dependencies
between source and measure settings will be properly handled.
Example
smu.source.configlist.recall("MySourceList")
Because an index was not specified, this
command recalls configuration index 1
from a configuration list named
MySourceList
.
smu.source.configlist.recall("MySourceList", 5)
Recalls configuration index 5 in a
configuration list named
MySourceList
.
