Interactive SourceMeter® Instrument Reference Manual Section 6:
2461-901-01 A/November 2015 6-77
Details
Use this command to recall the settings stored in a measure configuration index in a specific
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 :SOURce[1]:CONFiguration:LIST:RECall (on page 6-86) 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. To see what settings are going to be recalled
with an index, use the :SENSe[1]:CONFiguration:LIST:QUERy? command.
Note: 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).
Example
:SENSe:CONF:LIST:RECall "MyMeasList", 5
Recalls configuration index 5 in a configuration
list named
.
:SENSe:CONF:LIST:RECall "MyMeasList"
Because an index was not specified, this
command recalls configuration index 1 from a
configuration list named
.
Also see
Configuration lists (on page 3-30)
[:SENSe[1]]:CONFiguration:LIST:CREate (on page 6-74)
[:SENSe[1]]:CONFiguration:LIST:STORe (on page 6-78)
[:SENSe[1]]:CONFiguration:LIST:SIZE?
This command returns the size (number of configuration indexes) of a measure configuration list.
Type Affected by Where saved Default value
Query only Not applicable Not applicable Not applicable
Usage
[:SENSe[1]]:CONFiguration:LIST:SIZE? "<name>"
A string that represents the name of a measure configuration list