:SYSTem:MPButton:QSPBack:FNAMe

Instrument:
N1010A
DCA-X
DCA-M
Meas. mode:
Scope
Eye
Jitter
TDR
Flex Apps:
FlexDCA
FlexRT
Multi-Purpose Commands

Command Syntax

:SYSTem:MPButton:QSPBack:FNAMe "<path substitution string>\subfolder\filename"

Where:

  • "<path substitution string> is a string that expands into a specific file path. For example, %USER_DATA_DIR%.
  • "subfolder" is an optional path folder. For example, %USER_DATA_DIR%\SCPI Scripts.
  • "filename" is a string without the filename extension.

Query Syntax

:SYSTem:MPButton:QSPBack:FNAMe?

Description

When the Multi-Purpose button is configured to run a single SCPI script (.scpi) regardless of instrument mode, this command identifies the path and name of the script. To select to use a single script, use the :SYSTem:MPButton:QSPBack:SSCRipt command. To configure the Multi-Purpose button to run a SCPI script file, use the :SYSTem:MPButton:FUNCtion command.

Requires FlexDCA revision A.04.50 and above.

Default User Folder

User-Data Folders

The default folder for storing script files is in %USER_DATA_DIR%\SCPI Scripts as shown in this picture. It is good practice to include a path substitution string with the filename. For example, %USER_DATA_DIR%\SCPI Scripts\filename.

File names must include a path when using the child :FNAMe command. The :FNAMe command is not affected by a Default Setup or Factory Preset.

Specifying a path using a path substitution string in the filename ensures that the file will be saved in (or loaded from) the standard user-data folder. Failure to use a path substitution string may result either in a file created in an parent folder or a file error.

Example Command Sequence

:SYSTem:MPButton:QSPBack:SSCRipt ON  //  Single script for all instrument modes
:SYSTem:MPButton:QSPBack:FNAMe "%USER_DATA_DIR%\SCPI Scripts\MyScript.scpi"  //  Assign running a script to Multi-Purpose button