Section 7: Command reference
Models 707B and 708B Switching Matrix Reference Manual
7-24
707B-901-01 Rev. A / August 2010
channel.exclusiveclose()
This function closes the specified channels and channel patterns so that they are exclusively closed.
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 bundle the closing of channels with opening. Any presently closed channel opens if
it is not specified to be closed in the parameter. This guarantees that only the specified items are closed on the
slots specified in the parameters list.
Actions associated with this function include:
•
Opens previously closed channels if they are no longer specified for closure, and then closes the
channels in
channelList
.
•
Incur settling and user-specified delay times depending on the connection rules.
If the
channelList
parameter is an empty string or a string of spaces, all channels that are closed are opened.
Therefore, when channels are closed, sending
channel.exclusiveclose("")
is equivalent to
channel.open(channel.getclose("allslots"))
.
An error is generated if:
•
The parameter string contains
slotX
, where
X
equals 1 to 6 for Model 707B, or 1 for Model 708B or
allslots
•
A specified channel or channel pattern is invalid
•
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"))
