Table Of Contents

IviSwtch Set Path (G Dataflow)

Version:
    Last Modified: October 23, 2017

    Connects two channels by establishing the exact path you specify with the pathList parameter. If the instrument cannot parse the input path list string, this node returns the error IVISWTCH_ERROR_INVALID_SWITCH_PATH (0xBFFA2001). If the specified path list string is empty, this node returns the error IVISWTCH_ERROR_EMPTY_SWITCH_PATH (0xBFFA2005). If one of the channels in the path list is a configuration channel that is currently in use, this node returns the error IVISWTCH_ERROR_RSRC_IN_USE (0xBFFA2003). If an explicit connection is made to a configuration channel, this node returns the error IVISWTCH_ERROR_IS_CONFIGURATION_CHANNEL (0xBFFA2009). If one of the non-terminal channels in the path list is not a configuration channel, this node returns the error IVISWTCH_ERROR_NOT_A_CONFIGURATION_CHANNEL (0xBFFA200A). If the path list attempts to connect between two different source channels, this node returns the error IVISWTCH_ERROR_ATTEMPT_TO_CONNECT_SOURCES (0xBFFA200B). If the path list attempts to connect between channels that already have an explicit connection, this node returns the error IVISWTCH_ERROR_EXPLICIT_CONNECTION_EXISTS (0xBFFA200C). If a leg in the path list does not begin with a channel name, this node returns the error IVISWTCH_ERROR_LEG_MISSING_FIRST_CHANNEL (0xBFFA200D). If a leg in the path list is missing the second channel, this node returns the error IVISWTCH_ERROR_LEG_MISSING_SECOND_CHANNEL (0xBFFA200E). If the first and the second channels in the leg are the same, this node returns the error IVISWTCH_ERROR_CHANNEL_DUPLICATED_IN_LEG (0xBFFA200F). If a channel name is duplicated in the path string, this node returns the error IVISWTCH_ERROR_CHANNEL_DUPLICATED_IN_PATH (0xBFFA2010). If the first channel of a leg in the path is not the same as the second channel in the previous leg, this node returns the error IVISWTCH_ERROR_DISCONTINUOUS_PATH (0xBFFA2012). If the path list contains a leg with two channels that cannot be directly connected, this node returns the error IVISWTCH_ERROR_CANNOT_CONNECT_DIRECTLY (0xBFFA2013). If a leg in the path contains two channels that are already directly connected, this node returns the error IVISWTCH_ERROR_CHANNELS_ALREADY_CONNECTED (0xBFFA2014). This node applies default values to properties that have not been set by the user under the following conditions: (1) If the user has not set the value of any property in the IviSwtchScanner extension, the following default values are used: IviSwtch>>Scanning Configuration>>Scan List [SCN] - "" (Empty string) IviSwtch>>Scanning Configuration>>Trigger Input [SCN] - IVISWTCH_VAL_EXTERNAL IviSwtch>>Scanning Configuration>>Scan Advanced Output [SCN] - IVISWTCH_VAL_EXTERNAL IviSwtch>>Scanning Configuration>>Scan Delay [SCN] - 0 Notes: (1) This node performs interchangeability checking when the IviSwtch>>Inherent IVI Settings>>User Options>>Interchange Check property is set to TRUE. If the IviSwtch>>Inherent IVI Settings>>User Options>>Spy property is set to TRUE, you use the NI I/O Trace utility to view interchangeability warnings. You use the IviSwtch Get Next Interchange Warning Node to retrieve interchangeability warnings when the IviSwtch>>Inherent IVI Settings>>User Options>>Spy property is set to FALSE. For more information about interchangeability checking, refer to the help text for the IviSwtch>>Inherent IVI Settings>>User Options>>Interchange Check property.

    connector_pane_image
    datatype_icon

    instrument handle

    The instrument handle that you obtain from the IviSwtch Initialize Node. The handle identifies a particular instrument session.

    Default: None

    datatype_icon

    error in

    Error conditions that occur before this node runs.

    The node responds to this input according to standard error behavior.

    Standard Error Behavior

    Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

    error in does not contain an error error in contains an error
    If no error occurred before the node runs, the node begins execution normally.

    If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

    If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

    Default: No error

    datatype_icon

    path list ("")

    Pass the path list for the path you previously created that you want the switch module to establish. You obtain the path list for a path you previously created with the IviSwtch Get Path VI. Users who want to achieve interchangeability should use a virtual channel name. The virtual channel name should be sufficiently specific to the test system such that it is unlikely to conflict with a physical channel name. Example: The path from Ch1 to Ch3 over Conf1 is: "Ch1->Conf1,Conf1->Ch3"

    datatype_icon

    instrument handle out

    The instrument handle that you obtain from the IviSwtch Initialize Node. The handle identifies a particular instrument session.

    Default: None

    datatype_icon

    error out

    Error information.

    The node produces this output according to standard error behavior.

    Standard Error Behavior

    Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

    error in does not contain an error error in contains an error
    If no error occurred before the node runs, the node begins execution normally.

    If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

    If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

    Where This Node Can Run:

    Desktop OS: Windows

    FPGA: Not supported

    Web Server: Not supported in VIs that run in a web application


    Recently Viewed Topics