:SYSTem:MPButton:QSETup:FNAMe

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

Command Syntax

:SYSTem:MPButton:QSETup: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%\Setups.
  • "filename" is a string without the filename extension.

Query Syntax

:SYSTem:MPButton:QSETup:FNAMe?

Description

When the Multi-Purpose button is configured to load a setup file (.setx), this command identifies the path and name of the file. To configure the Multi-Purpose button to load an instrument setup file, use the :SYSTem:MPButton:FUNCtion command.

Default User Folder

User-Data Folders

The default folder for storing setup files is in %USER_DATA_DIR%\Setups as shown in this picture. It is good practice to include a path substitution string with the filename. For example, %USER_DATA_DIR%\Setups\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:QSETup:FNAMe "%USER_DATA_DIR%\Setups\EyeModeSetup"
:SYSTem:MPButton:FUNCtion LSETup

Requires FlexDCA revision A.04.50 and above.