# :LTESt:LLINe:TEST{N}: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:TEST{1:64}:STATe {ON | OFF}

{1:64} identifies the specific limit-line test.

## Query Syntax

    :LTESt:LLINe:TEST{1:64}:STATe?

## Description

Turns on or off limit testing for a specified limit line test. When testing limits are on, data acquisition continues until the event specified with the `:LTESt:LLINe:TEST{N}:MODE` command occurs. This can be defined as stop acquisition upon the first failed or first successful data point. To specify the reporting action to be taken once the data acquisition has stopped, use the following commands:

- :LTESt:LLINe:SIMage:STATe
- :LTESt:LLINe:SSUMmary:STATe
- :LTESt:LLINe:SWAVeform:CHANnel:STATe
- :LTESt:LLINe:SWAVeform:CMODe:STATe
- :LTESt:LLINe:SWAVeform:DIFF:STATe
- :LTESt:LLINe:SWAVeform:FUNCtion:STATe

To create a limit line test, use the `:LLINe` subsystem.

Use an `*OPC (Operation Complete)` query to pause program execution while waiting for this command to complete.

## Example

This example shows the general steps required to load two limit line tests, apply limit testing to each limit line test, configure the reports, and run the tests. The waveform content window is tiled so that the two waveforms do not overlap. In a real example, you would need to create the limit test for your waveforms and manage the correct positioning of the limit lines.

    :CHANnel1_1:DISPlay ON
    :CHANnel1_2:DISPlay ON

    :SYSTem:AUToscale

    //  Load and start limit line test.
    :LLINe1:LOAD:FNAMe "%USER_DATA_DIR%\Limit Lines\Golden Test.lltx"
    :LLINe1:SOURce CHANnel1
    :LLINe1:DISPlay ON  //  Display first limit line test.
    :LLINe2:LOAD:FNAMe "%USER_DATA_DIR%\Limit Lines\Golden Test.lltx"
    :LLINe2:SOURce CHANnel2
    :LLINe2:DISPlay ON  //  Display second limit line test.
    :DISPlay:WINDow:TIME1:DMODe STILed  //  Stack and tile waveform window.
                    //  Configure "Save Waveform" reporting using default file name.
    :LTESt:LLINe:SWAVeform:RESet  //  Turn saving of all waveforms off.
    :LTESt:LLINe:SWAVeform:CHANnel1:WMEMory WMEMory1  //  Turn on saving of connection 1 channel 1.
    :LTESt:LLINe:SWAVeform:CHANnel1:STATe MEMory  //  Enable waveform save.
    :LTESt:LLINe:SWAVeform:CHANnel2:WMEMory WMEMory2  //  Turn on saving of channel 1B.
    :LTESt:LLINe:SWAVeform:CHANnel2:STATe MEMory  //  Enable waveform save.
                    //  Configure "Save Summary" reporting using default file name.
    :LTESt:LLINe:SSUMmary:STATe ON  //  Enable summary report save.
                    //  Configure "Save Screen Image" reporting using default file name.
    :LTESt:LLINe:SIMage:WINDow TIME1
    :LTESt:LLINe:SIMage:INVert ON
    :LTESt:LLINe:SIMage:STATe ON  //  Enable screen image save.
                    //  Run limit testing.
    :LTESt:LLINe:TEST1:MODE SOFailure  //  Stop limit testing on fail condition.
    :LTESt:LLINe:TEST1:STATe ON  //  Enable limit testing.
    :LTESt:LLINe:TEST2:MODE SOFailure  //  Stop limit testing on fail condition.
    :LTESt:LLINe:TEST2:STATe ON  //  Enable limit testing.
    :ACQuire:STOP
    :ACQuire:CDISplay
    :ACQuire:RUN  //  Enable data acquisition.