# :MTESt:LOAD:FNAMe

:MTESt Loading Commands

- :MTESt:DISPlay
- :MTESt:LOAD
- :MTESt:LOAD:FNAMe
- :MTESt:MLOaded?
- :MTESt:MODified?
- :MTESt:NREGions?
- :MTESt:SEARch
- :MTESt:SEARch:STATus?
- :MTESt:SEARch:STATus:REASon?
- :MTESt:SOURce
- :MTESt:TITLe?

## 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