:MTESt:LOAD:FNAMe

Instrument:
DCA-X
DCA-M
Meas. mode:
Eye
Flex Apps:
FlexDCA
FlexRT
:MTESt Loading Commands

Command Syntax

:MTEStN:LOAD:FNAMe "<path substitution string>\subfolder\filename"

Where:

  • N identifies a specific mask and must be a value from 1 to 16 {1:16}. For example, :MTESt2: selects mask 2.
  • "<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%\Masks.
  • "filename" is a string without the filename extension.

Query Syntax

:MTEStN:LOAD:FNAMe?

Description

Selects a mask file (extension .mskx or .msk) to load using the :MTESt:LOAD parent command. The following figures show the default location for mask files. Mask file sub-folders are provided that group the mask according to the standards. The available mask files that are also provided in the FlexDCA applications installation folder, although this folder is not available for storing user files, but mask files can be copied from this folder. This command supports the DEFault common child command.

Default User Folder

User-Data Folders

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

Loading a mask using the FlexDCA install path on an 86100D.

:MTESt2:LOAD:FNAMe "C:\Program Files\Keysight\FlexDCA\Demo\Masks\SONET_SDH\002.48832 - STM016_OC48.mskx"
:MTESt2:LOAD

Loading a mask using the user shorcut path on an 86100D.

:MTESt2:LOAD:FNAMe "C:\User Files\Masks\SONET_SDH\002.48832 - STM016_OC48.mskx"
:MTESt2:LOAD

Loading a mask using the FlexDCA install path on a Windows 7 PC.

:MTESt2:LOAD:FNAMe "C:\Program Files (x86)\Keysight\FlexDCA\Demo\Masks\SONET_SDH\002.48832 - STM016_OC48.mskx"
:MTESt2:LOAD

Loading a mask using the Libraies shorcut path on a Windows 7 PC.

:MTESt2:LOAD:FNAMe "C:\Users\<user_name>\Documents\Keysight\FlexDCA\Masks\SONET_SDH\002.48832 - STM016_OC48.mskx"
:MTESt2:LOAD