
Section 8: TSP command reference
Model 2461 Interactive SourceMeter® Instrument Reference Manual
8-140
2461-901-01 A/November 2015
smu.measure.configlist.recall()
This function recalls a configuration index in a measure configuration list and an optional source configuration list.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
smu.measure.configlist.recall(
listName
)
smu.measure.configlist.recall(
listName
,
index
)
smu.measure.configlist.recall(
listName
,
index
,
sourceListName
)
smu.measure.configlist.recall(
listName
,
index
,
sourceListName
,
sourceIndex
)
listName
A string that represents the name of a measure configuration list
index
A number that defines a specific configuration index in the measure configuration list
sourceListName
A string that represents the name of a source configuration list
sourceIndex
A number that defines a specific configuration index in the source configuration list
Details
Use this command to recall the settings stored in a specific configuration index in a measure
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 measure configuration list.
You can optionally specify a source configuration list and index to recall with the measure settings. If
you do not specify a source index, the source index defaults to match the measure index. Specify a
measure and source 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 the source and measure
configuration lists coordinated, you can specify just the measure configuration list with this command
and use the
smu.source.configlist.recall()
(on page 8-180) command to recall source 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. A single index stores the settings
associated with a single measure or digitize function.
If you are going 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.
For additional information about the information this command recalls when using a configuration list
query command, see
Instrument settings stored in a measure configuration list
(on page 3-33).