:SYSTem:MPButton:QSPBack:TDR:FNAMe

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

Command Syntax

:SYSTem:MPButton:QSPBack:TDR: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:TDR:FNAMe?

Description

When the Multi-Purpose button is configured to run a unique SCPI (.scpi) script for each instrument mode, this command identifies the path and name of the TDR/TDT mode script. To select to use unique scripts, 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 and Demo Folders

User-Data Folders

The default user data 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.

The default demo folders for loading script files is in %DEMO_DIR%\SCPI Scripts\Multi-Purpose Button as shown in the following picture. It is good practice to include a path substitution string with the subfolders and filename. For example, %DEMO_DIR%\SCPI Scripts\Multi-Purpose Button\filename.

Including a path substitution string in the filename ensures that the file will be saved in (or loaded from) the desired folder. Failure to do so may result either in a file created in an parent folder or a file error. Do not append a filename extension as the extension is automatically added.

Demo Folders

Example Command Sequence

:SYSTem:MPButton:QSPBack:SSCRipt OFF  //  Separate script for each Instrument mode
:SYSTem:MPButton:QSPBack:EYE:FNAMe "%USER_DATA_DIR%\SCPI Scripts\EyeOpeningScript.scpi"  //  Script for Eye mode
:SYSTem:MPButton:QSPBack:JITTer:FNAMe "%USER_DATA_DIR%\SCPI Scripts\JitterScript.scpi"  //  Script for Jitter mode
:SYSTem:MPButton:QSPBack:OSCilloscope:FNAMe "%USER_DATA_DIR%\SCPI Scripts\ScopeScript.scpi"  //  Script for Scope mode
:SYSTem:MPButton:QSPBack:TDR:FNAMe "%USER_DATA_DIR%\SCPI Scripts\TDRScript.scpi"  //  Script for TDR/TDT mode
:SYSTem:MPButton:FUNCtion RSCRipt  //  Assign running s script to Multi-Purpose button