1257 User Manual
Advanced SCPI Operations 7-4
EADS North America Defense
Test and Services, Inc.
©
2001
INCL? (@1(8))
returns the reply:
(@1(7:10))
Note that the reply maintains the order in which the include group
was defined. That is, the reply begins with channel 7, even though
the query was sent for channel 8.
C)
If multiple channels are specified in the query, and the
channels reside on different include lists, then multiple lists
will be returned in the reply. The lists will be separated from
each other by a comma. For example, the command:
INCL? (@1(3),1(19),1(23))
returns the reply:
(@1(3,5)),(@1(16,19)),(@1(14,23))
and the reply:
INCL?
returns the reply:
(@1(3,5)),(@1(7:10)),(@1(16,19)),
(@1(14,23))
The INCLUDE? query with no parameters passed returns all
presently defined include groups. Each group is separated from
each other by a comma. Note that if there are many include lists
defined, the query may result in a reply which is longer than the
length of the output reply buffer (1024 characters). In this case, the
“Query Interrupted” error will be placed on the error queue and the
output reply buffer will be cleared. To avoid this, always specify a
channel list with this query.
The reply to the INCLUDE? query does NOT contain module
names, nor does it contain path names. In addition, when 3 or
more consecutive channels are defined in the include list, the reply
will represent the channels as a range of channels, with a colon (:)
between the first and last channels in the range.
For example, if the following commands are executed:
MODULE:DEFINE matrix,1
INCLUDE
(@matrix(14,103,104,105,106))
then the query:
INCLUDE? (@matrix(105))
returns the reply:
(@1(14,103:106))
Summary of Contents for 1257
Page 6: ......
