Syntax Conventions; Parameter Types - Keysight Technologies N6705C Operating And Service Manual

7 SCPI Programming Reference

Syntax Conventions

Triangle brackets ( < > ) indicate that you must specify a value for the enclosed parameter. For
l
example, in the VOLTage <value> command syntax, the <value> parameter is enclosed in triangle
brackets. The brackets are not sent with the command string. You must specify a value for the
parameter (Example: "VOLTage 50V") unless you select another option shown in the syntax
(Example: "VOLTage MAX").
A vertical bar ( | ) separates multiple parameter choices for a given command string. For example,
l
RST|RCL0 in the OUTPut:PON:STATe command indicates that you can specify "RST" or "RCL0".
The bar is not sent with the command string.
Square brackets ( [ ]) enclose some syntax elements - nodes and parameters for example. This
l
indicates that the element is optional and can be omitted. The brackets are not sent with the com-
mand string. Any keyword enclosed in brackets is optional and can be omitted. However, if you are
combining several commands within the same message string as previously described, you must
include the optional commands to place the command parser at the correct level in the hierarchy.
Braces ( { }) indicate parameters that may be repeated zero or more times. It is used especially for
l
showing arrays. The notation <A>{,<B>} shows that parameter "A" must be entered, while para-
meter "B" may be omitted or may be entered one or more times

Parameter Types

The SCPI language defines several data formats to be used in commands and queries.
Channel Parameter
The channel parameter <chanlist> is required to address one or more channels. It has the following
syntax:
(@<channel> [,<channel>][,<channel>][,<channel>])
You can also specify a range of sequential channels as follows:
(@<start_channel>:<end_channel>)
For example, (@2) specifies channel 2 and (@1:3) specifies channels 1 through 3. The channel list,
shown as <chanlist> throughout this document, must be preceded with the @ symbol and must be
enclosed in parentheses (). A maximum of 4 channels may be specified through a combination of single
channels and ranges. Query results are channel list order-sensitive. Results are returned in the order
they are specified in the list.
When adding a channel list parameter to a query, you must include a space character
between the query indicator (?) and the channel list parameter. Otherwise error –103,
Invalid separator will occur.
228 Keysight N6705C Operating and Service Guide