# :LTESt:MTESt:SIMage:FNAMe:AUPDate

:LTESt Mask Limit Commands

- :LTESt:MTESt:MRESult{N}:CTYPe
- :LTESt:MTESt:MRESult{N}:CTYPe:UINTervals
- :LTESt:MTESt:MRESult{N}:CTYPe:WAVeforms
- :LTESt:MTESt:MRESult{N}:SOFailure
- :LTESt:MTESt:MRESult{N}:STATe
- :LTESt:MTESt:SIMage:FNAMe
- :LTESt:MTESt:SIMage:FNAMe:AUPDate
- :LTESt:MTESt:SIMage:FNAMe:USTandard
- :LTESt:MTESt:SIMage:FTYPe?
- :LTESt:MTESt:SIMage:IMETadata
- :LTESt:MTESt:SIMage:INVert
- :LTESt:MTESt:SIMage:MONochrome
- :LTESt:MTESt:SIMage:SINClude
- :LTESt:MTESt:SIMage:STATe
- :LTESt:MTESt:SIMage:WINDow
- :LTESt:MTESt:SWAVeform:CHANnel{N}:FNAMe
- :LTESt:MTESt:SWAVeform:CHANnel:FTYPe
- :LTESt:MTESt:SWAVeform:CHANnel{N}:STATe
- :LTESt:MTESt:SWAVeform:CHANnel{N}:WMEMory
- :LTESt:MTESt:SWAVeform:CMODe{N}:FNAMe
- :LTESt:MTESt:SWAVeform:CMODe:FTYPe
- :LTESt:MTESt:SWAVeform:CMODe{N}:STATe
- :LTESt:MTESt:SWAVeform:CMODe{N}:WMEMory
- :LTESt:MTESt:SWAVeform:DIFF{N}:FNAMe
- :LTESt:MTESt:SWAVeform:DIFF:FTYPe
- :LTESt:MTESt:SWAVeform:DIFF{N}:STATe
- :LTESt:MTESt:SWAVeform:DIFF{N}:WMEMory
- :LTESt:MTESt:SWAVeform:FUNCtion{N}:FNAMe
- :LTESt:MTESt:SWAVeform:FUNCtion{N}:STATe
- :LTESt:MTESt:SWAVeform:FUNCtion{N}:WMEMory
- :LTESt:MTESt:SWAVeform:RESet

## Command Syntax

    :LTESt:MTEStN:SIMage:FNAMe:AUPDate

Where N identifies a specific mask and must be a value from 1 to 16 {1:16}. For example, `:MTESt2` selects mask 2.

## Description

Appends an autonumber to the file name (`:LTESt:MTESt:SIMage:FNAMe`) and increments the number for the next save. The autonumber takes the form "_1", which is appended to the file name before the file name extension. Appending an automatically generated number prevents the accidental writing over of an existing file. Use the `:LTESt:MTESt:SIMage:STATe` command to enable and disable screen-capture reporting. The following rules apply:

- A file names not ending in a number gets the autonumber appended starting at 1.
- A file name that ends with an underscore character followed by a number (for example, my_file_123) is recognized as an autonumber. The number is interpreted as the starting number. In this example, sending `:AUPDate` results in the next saved file being my_file_124.
- A file name that ends in a number but without a preceding underscore character is not interpreted as an autonumber. An autonumber is appended at the end of the file name. For example, my_file123 becomes my_file123_01.

Saving a file with screen-capture reporting does not increment the autonumber. Send the `:LTESt:MTESt:SIMage:FNAMe:AUPDate` command to increment the number. To use autonumbering, include the autonumber in the file name for the first file that is saved as shown in the Example Command Sequence below.

## Example Command Sequence

    :ACQuire:SINGle
    :LTESt:MTESt:SIMage:FNAMe "my_file_1.png"
    :LTESt:MTESt:SIMage:STATe ON  //  Enable screen capture reporting
    :LTESt:MTESt:MRESult1:STATe ON  //  Turn limit test on
    :ACQuire:RUN;*OPC?  #  my_file_1.png
    …
    …
    :ACQuire:CDISplay
    :LTESt:MTESt:SIMage:FNAMe:AUPDate
    :ACQuire:RUN;*OPC?  #  my_file_2.png