The Join object combines two or more documents into a single document. The single document then proceeds to the next object in the process flow.

For example, if you have two XML documents:


<A> ... </A>

and B:

<B> ... </B>

The Join object creates the following output:


Caution: Use caution when mixing Join and Junction objects in a process flow. When a Join object is located after a Junction object, results can be unpredictable.

The Join object is located in the iWay Integration Tools (iIT) Palette, under the Flow Control group, as shown in the following image.

Flow Control Join Object

When you add the Join object to your process flow using iIT, configuration properties for this object are available in the Properties tab and grouped by subtabs.

Timeout subtab:

Join Timeout Subtab

Timeout is the amount of time (in seconds) that the Join object will wait to receive the documents it must join. The timeout count begins when the first document enters the Join object. If the Join receives all of the documents before the timeout period ends, the join process continues. If all documents needed to satisfy the join are not received, then a status document is generated and sent along the OnTimeout edge.

Select a Timeout value from the Timeout drop-down list.

Debug subtab:

Join Debug Subtab

The Debug subtab allows you to configure iterative tracing limits. When this object is part of an iterative loop, the maximum number of iterations that can be captured is 20. Tracing can be controlled by specifying the iteration that begins and ends the document capture.

Specify the iterations in which you want the tracing to begin and end.

The following tracing formats are available from the drop-down list:

  • Standard tracing (default)
  • Standard tracing displayed in hex format
  • Just the output document
  • None, under any circumstances

Post-Execution subtab:

Join Post_Execution Subtab