Keithley 2601 Reference Manual page 288

Section 12: Instrument Control Library
display.loadmenu.add
Function Adds an entry to the "USER TESTS" submenu of the "LOAD TEST" menu.
There are two ways to use this function:
Usage
display.loadmenu.add(displayname, chunk)
display.loadmenu.add(displayname, chunk, memory)
displayname
chunk
memory
non-volatile memory.
0 or display.DONT_SAVE
1 or display.SAVE
The default
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
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 non-volatile 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
in Section
Series 2600 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
Also see display.loadmenu.delete
Examples Example 1 – Assume a script with a function named "DUT1" has already been loaded into
the Series 2600, and the script has NOT been saved in non-volatile 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 non-
volatile 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 2600. Since the script was not saved in non-
volatile 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 non-volatile memory:
display.loadmenu.add("Part1", "testpart([[Part1]], 5.0)",
display.SAVE)
display.loadmenu.delete
Function Deletes an entry from the "USER" submenu of the "LOAD TEST" menu.
Usage
display.loadmenu.delete(displayname)
displayname
Remarks This function is used to delete an entry (displayname) from the front panel USER
TESTS submenu of the LOAD TEST menu.
Details See "Load test
Also see display.loadmenu.add
Example Removes the entry named "Part1" from the front panel "USER TESTS" load menu:
display.loadmenu.delete("Part1")
12-28
Set memory to one of the following values:
setting is
memory display.SAVE
14). If the script is not saved in non-volatile memory, it will be lost when the
menu" in Section 14.
menu" in Section 14.
Return to Section Topics
Series 2600 System SourceMeter® Instruments Reference Manual
Name to display in the menu.
Chunk is the code to be executed.
Save or don't save
chunk
.
Name to remove from the menu.
and in
displayname
w
ill be executed
"Saving a user script"
2600S-901-01 Rev. C / January 2008