Type the data set name of the first input file to the compare function. The data set is compared to the data set specified in the "NEW" data set section of the screen. The Data Set Compare screen displays when you enter a sequential file, PDS, or VSAM file. The Program Compare screen displays when you enter a loadlib or load library member.
The "OLD" Member Name can be used when the "OLD" data set is a PDS. This field can contain the following:
Type the data set name of the file you want compared to the "OLD" file. Enter a sequential file, PDS, or VSAM file on the Data Set Compare screen. Enter a loadlib or load library member on the Program Compare screen.
The "NEW" Member name can be used when the "NEW" data set is a PDS. Leave this field blank to when comparing multiple members.
Select the print format for any mismatched records that are found during the compare. You can specify character, or hex formats for both data set and program compares. For the Data Set Compare screen, single record format is also an option. If you chose single record format, specify a record layout data set and member to use for formatting the records.
Controls which of the records are displayed. Enter one of the following values:
All—all records in the file are displayed, flagging mismatched data.
Mismatch—only mismatched records are displayed. This includes, inserted, deleted and changed records. Mismatched data in the changed records are flagged.
Summary—only a Summary report is displayed.
If you selected Single Record Format for the Print Format option, use this option to specify whether to print all fields in a mismatched record or only fields that have a mismatch.
To compare only a portion of each record, specify the old-position, length, and new-position in these fields. If the new-position is not specified, it defaults to the old-position. Enter BUILD in the old position field to execute a process that builds POSITION and SYNCKEY keywords using record layouts.
Specifies how the function is executed. Specify one of the following values:
Perform the function online
Generate and submit JCL to perform the function
Generate JCL to perform the function and initiate an edit session on the JCL. You can alter the JCL as needed and then submit the JCL or save it to another location.
Type the DSN of the Record Description Copy Library member that describes the file to be searched. You can also type a wildcarded DSN to request a list of data sets from which you can select the desired data set. This field is required when using the LAYOUT primary command.
Type the Member Name of the Record Description Copy Member that describes the input file.
Leave this field blank to receive a directory of the members in the Layout data set. You can also type a wildcarded member name to receive a directory of members that match that wildcard.
Specify the LAYOUT command on this panel when you specify a layout data set and member and you also want to build the selection criteria dynamically by field names defined in the record layout.
Selection criteria are used to restrict your view to certain members or records based on the following types of parameters:
For a complete explanation of selection criteria and examples of valid syntax, see the chapter "Filters."
Use a cataloged Selection Criteria parameter member that has been defined using CA File Master Plus Option 0.3.
Use the primary command LAYOUT.
Controls the maximum number of mismatches allowed before the COMPARE command is terminated. Mismatches are defined as inserted, deleted, or changed records.
Enter an integer value from 0 to 99999.
The default value is zero, which sets no maximum limit. However, the default may have been changed during product installation by updating the '&BAT_COMPDIFF' option.
Controls the maximum number of lines per page for the SYSLIST output file.
Enter an integer value from 1 to 9999.
The default value is 60. However, the default may have been changed during product installation by updating the '&BAT_LINEPAGE' option.
Controls how CSECTs are compared. Enter one of the following values:
Name—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.
Order—CESCTs are compared in the order in which they appear in the program
Controls how the program properties selected in the Properties options section are used for the comparison of programs.
Include—the selected program properties are included in the comparison.
Exclude—the selected program properties are excluded from the comparison.
Lists the properties you can specify for a program compare. Enter an S to select an option from the list. Enter a blank character to clear a previously selected option. Following are possible options:
The program link attributes: reentrant, reusable, refreshable, authorization code, amode, rmode and SSI
The actual module text
The date carried in Binder IDR_B records
The name of the CSECTs
The size of the CSECTs
The load module entry point
External symbol information carried in Binder B_ESD records, such as external references
Information carried in Binder B_IDRU records added as a result of the Binder IDENTIFY statement or programmatically by, for example, Endevor
IDR ZAP information carried in Binder B_IDRZ records
The date and time the program was linked
The size of the load module or program object
Compiler information
Controls which CSECTs are included or excluded from the program comparison.
Specify CSECTs or the range of CSECTs for comparison on the three lines in the CSECT Selection section of the screen. Each line is composed of two fields.
The first field controls the action that applies to the CSECTs specified in the second field. Enter one of the following values:
Include—the CSECTs are included in the comparison.
Exclude—the CSECTs are excluded from the comparison.
The second field identifies the CSECTs that are included or excluded from the comparison. Enter a list of CSECT names or range of CSECTs. The following rules apply to the CSECTs list:
Enter BUILD in the OLD POSITION field to initiate the process to build Position and Synckey keywords using record layouts. This process allows a layout file to be used for each data set so that field names can be matched to build the keywords. The Dataset Compare Layouts screen is used to specify the layout data set corresponding to the old and new data set in the compare. The two layouts are initially populated with the layout file and member that was entered on the Compare screen, if there was one.
--------------- CA File Master Plus -- Dataset Compare Layouts ----------- COMMAND ===> "OLD" Dataset Record Layout: Dataset name ===> ‘CUSTOMER.PROJECT.COPYLIB’ Member name ===> CUSTFLE2 "NEW" Dataset Record Layout: Dataset name ===> ‘CUSTOMER.PROJECT.COPYLIB’ Member name ===> CUSTFLE3 ENTER or END to proceed CANCEL to return
The old and new layout files can be the same. To assist in the specification of DSNs, each of the DSN fields on this screen has support for wildcarded DSNs and DSN Lists.
Use ENTER or END after entering the layout information to access the Generate Position and Synckey Keywords screen.
CA File Master Plus - Generate Position and Synckey Keywords COMMAND ===> SCROLL ===> CSR OLD Record ------------ CUSTFLE2 of 'CUSTOMER.PROJECT.COPYLIB' ---------------- A Num Field Name Pos Format SYNCKEY Parms Row 1 of 26 _ 1 CUSTOMER-RECORD 1 160 _ 2 CUST-REC-TYPE 1 C 1 _ 3 CUST-ID 2 C 7 _ 4 CUST-NAME 9 C 15 _ 5 CUST-STREET 24 C 18 _ 6 CUST-CITY 42 C 12 _ 7 CUST-STATE 54 C 2 _ 8 CUST-ZIP-CODE 56 C 10 NEW Record ------------ CUSTDLE3 of 'CUSTOMER.PROJECT.COPYLIB' -------------- Num Field Name Pos Format Compare To Row 1 of 27 1 CUSTOMER-RECORD 1 160 2 CUST-REC-TYPE 1 C 1 CUST-REC-TYPE 3 CUST-ID 2 C 7 CUST-ID 4 CUST-NEW-FIELD 9 C 5 5 CUST-STREET 14 C 18 CUST-STREET 6 CUST-CITY 32 C 12 CUST-CITY 7 CUST-STATE 44 C 2 CUST-STATE 8 CUST-NAME 46 C 15 CUST-NAME
The top section of the screen presents the record layout of the OLD record. The bottom section of the screen presents the NEW record layout. This section contains a field on each line for entering either the Field Name or relative field number of the OLD field to compared to the NEW record.
The fields entered in the Compare To field are used to generate a Position keyword. The screen defaults to compare all nongroup fields that have the same Field Name in the OLD and NEW records.
To generate a Synckey keyword, type ‘S’ next to the field in the OLD file that you want to synchronize on. This field must be listed in the COMPARE TO column next to the corresponding field in the NEW file section. The Define Synckey Parameter screen is then displayed.
------------------------- Define SYNCKEY Parameter ----------------------- COMMAND ===> Update SYNCKEY settings by overtyping the displayed values. Old Synckey Field: CUST-ID New Synckey Field: CUST-ID SYNCKEY Order ===> 1 Key ===> N (N = NOKEY | A = ASCENDING | D = DESCENDING) Print ===> P (P = PRINT | N = NOPRINT) ENTER or END to process CANCEL to return
This field on the old record syncs to the NEW Synckey Field.
This field on the new record syncs to the OLD Synckey Field.
This field determines the order in which the Synckey keywords are processed, starting with the number 1. The number is initialized to the next highest number. You can change this number, but not to one that has already been entered.
This field specifies the type of compare.
Specifies a nonkeyed compare.
Specifies that it is a keyed compare and the keys are in the order indicated by this parameter.
This field defines whether the Synckey values are printed in the compare report.
The information entered for the Synckey is displayed on the Generate Position and Synckey Keywords screen when you return.
CA File Master Plus - Generate Position and Synckey Keywords COMMAND ===> SCROLL ===> CSR OLD Record ------------ CUSTFLE2 of 'CUSTOMER.PROJECT.COPYLIB' ---------------- A Num Field Name Pos Format SYNCKEY Parms Row 1 of 26 _ 1 CUSTOMER-RECORD 1 160 _ 2 CUST-REC-TYPE 1 C 1 _ 3 CUST-ID 2 C 7 _ 4 CUST-NAME 9 C 15 _ 5 CUST-STREET 24 C 18 _ 6 CUST-CITY 42 C 12 _ 7 CUST-STATE 54 C 2 _ 8 CUST-ZIP-CODE 56 C 10 NEW Record ------------ CUSTDLE3 of 'CUSTOMER.PROJECT.COPYLIB' -------------- Num Field Name Pos Format Compare To Row 1 of 27 1 CUSTOMER-RECORD 1 160 2 CUST-REC-TYPE 1 C 1 CUST-REC-TYPE 3 CUST-ID 2 C 7 CUST-ID 4 CUST-NEW-FIELD 9 C 5 5 CUST-STREET 14 C 18 CUST-STREET 6 CUST-CITY 32 C 12 CUST-CITY 7 CUST-STATE 44 C 2 CUST-STATE 8 CUST-NAME 46 C 15 CUST-NAME
Page the sections of the screen for the OLD and NEW records either together or separately. To page both the top and bottom sections together, position the cursor in the top three lines of the screen when making the forward or backward paging request. To page the OLD or NEW section only, position the cursor anywhere within the screen section that you want to page.
The keywords are generated when you exit the Generate Position and Synckey Keywords screen and return to the Compare screen. A Position keyword is generated for each field on the bottom section of the screen that has a field entered in the Compare To field. The Synckey keywords are generated based on the order entered in the Synckey order.
An action field used to generate Synckey keywords.
Following are the valid values for this field:
Defines or modifies a Synckey
Removes a Synckey that has already been defined
The relative field number of the field
The name of the field
Following are the indentation rules for the Field Name column:
The starting position within the record of the field
The data type indicator followed by either the number of digits or characters allowed for the field as defined by the field definition.
Valid data type indicators are the following:
Binary
Alphanumeric
Floating-point
Zoned numeric
Packed
Signed
The COMPARE TO column is located in the bottom section of the screen. This section is used to define the field names from the OLD Record that you want compared to the NEW Record. The screen is initially displayed with field names from the OLD layout automatically paired with fields of the same name from the NEW layout.
Following are the valid values for this field:
When a relative field number is typed, the field number is translated to a Field Name.
If your data set contains multiple record layout definitions, you may want to control building position keywords for only the records you are comparing. The files you are comparing may have multiple record formats that require comparison of different positions for each one. You can define a CRL position to define the conditions to use each record layout. You can then use this position as input for the Build Keywords process.
When CRLs are entered into the data set names on the Dataset Compare Layouts screen, the Old and New CRL File Matching screen appears. This screen allows you to match the old and new record layouts that you want to compare. The COBOL 01 level names are shown for each to allow you to do the matching.
---------- CA File Master Plus - Old and New CRL File Matching ------------- COMMAND ===> SCROLL ===> CSR OLD CRL File ----------- CUSTFILE of 'CUSTOMER.PROJECT.OLD.LAYOUT' ------------ Num 01 Level Field Name Row 1 of 2 1 CUSTOMER-CONTROL 2 CUSTOMER-PROFILE ****************************** End of 01 Levels *******************************
NEW CRL File ----------- CUSTFILE of 'CUSTOMER.PROJECT.NEW.LAYOUT' ------------ Num 01 Level Field Name Compare To Row 1 of 2 1 CUSTOMER-CONTROL CUSTOMER-CONTROL 2 CUSTOMER-PROFILE CUSTOMER-PROFILE ****************************** End of 01 Levels *******************************
The relative number of the 01 level.
The field name of the 01 level.
The COMPARE TO column is used to define the 01 level from the OLD Record that you want compared to the NEW Record. The screen is initially displayed with the names from the OLD layout automatically paired with those with the same name from the NEW layout.
Valid values for this field are:
When a relative field number is typed, the field number is translated to a Field Name.
The 01 Level Field Name of a layout from the OLD record whose value you want compared.
The relative number of the 01 level.
The field name of the 01 level.
The COMPARE TO column is used to define the 01 level from the OLD Record that you want compared to the NEW Record. The screen is initially displayed with the names from the OLD layout automatically paired with those with the same name from the NEW layout.
Valid values for this field are:
When a relative field number is typed, the field number is translated to a Field Name.
When the matching is complete, press the PF3 key to pass control to the Layout Selection screen.
CAWAPCMB --------- CA File Master Plus -- Layout Selection ------ Row 1 of 2 COMMAND ===> SCROLL ===> CSR "Old" Dataset Record Layout: CUSTOMER.PROJECT.OLD.LAYOUT(CUSTFILE) Description: this crl maps the old file "New" Dataset Record Layout: CUSTOMER.PROJECT.NEW.LAYOUT(CUSTFILE) Description: this crl maps the new file S - Select Layout A “Old” 01 Level Field Name “NEW” 01 Level Field Name Positions S CUSTOMER-RECORD CUST-RECORD Y _ CUSTOMER-CONTROL CUSTOMER-CONTROL N ****************************** End of 01 Levels *******************************
Enter an S next to the 01 level combination and press the Enter key to go to the Generate Position and Synckey Keywords screen for those 01 levels. Press the PF3 key to return to the Layout Selection screen. The Positions Generated column will be updated with a ‘Y’. To complete the process of building Position keywords, repeat this for each record layout that will be involved in the compare.
To generate the keywords, exit the Generate Positions and Synckey Keywords screen or the Layout Selection screen to return to the Dataset Compare screen. To view the batch JCL including the generated keywords in EDIT mode, enter ‘E’ in the execution mode on the Compare screen. Save the JCL to your own file or PDS if you want to reuse it.
If the BUILD function has been executed and keywords generated, a warning panel displays when you exit the Compare screen. Press ENTER to delete the generated keywords and return to the previous menu. When you press the END or PF3 keys, you are returned to the Compare screen. Execute the Compare to generate the keywords.
---------------- Compare Build Warning ----------------- COMMAND ===> You have generated keywords with the BUILD Function. Press ENTER to delete the keywords and exit compare. Enter END to return to the compare screen. Select Execution mode 'E' to Edit the JCL to review modify, and save the job to a permanent file.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|