# :LTESt:LLINe:SSUMmary:STATe

:LTESt Limit Line Commands

- :LTESt:LLINe:TEST{N}:MODE
- :LTESt:LLINe:TEST{N}:STATe
- :LTESt:LLINe:SIMage:FNAMe
- :LTESt:LLINe:SIMage:FNAMe:AUPDate
- :LTESt:LLINe:SIMage:FNAMe:USTandard
- :LTESt:LLINe:SIMage:FTYPe?
- :LTESt:LLINe:SIMage:IMETadata
- :LTESt:LLINe:SIMage:INVert
- :LTESt:LLINe:SIMage:MONochrome
- :LTESt:LLINe:SIMage:SAVE
- :LTESt:LLINe:SIMage:SINClude
- :LTESt:LLINe:SIMage:STATe
- :LTESt:LLINe:SIMage:WINDow
- :LTESt:LLINe:SSUMmary:FNAMe
- :LTESt:LLINe:SSUMmary:STATe
- :LTESt:LLINe:SWAVeform:CHANnel{N}:FNAMe
- :LTESt:LLINe:SWAVeform:CHANnel:FTYPe
- :LTESt:LLINe:SWAVeform:CHANnel{N}:STATe
- :LTESt:LLINe:SWAVeform:CHANnel{N}:WMEMory
- :LTESt:LLINe:SWAVeform:CMODe{N}:FNAMe
- :LTESt:LLINe:SWAVeform:CMODe:FTYPe
- :LTESt:LLINe:SWAVeform:CMODe{N}:STATe
- :LTESt:LLINe:SWAVeform:CMODe{N}:WMEMory
- :LTESt:LLINe:SWAVeform:DIFF{N}:FNAMe
- :LTESt:LLINe:SWAVeform:DIFF:FTYPe
- :LTESt:LLINe:SWAVeform:DIFF{N}:STATe
- :LTESt:LLINe:SWAVeform:DIFF{N}:WMEMory
- :LTESt:LLINe:SWAVeform:FUNCtion{N}:FNAMe
- :LTESt:LLINe:SWAVeform:FUNCtion{N}:STATe
- :LTESt:LLINe:SWAVeform:FUNCtion{N}:WMEMory
- :LTESt:LLINe:SWAVeform:RESet

## Command Syntax

    :LTESt:LLINe:SSUMmary:STATe {ON | OFF}

## Query Syntax

    :LTESt:LLINe:SSUMmary:STATe?

## Description

Turns on or off the reporting action to save an ASCII summary file whenever a limit testing for a limit line test stops data acquisition. The file name extension of summary files is .sum. Use the `:LTESt:LLINe:SSUMmary:FNAMe` command to specify the name of the summary file. To turn on or off testing limits for a specified limit line test, use the `:LTESt:LLINe:TEST{N}:STATe` command.

## Example Summary File

    Limit Line Limit Test Summary
    02/10/2015 13:54:52

    Test Name  : Upper Limit
    Source     : Connection 1 Channel 1
    Test Result: FAIL
    Test Margin: -5.52 mV (at 603.50 ps)

    Line   Name                 Type Margin           Location         Result
    ====== ==================== ==== ================ ================ ======
         0 Upper Rail            MAX         -5.52 mV        603.50 ps   FAIL

## Example

                    //  Load and start limit line test.
    :LLINe1:LOAD:FNAMe "%USER_DATA_DIR%\Limit Lines\Golden Test.lltx"
    :LLINe1:SOURce CHANnel1_1
    :LLINe1:DISPlay ON
    :ACQuire:STOP
    :ACQuire:CDISplay

    //  Configure "Save Summary" reporting.
    :LTESt:LLINe:SSUMmary:FNAMe "%USER_DATA_DIR%\Limit Summaries\MyLimitTest.sum"  //  Enter file name.
    :LTESt:LLINe:SSUMmary:STATe ON  //  Enable summary report save.
                    //  Run limit testing.
    :LTESt:LLINe:TEST1:MODE SOFailure  //  Stop limit testing on fail condition.
    :LTESt:LLINe:TEST1:STATe ON  //  Enable limit testing.
    :ACQuire:RUN  //  Enable data acquisition.