# :LTESt:MEASure:SWAVeform:CMODe{N}:FNAMe

:LTESt Measurement Waveform Commands

- :LTESt:MEASure:SWAVeform:CHANnel{N}:FNAMe
- :LTESt:MEASure:SWAVeform:CHANnel:FTYPe
- :LTESt:MEASure:SWAVeform:CHANnel{N}:STATe
- :LTESt:MEASure:SWAVeform:CHANnel{N}:WMEMory
- :LTESt:MEASure:SWAVeform:CMODe{N}:FNAMe
- :LTESt:MEASure:SWAVeform:CMODe:FTYPe
- :LTESt:MEASure:SWAVeform:CMODe{N}:STATe
- :LTESt:MEASure:SWAVeform:CMODe{N}:WMEMory
- :LTESt:MEASure:SWAVeform:DIFF{N}:FNAMe
- :LTESt:MEASure:SWAVeform:DIFF:FTYPe
- :LTESt:MEASure:SWAVeform:DIFF{N}:STATe
- :LTESt:MEASure:SWAVeform:DIFF{N}:WMEMory
- :LTESt:MEASure:SWAVeform:FUNCtion{N}:FNAMe
- :LTESt:MEASure:SWAVeform:FUNCtion{N}:STATe
- :LTESt:MEASure:SWAVeform:FUNCtion{N}:WMEMory
- :LTESt:MEASure:SWAVeform:RESet

## Command Syntax

    :LTESt:MEASure:SWAVeform:CMODeN:FNAMe "<path substitution string>\subfolder\filename"

Where:

- CMODeN identifies the channel. See :CMODe Subsystem.
- "<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%\Waveforms.
- "filename" is a string without the filename extension.

## Query Syntax

    :LTESt:ACQuire:SWAVeform:CMODeN:FNAMe?

## Description

Specifies the file name (including path but excluding a filename extension) for saving a common mode waveform file for an acquisition limit test. To specify the file type use the `:LTESt:MEASure:SWAVeform:CMODe:FTYPe` command. This results in the correct filename extension being appended to the filename. This command supports the `DEFault` common child command.

If a correct filename extension is included in the filename that is sent with the `:LTESt:ACQuire:SWAVeform:CMODe:FNAMe` command, the extension is ignored and will not be included in the filename. If an incorrect filename extension is included in the filename, a SCPI error will occur similar to this example:

    17,"Instrument Error;"".txt"" is not a valid extension for Waveform File. Using extension "".csv""."

Therefore, avoid including an extension when specifying the filename. If you want to check the validity of the filetype, check for a SCPI error after sending the `:LTESt:MEASure:SWAVeform:CMODe:FTYPe` command.

Use the `:LTESt:MEASure:SWAVeform:CMODe{N}:STATe` command to enable and disable waveform reporting for the channel. To enable or disable acquisition limit tests, use the `:LTESt:LLINe:TEST{N}:STATe` command.

### Default User Folder

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