Section 7: TSP command reference
Models 707B and 708B Switching Matrix Reference Manual
7-22
707B-901-01 Rev. B / January 2015
channel.exclusiveclose()
This function closes the specified channels so that they are the only channels that are closed on the instrument.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
channel.exclusiveclose(
channelList
)
channelList
A string listing the channels and channel patterns to exclusively close
Details
This command allows you to close specific channels and open any other channels on the instrument.
When you send this command, any presently closed channel opens if it is not specified to be closed
in the parameter. When you send this command:
•
Any presently closed channels that are not specified in
channelList
are opened.
•
The channels in
channelList
are closed.
•
Settling and user-specified delay times are applied as defined by the connection rules and delay
settings.
If the
channelList
parameter is an empty string or a string of spaces, all channels are opened.
Therefore, sending
channel.exclusiveclose("")
is equivalent to
channel.open(channel.getclose("allslots"))
. However, sending the equivalent
commands when nothing is closed generates an error because
nil
(the response of
channel.getclose("allslots")
) is being sent to the open command.
An error is generated if:
•
The parameter string contains
slot
X
, where X = 1 to 6 or
allslots
•
A specified channel or channel pattern is invalid
•
Channel number does not exist for slot specified
•
Slot is empty
•
A forbidden item is specified
Once an error is detected, the command stops processing. Channels open or close only if no errors
are found.
Example
channel.exclusiveclose("")
channel.close("1D01,1E12")
print(channel.getclose("slot1"))
channel.pattern.setimage("1B02,1B04,1B06", "myChans")
channel.exclusiveclose("1A01:1A05, 1C03, myChans")
print(channel.getclose("slot1"))