Previous Topic: SyntaxNext Topic: Keywords


COMPARE Command Keywords Summary

The following list shows the valid keywords for the COMPARE command.

ADDCNTL

Includes or omits a member separator when comparing PDS members and writing compared records to a sequential file.

CHANGED

The sequential output file to which the changed records are written.

COMPDIFF

Maximum number of mismatches before the compare is terminated. The command terminates when this value is exceeded.

Default: 0*

COMPRC

Job step return code if mismatches are found. Default value is 4*.

COMPREPORT

A—All records in the file are displayed noting differences.
M—Only mismatched records are displayed.
S—Only a summary report is displayed.

Default: M

DELETED

The sequential output file to which the deleted records are written.

DIRREPORT

Controls the directory report when comparing PDS members.

A—All records in the file are displayed noting differences.
M—Only mismatched records are displayed.
S—Only a summary report is displayed.

Default: M

INSERTED

The sequential output file to which the inserted records are written.

MATCHED

The sequential output file to which the matched records are written.

MEMBER

Specifies which PDS members to process.

NEWFILE

ddname of the new file to be compared. Default value is SYSUT1N*.

dsname(member) data set name and optional member.

NEWRID

Record key or record number to position the new file.

OLDFILE

ddname of the old file to be compared. Default value is SYSUT1O*.

dsname(member) data set name and optional member.

OLDRID

Record key or record number to position the old file.

POSITION

Compares only these specific positions in the NEWFILE to the OLDFILE. This keyword can be specified multiple times.

PROGRAM

Indicates the comparison is made between load modules.

CSECTCOMPARE

Controls how CSECTs are compared. Possible values are BYNAME and BYORDER.

BYNAME

CSECTs with identical names are compared. CSECTs that exist only in the old file are reported as deleted. CSECTs that exist only in the new file are reported as inserted.

BYORDER

CSECTs are compared in the order in which they appear in the program.

Default: BYNAME is the default value.

CSECTEXCLUDE

Identifies CSECTs excluded from the comparison.

CSECTINCLUDE

Identifies CSECTs included in the comparison.

Default: All CSECTs are compared.

Note: CSECTINCLUDE and CSECTEXCLUDE keywords are allowed for the COMPARE PROGRAM only.

PROPERTIESEXCLUDE

Identifies the properties excluded from the comparison.

Parameters for PROPERTIESEXCLUDE and PROPERTIESINCLUDE include the following:

ATTRIBUTES

The program link attributes: reentrant, reusable, refreshable, authorization, code, amode, rmode, and SSI.

CONTENT

The module text.

CSECTDATE

The date carried in Binder IDR-B records.

CSECTNAME

The name of the CSECTs.

CSECTSIZE

The size of the CSECTs.

ESD

External Symbol Information carried in Binder B_ESD records; for example, external references.

ENTRYPOINT

The load module entrypoint location.

IDRUSER

Information carried in Binder B_IDRU records added as a result of the Binder IDENTIFY statement or programmatically by, for example, Endevor.

IDRZAP

IDRZAP information carried in BINDER B_IDRZ records.

LINKDATE

The date and time the program was linked.

TOTALSIZE

The size of the load module or program object.

TRANSLATOR

Identifies compiler information.

Default: All program properties are compared.

PROPERTIESINCLUDE

Identifies the properties included in the comparison.

RID

Record key or record number to position both the new file and old file.

SYNCKEY

Specify fields used to synchronize records for sequential files or PDS members.

SYNCLIM

Number of records to read ahead in the opposite file before a mismatch is declared.

Default: 50*

Note: The default values may have been changed during product installation.

For detailed information about these keywords, see the chapter "Keywords" in this guide.