Issuing a WTO message or highlighting text when a specified text string is found in a SYSOUT record

You can issue a WTO (Write To Operator) message, or automatically highlight text, when a Text Processing Language (TPL) rule matches a string in a SYSOUT record captured by a selector rule or subselector rule. A TPL rule defines a "match-action" operation, where "match" is a regular expression that defines the text string to be searched for, and "action" is the writing of a specified output string to the operator. A set of TPL Rules is linked to an Output Manager selector rule or subselector rule to perform all text processing for a captured archive.

Important: ICSF must be installed and enabled to run the MD5 hashing service (CSNBOWH) required by TPL. If ICSF is not installed, the message "BJT1103E: TPL requires ICSF installed" is returned. If you do not plan to use TPL rules, you can ignore this message. If you do plan to use TPL rules, you must install and activate ICSF.

First you create a new TPL rule and then you assign it to a selector or subselector rule for a captured SYSOUT.

Each selector/subselector can be linked to more than one TPL rule, each rule can be linked to more than one selector/subselector, and each TPL rule can trigger more than one action. However, only one TPL rule can match a single line of a record: one rule will issue the WTO for that line, and processing continues on to the next line (unless the STOP action is specified, in which case TPL processing stops after the first TPL action is complete).

Note:
  • In order to prevent issuing WTOs for past events, TPL Rules are not processed for ISV recalls.
  • Exercise caution when implementing TPL rules. Ensure that you are not wasting resources by including any rules that match every line of your SYSOUTs, or by linking TPL rules to an unrelated selector. Creating rules that match every line will cause Output Manager to attempt to write WTO messages to the console for every line. Linking a TPL rule to an unrelated selector (for example, linking a TPL rule that looks for errors in inventory reports to a selector that captures SYSOUT for accounting reports), will waste resources because the inventory report errors never show up in the accounting reports.

Note: For more information on using regular expressions in the TPL search string, see section Regular expressions in TPL search strings.