Keithley 2600a series User Manual

2600AS-901-01 Rev. B / September 2008 Return to Section Topics 19-43
Series 2600A System SourceMeter® Instruments Reference Manual Section 19: Remote Commands
display.loadmenu.add
Function Adds an entry to the “USER TESTS” submenu of the “LOAD TEST” menu.
TSP-Link
accessibility
This function can be accessed from a remote TSP-Link node.
Usage There are two ways to use this function:
display.loadmenu.add(displayname, chunk)
display.loadmenu.add(displayname, chunk, memory)
displayname Name to display in the menu.
chunk Chunk is the code to be executed.
memory Save or don’t save chunk and displayname in
nonvolatile memory.
Set memory to one of the following values:
0 or display.DONT_SAVE
1 or display.SAVE
The default memory setting is display.SAVE.
Remarks • This function adds an entry to the “USER TESTS” submenu of the “LOAD TEST” menu. If the
given item is subsequently selected via the front panel, the chunk will be executed when the
RUN key is pressed.
• The chunk can be made up of scripts, functions, variables, and commands. With memory set to
display.SAVE, commands are saved with the chunk in nonvolatile memory. Scripts, functions
and variables used in the chunk are not saved by display.SAVE. Functions and variables
need to be saved along with the script (see
Loading and saving a user script in Section 11). If the
script is not saved in nonvolatile memory, it will be lost when the Series 2600A is turned off. See
Example 1 below.
• It does not matter what order the menu items are added. They will be displayed in alphabetical
order when the “USER TESTS” menu is selected.
Details See Load test menu in Section 11.
Also see display.loadmenu.delete
Examples Example 1: Assume a script with a function named “DUT1” has already been loaded into the
Series 2600A, and the script has NOT been saved in nonvolatile memory.
Now assume you want to add a test named “Test” to the USER TESTS menu. You want the test to
run the function named “DUT1” and sound the beeper. The following command will add “Test” to the
menu, define the chunk, and then save displayname and chunk in nonvolatile memory:
display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE)
When “Test” is run from the front panel USER TESTS menu, the function named “DUT1” will
execute and the beeper will beep for two seconds.
Now assume you cycle power on the Series 2600A. Since the script was not saved in nonvolatile
memory, the function named “DUT1” is lost. When “Test” is again run from the front panel, the
beeper will beep, but “DUT1” will not execute because it no longer exists in the chunk.
Example 2: Adds entry called “Part1” to the front panel “USER TESTS” load menu for the chunk
“testpart([[Part1]], 5.0)”, and saves it in nonvolatile memory:
display.loadmenu.add("Part1", "testpart([[Part1]], 5.0)", display.SAVE)

Keithley 2600a series Specifications

General

Brand	Keithley
Model	2600a series
Category	Measuring Instruments
Language	English