Verifies that a path between channel 1 and channel 2 can be created.

If a path is possible in the switch module, the availability of that path is returned given the existing connections. If the path is possible but in use, an Implicit Connection Exists warning is returned.

Related Topic


icon

Inputs/Outputs

  • civrn.png instrument handle

    instrument handle identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology VI, the niSwitch Initialize With Options VI, or the niSwitch Initialize VI.

  • cstr.png channel 1

    channel 1 specifies one of the channel names of the desired path. Pass the other channel name as channel 2. Refer to Devices for valid channel names for the switch module.

    Examples of valid channel names are ch0, com0, ab0, r1, c2, and cjtemp.

  • cstr.png channel 2

    channel 2 specifies one of the channel names of the desired path. Pass the other channel name as channel 1. Refer to Devices for valid channel names for the switch module.

    Examples of valid channel names are ch0, com0, ab0, r1, c2, and cjtemp

  • cerrcodeclst.png error in (no error)

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

  • iivrn.png instrument handle out

    instrument handle out identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology VI, the niSwitch Initialize With Options VI, or the niSwitch Initialize VI and used for all subsequent NI-SWITCH calls.

  • ii32.png path capability

    path capability indicates whether a path is valid.

    Path Available (1)

    The path is possible and available.

    Path Exists (2)

    The path is possible, but already exists.

    Path Unsupported (3)

    The path is not possible in the specified switch module and topology.

    Resource In Use (4)

    The path is possible, but elements of the path are in use by another existing path. You must destroy the other path before creating this one.

    Source Conflict (5)

    The path is possible, but connecting the channels will connect two sources.

    Channel Not Available (6)

    Channel 1 and channel 2 are configuration channels and are thus unavailable for external connections.

  • ierrcodeclst.png error out

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