:DISK:SPARameter:FNAMe

Instrument:

DCA-X

DCA-M

Meas. mode:

Scope

Eye

Jitter

TDR

Flex Apps:

FlexDCA

Command Syntax

:DISK:SPARameter:FNAMe "<path substitution string>\S-Parameter Data\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%\S-Parameter Data.
"filename" is a string without the filename extension.

Query Syntax

:DISK:SPARameter:FNAMe?

Description

In TDR/TDT, Eye/Mask, and Oscilloscope modes, specifies a filename (including path) for saving S-parameters. The file name that you specify must not include a filename extension. The command argument must include a path substitution string. Use the :DISK:SPARameter:SAVE command to actually save the file. If the file already exists, use the :DISK:SPARameter:FWBehavior command to specify if existing S-parameter data in the file is handled. Use the query to determine the default S-parameter filename which is suggested based on the number of DUT ports. This command supports the DEFault common child command.

Default User Folder

The default folder for storing S-parameters files is in %USER_DATA_DIR%\S-Parameter Data as shown in this picture. It is good practice to include a path substitution string with the filename. For example, %USER_DATA_DIR%\S-Parameter Data\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.

Export File Types
File Type	Description
.s1p	One-port single-ended device data (S11 or S22)
.s2p	Two-port single-ended device data (S11, S21, S22, S12)
.s4p	Four-port single-ended device data
.txt	Identical to the .s1p file type except for the .txt filename extension.

Requires FlexDCA revision A.04.00 and above.

Example Command Sequence

:DISK:SPARameter:FNAMe "%USER_DATA_DIR%\S-Parameter Data\myfile"
:DISK:SPARameter:SAVE