:SYSTem:MPButton:QSPBack:TDR:FNAMe
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
![](../../../Resources/Images/Common/user-defined-folders-FlexDCA.png)
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.
![](../../../Resources/Images/Common/demo-folders-FlexDCA.png)
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