BuildForge Help

Creating Links and Highlighting in Step Logs

The Management Console log viewer recognizes two special bracket commands in step output. When these commands appear in step output, the system displays the output in special ways:

[STATUS] Examples

In a step, you can use a command like the following to highlight output from a command. The [STATUS][/STATUS] wrapper marks the wrapped text:

echo [STATUS=WARN]WARNING DANGER WILL ROBINSON[/STATUS]

You can use any of the following variations:

NOTE: The start [STATUS] and end [/STATUS] commands must be on the same line of the output.

[URL] Example

Use the following syntax in command output to create an active hyperlink in your logs:

[URL]http://www.ibm.com[/URL]

You can use this syntax in an echo command or any command that produces output. The system displays the text as an active hyperlink to the indicated URL. The start and end tags must appear on the same line of the output.

These commands need not be upper-case; [url][/url] and [status][/status] work as well.

You can include the [STATUS] tag in your regular expressions by adding the "\" escape character to identify the tag inserted in the line.

For example, to find the word "Access" at the beginning of a line where there is a STATUS=RUN tag, enter:

^\[STATUS=RUN\]Access