Run an EJM Process in IWS

This article shows you how to run EJM Processes in IWS. It walks through using the Run icon on the toolbar and provides an general overview of the Run EJM Process. It then goes into details around the importance of the Build Workflow Tree setting and the Data files and CM Parameters tabs associated with Run EJM Process. It also steps you through actually starting the workflow and then monitoring it.

This article uses solution testsuite_fewfiles2task_1 as an example. This solution is a bundle-based workflow that requires a single incoming file to start.

On this page

1 Run Icon on the Toolbar
2 Run EJM Process Overview
3 Build Workflow Tree
4 Data Files Tab
5 CM Parameters Tab
6 Starting a Bundle-based Workflow
7 Monitoring a Workflow in the Monitoring Tool

Run Icon on the Toolbar

If you click Run in the toolbar, the Run EJM Process window pops up:

Run EJM Process Overview

This window has two tabs, CM Parameters and Data Files. The Data Files tab is active by default.

The Data Files tab contains the list of files required to start and process the workflow. The mask list is created according to the process tree of the solution and is displayed in the table of files.
The CM Parameters tab displays a list of custom parameters used to launch the workflow.

Before launching the workflow, you can publish the solution.

To publish, check the Publish Solution flag at the bottom-right side of the box by the Run and Cancel buttons.
When this option is enabled, IWS publishes the solution first before performing other actions.

When you click on the Run button, there are 3 options:

Run and Send Files – this option sends a RTR message to Cancel Workflow to stop it (Note: in case the workflow is bundle-based it does not stop it), sends a RTR message to restart the workflow and then sends all files selected in the table to the NDFA adapter.
Send Files Only – this option does not stop and restart the workflow, but only sends selected files to NDFA.
Run only – this option sends a RTR message to Cancel Workflow to stop it (Note: in case of a bundle-based workflow it is not stopped) and sends a RTR message to restart the workflow. Files are not sent to NDFA.

Build Workflow Tree

In order to have the correct file listing, you should enable the Build Workflow Tree checkbox in the Settings toolbar first and open the Run dialog only after that.

Once you select the build workflow tree checkbox, the process tree is assembled. This process may take some time, as it downloads all solution files.

To avoid assembling the tree in the future, it is recommended you save your solution with this option enabled. This will let IWS use the cashed process tree and (which can be refreshed, if necessary).

Data Files Tab

If the process tree is complete, the masks of files required to launch and support the workflow will be displayed in the file table.

In this particular solution example, it requires only one filemask – fewfiles2task_1.
Clicking Add File(s) button brings out the standard file selection dialog. Multiple file selection is allowed.

Selecting files and clicking the Open button binds them to corresponding masks.
If the file does not match any mask in the list, it is filtered to the Other Files group.

The Send flag for files matching a mask is enabled automatically. Files without a mask are unflagged. Only files with Send checkbox enabled will be sent to the NDFA adapter.

In case a selected file is empty or has been deleted before the workflow is launched, its name will be marked with red and a warning message will be displayed.

Clicking Cancel will bring you back to file selection. Clicking Run will proceed with launching the workflow, missing files will not be sent to the NDFA adapter.
The Remove File button removes (in case the file selected is in the Other Files group or in case multiple files matching a mask are selected) or clears the row (in case only one file with one mask is selected).

CM Parameters Tab

This tab contains a table of two columns, Parameter Name and Parameter Value.
If several parameters with the same name are on the list, only the last one will be used.
To add a parameter, click the Add Row button.
To remove a parameter, select its row and click Remove Row.
You can navigate within the table by using arrow keys and Enter.

Starting a Bundle-based Workflow

You can start a bundle-based workflow in two ways:

Select required files, click Run and choose Run and Send Files or Run Only.
IWS would recognize the workflow as bundle-based and would create a RTR message to start the workflow using attached files.
- When the Monitor Tool opens, you will see only your process in it which makes monitoring easier.
Select required files, click Run and choose the Send Files Only option.
The solution's process tree must already be assembled to use this method.
- With this approach, all processes will be displayed in the Monitor tool. You will need to scroll through the list to find the ones you are interested in monitoring.

Monitoring a Workflow in the Monitoring Tool

After select the files you need, configuring the parameters and starting the workflow (using the Run and Send Files option), if no errors occur, the Run EJM Process window closes and Monitor Tool is opened in a separate tab, displaying the progress of the workflow.

The processing a workflow may take some time, depending on the specifics of that workflow.
Click Refresh to update its status.

As you can see in the following screenshot in the Control Message tab of the main process, both parameters (parameter1 and parameter2) have been processed and reached the workflow.