Models 707B and 708B Switching Matrix Reference Manual
Section 7: Command reference
707B-901-01 Rev. A / August 2010
7-27
channel.getclose()
This function queries for the closed channels indicated by the channel list parameter.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function Yes
Usage
closed = channel.getclose(channelList)
closed
A string listing the channels that are currently closed
channelList
A string representing the channels that will be queried, including channel patterns
Details
If more than one channel is closed, they are semicolon-delimited in the string. When the
channelList
contains
a channel pattern, only the closed channels in that image are returned.
The
channelList
parameter indicates the scope of channels affected, and can include:
•
allslots
or
slotX
(where
X
equals 1 to 6 for Model 707B, or 1 for Model 708B)
•
Channel ranges, individual channels, or channel patterns
An error message is generated if an empty parameter string is specified or the scope of the channel list specified
contains no valid channels (for example, a channel list equaling "
slotX
" or "
allslots
").
If nothing is closed within the specified scope, a
nil
response is returned.
Example 1
channelList = "1A01:1H12"
channel.close("1A01")
print(channel.getclose(channelList))
channel.close("1C03")
print(channel.getclose(channelList))
For this example, assume there is a card or
pseudocard in Slot 1 with no previously closed
channels. The output is:
1A01
1A01;1C03
Example 2
channel.close("1B03:1B05")
print(channel.getclose("allslots"))
For this example, assume there is a card or
pseudocard in Slot 1 with no previously closed
channels. The output is:
1B03;1B04;1B05
Also see
(on page 7-19)