Agilent X-Series Signal Generators SCPI Command Reference
13
SCPI Basics
SCPI Basics
File Name Variables
File name variables designate a data file and file path. File name variables are used in the SCPI
command syntax whenever files are accessed. The name of the file is always required, but the file
path can sometimes be optional or be designated using different formats. The following table shows
these different file path formats:
Formats 2–4 offer programming flexibility and are equivalent. Format 1 can only be used with SCPI
commands that imply the path name as part of the command syntax. Typically, SCPI load commands
that access user- data files do not need to have a file path designated.
See
Table 1- 4 on page 15
for information on file types and directories.
NOTE
The maximum length for a file name is 23 characters, excluding the file path.
Example
Using Format 1
:CORR:FLAT:LOAD "FLAT_DATA
"
The preceding example loads user- flatness data from a file called
FLAT_DATA
located in the
USERFLAT
directory. No file path is needed as the command syntax implies the directory where the file is
located.
Example
Using Format 2
:MEM:COPY "IQ_DATA@SNVWFM","Test_DATA@WFM1"
The preceding example copies a file named IQ_DATA located in the
WAVEFORM
directory to a file
named Test_DATA in volatile waveform memory (
BBG
).
Example
Using Format 3
:MEM:COPY "SNVWFM:IQ_DATA","WFM1:Test_DATA"
The preceding example copies a file named IQ_DATA located in the
WAVEFORM
directory to a file
named Test_DATA in volatile waveform memory (
BBG
).
Format
File Name Variable
Example
Format 1
"<file name>"
"Test_Data"
Format 2
"<file name@msus>"
"Test_Data@SEQ"
a
a.Included for backwards compatibility. Not a recommended syntax.
Format 3
"<msus:file name>"
"SEQ:Test_Data"
Format 4
"</user/directory/file name>"
"/USER/SEQ/Test_Data"
