16 Agilent X-Series Signal Generators SCPI Command Reference
SCPI Basics
SCPI Basics
The variable "<msus>" is replaced with "LIST:". When the command is executed, the output displays
only the files from the List file system.The following examples illustrate the usage of the variable
"<file name>" with the variable "<msus>":
The command from the above example cannot discern which file system LIST_1 belongs to without a
file system specifier and will not work without it. When the command is properly executed, LIST_1 is
deleted from the List file system.
The following example shows the same command, but using Format 2 from the File Name Variables
section on page 13:
:MMEMory:DELete:NAME "LIST_1@LIST"
When a file name is a parameter for a command that is not file system specific, either format ("<file
name>","<msus>" or "<file name@msus>") will work.
Refer to Table 1- 4 on page 15 for a listing of the file systems and types.
Quote Usage with SCPI Commands
As a general rule, programming languages require that SCPI commands be enclosed in double quotes
as shown in the following example:
":FM:EXTernal:IMPedance 600"
However when a string is the parameter for a SCPI command, additional quotes or other delimiters
may be required to identify the string. Your programming language may use two sets of doublequotes,
one set of single quotes, or back slashes with quotes to signify the string parameter. The following
examples illustrate these different formats:
"MEMory:LOAD:LIST ""myfile""" used in BASIC programming languages
"MEMory:LOAD:LIST \"myfile\"" used in C, C++, Java, and PERL
"MEMory:LOAD:LIST 'myfile'" accepted by most programming languages
Consult your programming language reference manual to determine the correct format.
Binary, Decimal, Hexadecimal, and Octal Formats
Command values may be entered using a binary, decimal, hexadecimal, or octal format. When the
binary, hexadecimal, or octal format is used, their values must be preceded with the proper identifier.
The decimal format (default format) requires no identifier and the signal generator assumes this
format when a numeric value is entered without one. The following list shows the identifiers for the
formats that require them:
• #B identifies the number as a binary numeric value (base- 2).
• #H identifies the number as a hexadecimal alphanumeric value (base- 16).
Command Syntax with the file name and msus variables
:MMEMory:DELete[:NAME] "<file name>",["<msus>"]
Command Syntax with the file name and file system
:MMEMory:DELete:NAME "LIST_1","LIST:"