:MTESt:LOAD:FNAMe

: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 Infiniium 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

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 Default.

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 Infiniium install path on an oscilloscope.

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

Loading a mask using the user shortcut path on an oscilloscope.

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