Model 2601B-PULSE System SourceMeter Instrument Reference Manual Section 11: TSP command reference
2601B-PULSE-901-01A April 2020 11-159
script.load()
This function creates a script from a specified file.
Usage
scriptVar = script.load("file")
scriptVar = script.load("file", "name")
The created script; this is nil if an error is encountered
The path and file name of the script file to load
The name of the script to be created
Details
The file path may be absolute or relative to the current working directory. The root folder of the USB
flash drive has the absolute path "/usb1/". Both the forward slash (/) and backslash (\) are
supported as directory separators.
The file to be loaded must start with the loadscript or loadandrunscript keywords, contain the
body of the script, and end with the endscript keyword.
Script naming:
• If the name parameter is an empty string, or name is absent (or nil) and the script name cannot
be extracted from the file, scriptVar is the only handle to the created script.
• If name is given (and not nil), any script name embedded in the file is ignored.
• If name conflicts with the name of an existing script in the script.user.scripts table, the
existing script’s name attribute is set to an empty string before it is replaced in the
script.user.scripts table by the new script.
• If name is absent or nil, the command attempts to extract the name of the script from the file.
Any conflict between the extracted name and that of an existing script in the scripts table
generates an error. If the script name cannot be extracted, the created script's name attribute is
initialized to the empty string and must be set to a valid nonempty string before saving the script
to nonvolatile memory.
Example
myTest8 =
script.load("/usb1/filename.tsp",
"myTest8")
Loads the script myTest8 from the USB
flash drive.
Also see
script.new() (on page 11-160)