Overview

ecFlowUI provides rich facilities for viewing tasks' scripts, jobs and job output. Although their usage should be fairly self-explanatory, some details are given here.

To see this information about a node, either right-click on the node and choose one of the options from the context menu such as "Output ...", "Script ..." or "Job ...", or create an Info Panel - information for the selected node will appear there. The script, job and output tabs have much in common, so most of the information below is relevant for them all.

Header strip

At the top of these tabs is a shaded area which provides information about the file being viewed, for instance its size and how it was retrieved (e.g. straight from disk, from a log server or from the ecFlow server).

To the right of this is a toolbar, providing common buttons to control the following:

• to change the font size, click on the two 'A' buttons; alternatively, hold down the CTRL button whilst moving the mouse wheel
• to bring up the search bar, click the magnifying glass
• to go to a particular line in the file, click the magnifying glass/123 icon

All these buttons have tooltips, providing further information about their keyboard shortcuts if you hover the mouse cursor over them.

Searching for text

The search bar allows for powerful text searching within the viewed file.

The start of the search bar is a verb, representing the search type:

• Matches is a wildcard match, similar to UNIX file syntax, where "*" means "any number of any characters" and "?" means "one of any character", e.g. "*monitor?". If no wildcard characters are used, the result will be that only those strings that exactly match the search expression will be found. This is often the simplest way of searching. See also http://doc.qt.io/qt-5/qregexp.html#wildcard-matching.
• Regexp is a regular expression match, using the Qt regexp syntax. The regexp equivalent of the above example would be ".*monitor.". See also http://doc.qt.io/qt-5/qregexp.html#introduction.
• Contains finds strings which contain the given regular expression as a substring; similar to Regexp, but can find more matches since the regexp only needs to match a substring rather than the whole string.

Note that the search works within a line, not between lines.

The spanner icon to the right of the search bar provides more options to customise the search, and also the ability to highlight all matches in the text.

As text is typed into the search bar, the results of the search are updated almost immediately (but see Large file mode, below).

Job output

The job output tab has some additional functionality over the others, described in the following sub-sections.

File listing

Beneath the output file is a list of files available for that node. The one defined by ECF_JOBOUT is considered to be the the current one, and will be selected by default. It is highlighted in the file list. Select a file to view its contents.

Detailed file information

Since there can be several steps to retrieving an output file, this information is made available by clicking on the Information button in the toolbar.

Reload

Click the Reload button to obtain the latest version of the job output file. Note that these files can become very large, and can take some time to transfer across a network if they are hundreds of megabytes or more.

Automatic search

The job output tab follows this algorithm when it is reloaded or loaded for the first time:

• if the search bar is open and contains a search term, then its search is performed
• otherwise, if the viewed file is the current output for the selected node, an automatic search for keywords is invoked: search backwards through the document for the strings --abort and --complete; it is intended to make this behaviour user-configurable in the future.

Large file mode

This should be largely transparent to the user, but when viewing a log file which is greater than 1MB, the file viewer goes into "large file mode", where it loads only the visible portion of the file into memory. This mode gives a massive saving in memory usage and also significantly increases performance.

If the file is larger than 5MB, the search results are no longer updated immediately as text is typed into the search bar; you must hit enter to initiate the search (as indicated in a warning bar). This mode allows the user interface to remain responsive while typing a search term.