Compare Utility: Load module options panel

The Compare Utility - Load module options panel (Compare Utility: Load module options panel) allows you to specify the way in which the load module comparison is processed and the type of listing produced.

Panel and field definitions

Figure 1. Compare Utility: Load module options panel
  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.

Parent panels

The Compare Utility: “New” panel.

Child panels

  • None.

Equivalent functions

Related tasks and examples