Tektronix KEITHLEY 707B, Reference Manual

Page: 462 / 534

Models 707B and 708B Switching Matrix Reference Manual Section 7: TSP command reference
707B-901-01 Rev. B / January 2015 7-231
tspnet.execute()
This function sends a command string to the remote device.
Type TSP-Link accessible Affected by Where saved Default value
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 The connection ID returned from
tspnet.connect()
commandString
The command to send to the remote device
value1
The first value decoded from the response message
value2 The second value decoded from the response message
valueN The
N
th 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
formatString Format string for the output
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 Models 707B and 708B 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 Model 707B or 708B suspends
operation until a timeout error is generated or until the instrument responds. The TSP prompt from the
remote instrument is read and discarded. The Model 707B or 708B 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()") Command the remote
device to run a script
named
runScript
.
Example 2
tspnet.termination(instrumentID, tspnet.TERM_CRLF)
tspnet.execute(instrumentID, "*idn?")
print("tspnet.execute returns:", tspnet.read(instrumentID))
Print the
*idn?
string from
the remote device.
Also see
tspnet.connect() (on page 7-229)
tspnet.read() (on page 7-232)
tspnet.termination() (on page 7-234)
tspnet.write() (on page 7-239)