RFmxSpecAn Initiate VI

Initiates all enabled measurements. Call this VI after configuring the signal and measurement. This VI asynchronously launches measurements in the background and immediately returns to the caller program. You can fetch measurement results using the Fetch VIs or result properties in the property node. To get the status of measurements, use the RFmxSpecAn Wait for Measurement Complete VI or RFmxSpecAn Check Measurement Status VI.


icon

Inputs/Outputs

  • cstr.png Result Name —

    Result Name specifies the name to be associated with measurement results. Provide a unique name, such as "r1" to enable fetching of multiple measurement results and traces. This input accepts the result name with or without the "result::" prefix. The default value is "" (empty string), which refers to the default result instance.

    Example:

    ""

    "result::r1"

    "r1"

  • cstr.png Selector String —

    Selector String specifies the signal name and result name. The result name can either be specified through this input or the Result Name parameter. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name in this parameter, either the result name specified by the Result Name parameter or the default result instance is used. The default value is "" (empty string).

    Example:

    ""

    "signal::sig1"

    "result::r1"

    "signal::sig1/result::r1"

    You can use the RFmxSpecAn Build Signal String VI to build the selector string.

  • cgenclassrntag.png Instrument Handle In —

    Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • igenclassrntag.png Instrument Handle Out —

    Instrument Handle Out passes a reference of your RFmx session to the next VI.

  • istr.png Selector String Out —

    Selector String Out returns the selector string that can be passed to the Selector String parameter on Fetch VIs.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.