Do not process lines

There are two Do Not Process Lines process statements:

DPLINE: Do not Process Lines
DPLINEC: Do not Process Lines Continuation

These options remove from the compare (or search) set all lines that can be recognized by either a unique character string or combination of related strings all appearing on the same input line. DPLINEC is the continuation of the immediately preceding DPLINE or DPLINEC process statement. All the strings in a DPLINE/DPLINEC group must be found on the same input line.

A start_column or start-range can also be used to restrict the columns. Relative start_columns and start-ranges are valid only on DPLINEC statements.

Compare Types: LINE, WORD, and Search


>>-DPLINE------------------------------------------------------->

>--'--string--'--+-------------------------------------------+-><
                 '-,--start_column--+----------------------+-'   
                                    '-:--last_start_column-'


>>-DPLINEC------------------------------------------------------>

>--'--string--'--+----------------------------------------------+-><
                 +-,--start_column--+----------------------+----+   
                 |                  '-:--last_start_column-'    |   
                 +-,--+--start_column--+----------------------+-+   
                 |                     '-:--last_start_column-' |   
                 '-,--+ ----------------------------------------'

string: A character or hexadecimal string enclosed within apostrophes. For one embedded apostrophe, use two consecutive apostrophes ('').
start_column: The column in, or after which, the string must start.
last_start_column: The last column in which the string may start. (Must be separated from the start_column by a colon.)
+start_column: The relative column, following the location of the previous string (as specified in the previous DPLINE or DPLINEC statement), in, or after which, this string must start.
last_start_column: The relative last column, following the location of the previous string (as specified in the previous DPLINE or DPLINEC statement), in which this string may start.
+: The specified string may appear anywhere following the location of the previous string (as specified in the previous DPLINE or DPLINEC statement).

Example: Description
DPLINE 'ABCDE': Scans all columns for string "ABCDE"
DPLINE 'AbCde',2: Scans only column 2 for start of string "AbCde"
DPLINE 'AbCde',2:2DPLINEC 'BDEF': Same as above example. String "BDEF" must be on the same line as the string "AbCde"
DPLINE 'ABCDE',2:50: Scans only columns 2 through 50 for start of string "ABCDE"
DPLINE 'AB''CD',2:50: Scans only columns 2 to 50 for start of string "AB'CD"
DPLINE X'C1C27BF1',2:50: Scans only columns 2 to 50 for start of hexadecimal string X'C1C27BF1'
DPLINE 'ABC'DPLINEC 'BDEF',+: Scans for string "ABC"; if found, then scans for string "BDEF" in the same line (following "ABC")
DPLINE 'ABC'DPLINEC 'BDEF',+5: Scans for string "ABC"; if found, then scans for string "BDEF" starting in the 5th column after the starting column of "ABC"
DPLINE 'ABC'DPLINEC 'BDEF',+5:12: Scans for string "ABC"; if found, then scans for string "BDEF" starting anywhere in the 5th to 12th columns after the starting column of "ABC"