General Information

Control-M/Analyzer reads the data sources identified in SOURCE1 and SOURCE2, line by line, and sends each line to the ON COMPARE Differences algorithm. However, if a Process has been specified for a data source, the input line is processed accordingly before it is sent to the Differences algorithm (for example, the Process may change the line using substitute masks, function SUBSTR, string concatenation, and/or some other mechanism). In this case, the modified (for example, processed) input line is sent to the Differences algorithm.

After Control-M/Analyzer has sent all input lines to the Differences algorithm, the Differences algorithm searches for the longest identical sequence of lines in both files to synchronize changes. The algorithm is implemented recursively until all identical lines have been found.

For each remaining (non-identical) line, Control-M/Analyzer performs the WHEN block (see diagram below). In the WHEN block, the SYSCURLINE system variable holds the current line and the logical DIFF line indicates the following information:

Table 255 Contents of DIFF Line After ON COMPARE Processing

Datum	Description

LINE STATUS	Status of the current line. Possible values are:
	INSERTED	Line exists in source 1 but not in source 2.
	DELETED	Line exists in source 2 but not in source 1.
	REPLACED	Line is not identical in sources 1 and 2.
SOURCE1 LINE NUMBER / RANGE	Line number of the current line from data source 1, or line range of the replaced lines.
SOURCE2 LINE NUMBER / RANGE	Line number of the current line from data source 2, or line range of the replaced lines.

The ON COMPARE block cannot contain ON, DO TERMINAT, DO RULE, or DO EXIT statement types:.

The following source restrictions are applicable:

The SYSOUT parameter can be used only once in an ON COMPARE statement (for example, to specify SOURCE1 or SOURCE2, but not both).
The SYSOUT parameter can only specify a sysout that was closed before the current step began.
The FILE and DD Parameters can specify a file that was created in the current step if the file is closed before the ON COMPARE block is invoked.

Based on these source restrictions, sysouts can be compared by the following methods:

To compare the sysout of the current job with another sysout, specify the current sysout by the DD parameter and the other sysout by the SYSOUT parameter.
To compare two sysouts when neither is of the current job, copy one sysout to a file, specify that file using the FILE parameter, and specify the other sysout using the SYSOUT parameter.

Parent Topic

ON COMPARE: Data Selection Parameter