Table Of Contents

Create Rendezvous (G Dataflow)

Version:
    Last Modified: March 15, 2017

    Creates a new rendezvous or searches for an existing rendezvous, and returns a reference to the rendezvous. You can use this reference when calling other Rendezvous nodes.

    connector_pane_image
    datatype_icon

    name

    Name of the rendezvous that you want to create or search for.

    If you specify name, the node first searches for an existing rendezvous with the same name and returns a reference to the rendezvous if it exists. If an existing rendezvous with the same name does not exist and return existing is False, the node creates a new rendezvous and returns a reference.

    Default: Empty string — The node creates an unnamed rendezvous.

    datatype_icon

    size

    Number of tasks that initially meet at the rendezvous to continue execution. If a named rendezvous already exists, you cannot use this parameter to resize the rendezvous. Use the Resize Rendezvous node to resize a named rendezvous.

    Default: 2

    datatype_icon

    return existing

    A Boolean value that specifies whether the rendezvous must already exist for this node to succeed.

    True The rendezvous must already exist for this node to succeed. The node returns an error if the rendezvous with the specified name does not exist.
    False The rendezvous does not have to exist for this node to succeed. The node creates a new rendezvous if the rendezvous with the specified name does not exist.

    Default: False

    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

    rendezvous

    Reference to an existing or newly created rendezvous.

    datatype_icon

    created new

    A Boolean value that indicates whether the node created a new rendezvous.

    True The node created a new rendezvous.
    False The node did not create a new rendezvous.
    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.

    Life Span of a Named Rendezvous

    A named rendezvous exists as long as the top-level VI that first created the named rendezvous continues running. For example, if Application.gvi has a subVI Subtask.gvi, the system cleans up any named rendezvous created by Subtask.gvi when Application.gvi stops executing. You can use the same named rendezvous in any VI, including VIs that are not in the hierarchy of Application.gvi, but the rendezvous ceases to exist when Application.gvi stops executing.

    Where This Node Can Run:

    Desktop OS: Windows

    FPGA: This product does not support FPGA devices


    Recently Viewed Topics