Line Filters screen
Related Topics
The Line Filters screen shown in the following figure allows you to identify a character string that appears on a source line and is considered by users at your site to be either very important (critical filters) or unimportant (exclude filters). You can create a statement mask with clearly defined starting and ending positions. This screen is accessed by entering an S (Select the filter type for editing) line command in the Line Filters are ACTIVE/SUSPNDED field of the Code Coverage Report Filters selection screen.
Line Filters Screen
COMMAND ===> Scroll ===> HALF
Line Filters (Critical and Exclude)
Line commands: I Insert new filter Primary commands: DEL (Delete all)
D Delete filter ACT (Activate all)
A Activate filter SUS (Suspend all)
P Suspend filter from processing CAN (Cancel changes)
RET (Retrieve filters)
SAV (Save filters)
Type Position Word
CMD Stat C/E Statement Mask Start End Match
_ ACT C NEW-CUST-ID 12 50 N
_ ACT E CUSTOMER-ID 12 50 N
Line commands
The line commands shown in the figure above are defined as follows:
- I - Insert a new Line Filter
- D - Delete a Line filter
- A - Activate a Line filter that was previously suspended
- P - Suspend a Line filter (from processing) that was previously active
Primary commands
The primary commands shown in the figure above are defined as follows:
- DEL - Delete all lines (ACT or SUS) within the display
- ACT - Activate all lines (ACT) within the display
- SUS - Suspend all lines (SUS) within the display
- CAN - Exit the display without saving any changes
- RET - Invoke the filter retrieval process
- SAV - Invoke the filter save process
Input fields
Field | Description |
|---|---|
CMD | Specifies one of four available line commands that can be entered next to the Line filter statement mask you want to affect. |
Stat | A protected field indicating the active or suspended status of the statement mask. This field cannot be edited, but it can be changed with the A or P line command. |
Type C/E | A character value of C (Critical) or E (Exclude). |
Statement Mask | A user-specified character string. The statement mask is 1 to 50 positions in length and may contain any character, including embedded blanks. Duplicate masks are not allowed. The Type C/E field is not used when the check for duplicates is made. |
Position Start | A fixed column location from which a statement mask begins. If the starting position is not supplied and the ending position is supplied, then the starting position will be calculated so that the statement mask starts at the starting position and ends at the ending position. |
Position End | A fixed column location at which a statement mask ends. If the ending position is specified, the mask will be searched for between the starting and ending positions, inclusive. If the ending position is not supplied and the starting position is supplied, then the ending position will be calculated so that the statement mask starts at the starting position and ends at the ending position. |
Word Match | A character value of Y (Yes) or N (No). Y indicates that a character string on the source line will only be considered a match if it is a standalone word within the boundaries set by the Start and End Positions, inclusive, with at least one blank before the string and either a blank, period, comma, or semi-colon immediately after the string. N indicates that a character string on the source line between the Start and End Positions will be considered a match even if it is not a standalone word. |