Tspnet.execute() - Keithley 2601B Reference Manual

Series 2600B System SourceMeter® Instrument Reference Manual

tspnet.execute()

This function sends a command string to the remote device.
Type TSP-Link accessible
Function No
Usage
tspnet.execute(connectionID, commandString)
value1 = tspnet.execute(connectionID, commandString, formatString)
value1, value2 = tspnet.execute(connectionID, commandString, formatString)
value1, ..., valuen = tspnet.execute(connectionID, commandString, formatString)
connectionID
commandString
value1
value2
valuen
...
formatString
Details
This command sends a command string to the remote instrument. A termination is added to the command string
when it is sent to the remote instrument (tspnet.termination()). You can also specify a format string, which
causes the command to wait for a response from the remote instrument. The Series 2600B decodes the
response message according to the format specified in the format string and returns the message as return
values from the function (see tspnet.read() for format specifiers).
When this command is sent to a TSP-enabled instrument, the Series 2600B suspends operation until a timeout
error is generated or until the instrument responds, even if no format string is specified. The TSP prompt from the
remote instrument is read and thrown away. The Series 2600B places any remotely generated errors into its
error queue. When the optional format string is not specified, this command is equivalent to tspnet.write(),
except that a termination is automatically added to the end of the command.
Example 1
tspnet.execute(instrumentID, "runScript()")
Example 2
tspnet.termination(instrumentID, tspnet.TERM_CRLF)
tspnet.execute(instrumentID, "*idn?")
print("tspnet.execute returns:", tspnet.read(instrumentID))
Also see
tspnet.connect()
tspnet.read()
tspnet.termination()
tspnet.write()
2600BS-901-01 Rev. B / May 2013
Affected by
The connection ID returned from tspnet.connect()
The command to send to the remote device
The first value decoded from the response message
The second value decoded from the response message
The nth value decoded from the response message; there is one return value for
each format specifier in the format string
One or more values separated with commas
Format string for the output
(on page 7-367)
(on page 7-370)
(on page 7-372)
(on page 7-376)
Section 7: TSP command reference
Where saved Default value
Command the remote
device to run a script
named runScript.
Print the *idn? string from
the remote device.
7-369