Creating TPL rules

Authorized Administrators can create TPL rules from the Text Processing Language Rule Administration option, available from the Administrative Functions menu in ISPF.

Procedure

  1. Navigate to the TPL Rule panel (ISPF A.T).
  2. Specify search criteria, or leave the fields blank, and press Enter.
    The resulting list is filtered by your search criteria.
  3. Type ADD on the command line and press Enter.
    The TPL Rules Details panel is displayed.
  4. Required: In the Rule Name field, type a unique name for the TPL Rule.
    This name can be up to 64 characters in length.
  5. In the Status field, specify whether the TPL rule is ENABLED (active) or DISABLED (inactive).
  6. In the TPL Rule field, type the variables and literal values that you want to use as the TPL rule.
    The following syntax must be used:
    WHEN <location range> MATCH "search expression"
    THEN <ACTION>
    Where <location range> is the input lines on which the search expression must match, "search expression" is a text- matching regular expression, and <ACTION> is the action (either WTO "output string", HIGHLIGHT, or STOP) to be performed when the search expression criteria is matched.
    Note: For more information on TPL Rule syntax, see TPL rule syntax. For more information on supported regular expressions, see Regular expressions in TPL search strings.
  7. When you are finished, press F3 (Exit).
    An exit confirmation pop-up window is displayed. Press Enter to save the TPL Rule. The TPL Rule panel is redisplayed. A TPL rule is active as soon as it is saved and linked. A Policy Activate is not necessary.
    Note: If your TPL rule contains a syntax error, an error message is displayed and you cannot save the rule until it has valid syntax. The error message will contain information to help you resolve the invalid syntax. For example, an invalid semicolon outside of the WTO output string at position 48 would trigger the error message "Syntax problems: Syntax error: unrecognized or extraneous input near position 48".