Compare Utility: Load module options panel

Panel and field definitions

  Process   Options   Help
──────────────────────────────────────────────────────────────────────────────
 FMNPDSML ger    Compare Utility : Load Module Options              
                                                                   More:     +
 Compare Options:
    Compare level      Listing type     Long Report
    2  1. Module       2  1. Summary    Enter "/" to exclude
       2. CSECT           2. Delta         Inserted
                          3. Matching      Deleted
                          4. Long          Changed
                          5. None          Matched                  Exclude
    CSECTs  . . cee*                                                     +   /
 
 Load module criteria:                   CSECT criteria:
    Enter "/" to select option              Enter "/" to select option
    /  Size                                 /  Size
    /  Entry point address                  /  Address
    /  Linkage editor/Binder                /  Compiler
    /  Link date and time                   /  Compile date
    /  AMode/RMode                          /  AMode/RMode
    /  AC                                   /  IDR ZAP data
    /  Link attributes                         Text
                                            /  Compile Options
                                               Program Attributes

 Processing Options:                     Listing Options:
    Enter "/" to select option              Enter "/" to select option
    /  Clear print data set                 /  Wide listing
                                            /  Highlight changes
                                               Show changed fields only
                                            /  YY/MM/DD (default: YYYY.DDD)

                                         Number of differences to report ALL   

 Command ===>                                                                   
  F1=Help      F2=Split     F3=Exit      F4=CRetriev  F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel

Compare Options

Compare Level

1. Module

Only information on the load module level is extracted and compared. CSECT information (and differences on CSECT level) are ignored. This is a general comparison.

2. CSECT

Information on both levels, load module and CSECT, is extracted and compared. This is a more detailed comparison.

Listing type

1. Summary

Generates a summary listing only.

2. Delta

Generates a delta listing containing all deleted and inserted records, as well as a summary.

3. Matching

Generates a listing containing only matching records, and a summary. Matching records are only listed once.

4. Long

Generates a listing containing all matching and non-matching records. Matching records are only listed once.

5. None

Suppresses the listing. A message is issued to indicate whether or not the data sets match.

Long Report

Selecting one or more of these options causes the compare result types to be excluded from the report. These options are used in conjunction with the Long listing type to tailor the output report. If a listing type other than Long has been selected, these options are ignored.

Inserted

When selected, excludes inserted records from the report.

Deleted

When selected, excludes deleted records from the report.

Changed

When selected, excludes changed records from the report.

Matched

When selected, excludes matched records from the report.

MQ Processing

Include descriptors

If this is selected (with the / character), the message descriptor data returned by the GET MQ API is added as a prefix to the record data, allowing this data to be examined in conjunction with the message data.

Otherwise only the message data is available for processing.

CSECTs

Specify string values used to filter the CSECTs to be included in or excluded from compare processing. If this field is blank all CSECTs will be included for comparison.

Multiple string arguments can be entered. Use the comma character as a delimiter between the strings. Strings can contain the * and % wildcard characters.

To specify a filter containing lowercase characters, use a character string in the format c'string'. Filters can also be specified as hexadecimal strings in the format x'hex-digits'.

The following is an example of a filter that would include or exclude from processing Language Environment and COBOL runtime CSECTs from a load module containing an LE-enabled COBOL program:

CEE*,IGZ*

Exclude

Specify / to exclude CSECTs with names that match the specified CSECT filters from being compared. If this option is not selected the filters are used to include only those CSECTs with matching names for comparison.

Load module criteria

Selecting one or more of these options determines which load module properties are compared and reported. By deselecting some of the options, you exclude associated information from comparison. In this way, only differences of interest to you are shown; others are hidden.

Size

Specify / to include the load module size in the comparison.

Entry point address

Specify / to include the load module entry point address in the comparison.

Linkage editor/Binder:

Specify / to include the version of the linkage editor or binder used to prepare the load module in the comparison.

Link date and time:

Specify / to include the load module link (bind) date and time in the comparison.

AMode/RMode:

Specify / to include the AMODE and RMODE of the load module in the comparison.

AC:

Specify / to include the load module authorization code in the comparison.

Link attributes

Specify / to include the load module link attributes in the comparison.

CSECT criteria

Selecting one or more of these options determines which CSECT properties are compared and reported. By deselecting some of the options, you exclude associated information from comparison. In this way, only differences of interest to you are shown; others are hidden. These options are used in conjunction with the Compare level option. If CSECT has not been selected, these options are ignored.

Size

Specify / to include the CSECT size in the comparison.

Address

Specify / to include the CSECT address in the comparison.

Compiler:

Specify / to include the version of the language compilers used to compile the CSECT in the comparison.

Date:

Specify / to include the date of the CSECT compile in the comparison.

AMode/RMode:

Specify / to include the AMODE and RMODE of the CSECT in the comparison.

IDR ZAP data:

Specify / to include AMSPZAP IDR data in the comparison. Note that the IDR ZAP data constitutes separate records to be compared, but as it is associated with the CSECT, the IDR ZAP data should be seen as an extension of the CSECT data.

Text

Specify / to include the CSECT content in the comparison. Note that the CSECT content is compared and then reported as a set of separate 32-byte records in "memory dump" format (hexadecimal and character), but as it is associated with the CSECT, the CSECT content should be seen as an extension of the CSECT data. If you select this option, the wide listing option is set to accommodate the dump format that is required for comparison.

Compile Options

Specify / to activate comparison of CSECT compiler options.

Program Attributes

Specify / to activate comparison of program language attributes.

Processing Options

Clear print data set

Specify / to clear the print data set before use. This option has no effect if print output from File Manager is not directed to a data set. See Setting your Print Processing Options for more information about controlling the print data set.

Listing Options

Wide listing

Specify / to generate a wide listing. Wide listing is easier to analyze as the corresponding data in the "New" and "Old" records are vertically aligned and the width of the record does not exceed the maximum record length supported by the printer.

Highlight changes

Specify / to highlight any differences between “Old” and “New” records. For record comparisons and wide formatted comparisons, the differences are indicated with a change bar (|) beneath the altered bytes. For narrow formatted comparisons, the fields that have changed are indicated by placing an asterisk (*) to the left of the field name.

Show changed fields only

Specify / to report only changed fields (for a narrow-formatted report).

YY/MM/DD (default: YYYY.DDD)

Specify / to show dates in YY/MM/DD format. Otherwise, YYYY.DDD is used.

Number of differences to report

The number of differences after which the Compare Utility stops processing the data sets.