View Source

Let us have a look at ecflow_ui, this provide the GUI for ecFlow.

On the unix prompt type ecflow_ui

Once the program is up:

Select “Servers” menu.
Next click on the "Manage Servers..." menu
"Add server" enter details of your ECF server.
Choose a name for your ECF server and add the Host name and port number you noted down earlier. Make sure 'Add server to current view' is clicked on the dialog.

You should get something similar to the following display :

ecFlow > Using ecflow_ui > ecflow_ui_start1.png

The yellow boxes are called nodes. With the left mouse mouse button click on the black triangle. This will expand the node. Repeat for node called 'test'.

ecFlow > Using ecflow_ui > ecflow_ui_start2.png

Now select the View menu and then "Add info panel". This panel can be re-arranged on the window.

You can now view the ecf script, the job file and the output of the task t1.

For that click on the node t1, then press on the script tab. A window should open showing the task script:

ecFlow > Using ecflow_ui > ecflow_ui_start3.png

To see the ECF job or the output simply click on the tabs.

If you want to see the output in a different window, click on the output icon.

If we want to rerun the suite, move the mouse pointer over test and click on the right mouse button.

A pop-up menu will appear. Choose requeue.

You will notice that the node‘s change colour.

The colours reflect the status of the nodes.

We have seen that ecFlowview uses the three buttons of the mouse to perform different actions.

The following figure show how the mouse buttons are used in ecFlowview:

Task nodes contain a flag that can reflect the reason for its being aborted, complete, or submitted.

Here the associated icons that can be displayed in ecflowview:

(green r) task was completed by rule (complete expression)
(red c) ECF_JOB_CMD failed
(red e) invalid script leading to inability to edit the script (missing micro % character ?)
(orange u) task was forced aborted by a user
(red k) task was killed following a request by a user
(red s) script missing for task (ECF_HOME incorrect, ECF_FILE incorrect, or no script visible to this task under ECF_HOME or ECF_FILE directory)
(green q) task cannot be started due to a queue limit
(red a) task aborted
(green e) user edited the script and submitted it

What to do

Explore ecFlowview menus and windows
There can be a long delay between the job changing status and that change being reflected in the ecflowview window. To update the current state more quickly in that window, click the red status button