Comparing Package Components to Promotion or Baseline
This chapter describes the compare function that shows differences between a package component and same component in a promotion or baseline library.
About Compare Component
The compare component function produces a report that shows the differences between a component in a package staging library and the same component in a promotion or baseline library.
You can use this function to:
-
See what changes you have made to a component since you checked it out from baseline.
-
Help you decide whether to overlay a component with the same name in a promotion library.
-
Help resolve a SYNCH10! condition where the baseline version of a component has changed since you checked the component out.
Accessing Compare Component Panels
Use one of these methods to display the Compare panel:
-
Using the Menu Hierarchy:
-
On the Primary Option Menu, select 1 Build.
-
On the Build Option panel, select C Compare.
-
-
Using Direct Panel Access:
On a ChangeMan ZMF panel, type =1.C in the Command or Option line and press Enter.
-
Using the Change Package List:
On the Change Package List panel, type CC in the line command for a change package and press Enter.
Specifying Components to Compare
To compare one or more package components to the same component in a promotion or baseline library, bring up the Compare panel (CMNCOMP1). See Accessing Compare Component Panels.
...
CMNCOMP1 Compare
Command ===> _______________________________________________________
Compare mode . . . . 1_ (1-Online; 2-Batch)
Package . . . . . . TEST001852_
Component . . . . . ___________________________________________________________ +
(* for all members; blank for list)
Text type . . . . . ____ (text type to be compared)
Library type . . . JCL_ (Blank for list)
Source library . . 0_ (Baseline 0 to -n; Promotion 1 to n)
Data Encoding . . . __ (1-ASCII, 2-UTF-8)
Enter "/" to select option
_ Prompt for report disposition
Job statement information for batch compare:
//WSER73T1 JOB (0),'L TEST CMP . ',___________________________________________
// NOTIFY=WSER73,CLASS=D,MSGCLASS=X____________________________________________
//* ___________________________________________________________________________
//* ___________________________________________________________________________
This table describes the fields on the Compare panel.
| Field | Description |
|---|---|
| Command | C: Compare the component specified in the COMPONENT NAME field. Blank:** Display selection list of components in the staging library. |
| Compare mode | 1:** Execute compare online. |
| 2:** Execute compare in a batch job. | |
| Package | Type the ID of the package that contains the components to be compared to a promotion or baseline library. |
| Component | Type a component name. Leave this field blank or type a pattern for a selection list of components in the staging library. If the specified LIBRARY TYPE is an zFS type, then the text in the COMPONENT NAME field is processed exactly as entered; otherwise the text is folded into upper case before processing. Note: Component names are truncated to 160 characters in the compare component function. |
| Data Encoding | This option can be used to view components stored using a CCSID representing ASCII or UTF-8 characters. This option has no effect when using browse. |
| 1 - Enables ASCII conversion for ISPF view. | |
| 2 - Enables UTF-8 conversion for ISPF view. | |
| Text type | Type a value to specify how the text in the component should be compared. Default: $. (dollar sign and period) This is usually sufficient to get valid compare results. General Types: $: Prefix to any TEXT TYPE to force a position-by-position comparison and to flag lines as different even if the only differences are the positions of spaces and commas. Example: $JCL . (period) Automatically set TEXT TYPE from an analysis of the first four records. Differences in spacing and commas are ignored as described in Specific Types below. Specific Types: If TEXT TYPE is ALC, BAL, C, CLIST, JCL, FORTRAN, NATURAL, PASCAL, PL/1, PL/I, PL1, PLI, REXX, or RPG, then spaces are squeezed out as not significant. If TEXT TYPE is COBOL, then spaces and commas are squeezed out as not significant. Only positions 7 through 72 of the record are compared. If TEXT TYPE is PANEL, REPORT, or SCRIPT, then no characters are squeezed out. |
| Library type | Type the library type of the components you want to compare. Leave this field blank for a selection list of library types in the package. |
| Source library | Type a number to indicate the baseline version or promotion level to compare to. -1 to -999: Compare to a prior version in a baseline library. The negative number represents a relative prior baseline version. For example, -1 means the version immediately prior to the current version. 0: Compare to the current (0-level) baseline library. <br. +1 to +99: Compare to a version in a promotion library. The positive number is a promotion level number in any promotion site. For example, +10 means promotion level 10 in any promotion site. Blank: Display a selection list of baseline and promotion libraries that contain the specified component. Note: The COMPONENT NAME field cannot be blank or a pattern if you want a list of libraries. |
| Prompt for report disposition | If you specify 1 Online for COMPARE MODE: Select this option to display the Specify Report Disposition panel after the comparison report is displayed in an ISPF panel. If not selected, then suppress the Specify Report Disposition panel after the comparison report is displayed in an ISPF panel. |
| Job statement information for batch compare | If you specified 2 Batch for COMPARE MODE, type job statement information for the batch job that ChangeMan ZMF submits to compare components. |
If you type C on the Command line, a full component name in the Component field, and type an entry in every other field on the Compare panel, the compare component function executes directly (unless you are comparing a package component to a promoted component). Go to Compare Component Results.
Otherwise more panels are displayed so you can choose the library to compare to and choose the staging library component to compare:
-
If you specify a promotion level number (+nn) in the Source library field, the Promotion Library Selection List panel (CMNCPLSL) is displayed so that you can select the promotion library that you want. See Choosing a Promotion Library.
-
If you specify a full Component name (not a pattern) and leave the Source library field blank, the component.type Library List panel (CMNCMLSL) is displayed so that you can select the baseline level or promotion library that you want. See Choosing a Promotion or Baseline Library.
-
If you leave the Command line blank or if you type a pattern in the Component field, the Compare From libtype - stagelib panel (CMNCOMPL) is displayed, which lists components in the package staging library for the library type you specified. This panel is displayed after you select a promotion or baseline library if your entry in the Source library field sends you to other panels to make that choice. See Choosing a Package Component to Compare.
Choosing a Promotion Library
On the Compare panel, if you specify a promotion level number (+nn) in the Source library field, the Promotion Library Selection List panel (CMNCPLSL) is displayed.
...
CMNCPLSL Promotion Library Selection List Row 1 to 2 of 2
Command ===> Scroll ===> CSR
Library type: SRC Promotion level: +10
Dataset Name Site
__ CMNTP.S6.V810.PROM.S6P1UT.SRC + S6P1UT SERT6
__ CMNTP.S6.V810.PROM.S6P1UT1.SRC + S6P1UT1 SERT6P1
******************************* Bottom of data ********************************
This panel displays all of the promotion libraries that are defined in application administration for the specified library type and promotion level number, even if the package or the component you want to compare is not promoted to this level. More than one library is listed if the specified promotion level number is used in multiple promotion sites.
This table describes the fields on the Compare From libtype - stagelib panel.
| Field | Description |
|---|---|
| Command | Type one of the following commands, or leave the command line blank and type a line command next to a library name. Cancel: Cancel the function and return to the previous panel. Abbreviation: C or CAN Refresh: Refresh the list of libraries that are displayed. Abbreviation: R |
| Library type | Displays the library type of the promotion library. |
| Promotion level | Displays the promotion level number. |
| Line Command | Type S to the left of the DATASET column to select a library. |
| Dataset | Displays the library name. |
| Name | Displays the promotion level nickname. |
| Site | Displays the promotion site. |
Type S in the line command for a library and press Enter.
Choosing a Promotion or Baseline Library
On the Compare panel, if you specify a full Component name (not a pattern) and leave the Source library field blank, the component.type Library List panel (CMNCMLSL) is displayed.
...
CMNCMLSL ACPSRC6A.SRC Library List Row 1 to 4 of 4
Command ===> Scroll ===> CSR
Lvl Dataset/pathname + Prom.name Site
__ 0000 CMNTP.S6.V810.BASE.ACTP.SRC BASELINE
__ -001 CMNTP.S6.V810.BASE.ACTP.SRC.DELTA BASDELTA
__ -002 CMNTP.S6.V810.BASE.ACTP.SRC.DELTA BASDELTA
__ +010 CMNTP.S6.V810.PROM.S6P1UT.SRC S6P1UT SERT6
******************************* Bottom of data ********************************
This panel displays all of the application baseline and promotion libraries that contain the specified component.
This table describes the fields on the component.type Library List panel.
| Field | Description |
|---|---|
| Command | Type one of the following commands, or leave the command line blank and type a line command next to a library name. CANCEL: Cancel the function and return to the previous panel. Abbreviation: C or CAN REFRESH: Refresh the list of libraries that are displayed. Abbreviation: R |
| Line Command | Type S to the left of the LVL column to select a library. |
| Lvl | Displays the relative baseline level or the promotion level number for the library. |
| Dataset/pathname | Displays the library name or zFS path and file name. |
| Prom.name | Displays one of the following: - pppppppp: Promotion level nickname - BASELINE: Indicates a baseline library - BASEDELTA Indicates a stacked reverse delta baseline library |
| Site | Displays the promotion site. |
Type S in the line command for a library and press Enter.
Choosing a Package Component to Compare
On the Compare panel, if you leave the Command line blank or if you type a pattern in the Component name field, the Compare From libtype - stagelib panel (CMNCOMPL) is displayed.
This panel lists components in the package staging library for the library type you specified.
CMNCOMPL Compare from SRC Row 1 to 4 of 4
Command ===> _________________________________________Scroll ===> CSR
Staging library:
CMNTP.S6.ACTP.STG6.#000038
___ Name Function vv.mm Created Changed Size Init User
___ ACPSRCCE 03.04 2002/05/07 2015/01/21 22:45 30 23 USER016
___ ACPSRC1A 02.02 2014/12/18 2015/01/21 20:59 33 34 USER017
___ ACPSRC6A 03.02 2012/09/26 2015/02/01 19:45 44 27 USER017
___ ACPSRC92 03.01 2002/05/07 2015/01/15 00:06 30 15 USER017
******************************* Bottom of data *******************************
This table describes the fields on the Compare From libtype - stagelib panel.
| Field | Description |
|---|---|
| Command | Type one of the following commands, or leave the command line blank and type a line command next to a component name. BROWSE: Browse the specified component. Abbreviation: B component CANCEL: Cancel the function and return to the previous panel. Abbreviation: C or CAN HIST: Display component history for the specified component component. Abbreviation: H LOCATE Locate a component by information in the last sorted component column or by Name if the components were not sorted. Abbreviation: L REFRESH: Display updated information on this panel. Abbreviation: R SELECT: Select the specified component for compare. component Abbreviation: SE SORT: Sort the listed components by information under the heading specified column heading. Abbreviation: SO VIEW: View (browse in edit) the specified component. component Abbreviation: V Note: Component functions such as Browse, Hist, and View are executed against the staging library component, not the component in the promotion or baseline library. |
| Line Command | Type a line command to the left of the Name row. B: Browse the component. D: Deselect the component from compare. H Display component history. S Select the component for compare. V View (browse in edit) the component. Note: Component functions such as Browse, Hist, and View are executed against the staging library component, not the component in the promotion or baseline library. |
| Name | Displays the component name. |
| Function | Displays the function that was executed for each component:*BROWSE DESELECT*HISTORY *VIEW *COMPARE*ERROR |
| vv.mm Created Changed Size Init User |
These fields display the ISPF statistics in the staging library directory for each listed member. |
Type a line command for one or more components and press Enter. How the line commands are processed depends on whether you specified 1 Online or 2 Batch in the Compare mode field on the Compare panel.
Online Processing for Line Commands
If you specified 1 Online on the Compare panel, line commands on the Compare From libtype - stagelib panel are processed as follows:
-
Each line command on the Compare From libtype - stagelib panel is processed serially, top to bottom.
-
The result for each line command is displayed in an ISPF panel. See Online Compare Mode Results for an example of an online comparison report.
-
To exit a result panel and show the next result panel, press PF-3, or type END on the Command line and press Enter.
Batch Processing for Line Commands
If you specified 2 Batch on the Compare panel, line commands on the Compare From libtype - stagelib panel are processed as follows:
-
Each line command on the Compare From libtype - stagelib panel except S Select is processed serially, top to bottom.
-
The result for each non-S line command is displayed in an ISPF panel.
-
To exit a result panel and show the next result panel, press PF-3, or type END on the Command line and press Enter.
-
After all non-S line command are processed, you are returned to the Compare From libtype - stagelib panel. The FUNCTION column shows the function that was requested for each component.
-
When you press PF-3, or type END on the Command line and press Enter, all S Select line commands are processed, and JCL for a batch comparison job is generated and submitted. See Batch Compare Mode Results for an example of a batch comparison report.
Compare Component Results
The format of the compare component results depends on what you specified in the
COMPARE MODE field of the Compare panel (CMNCOMP1).
-
If you specified 1 Online, see Online Compare Mode Results.
-
If you specified 2 Batch, see Batch Compare Mode Results.
Online Compare Mode Results
On the Compare panel, if you specified 1 Online in the COMPARE MODE field, the comparison report is displayed in an ISPF panel:
...
-----------------------------------------------------------------------------------------------------------------
BROWSE CMNTP.A009E.#CE72391.#590E452.OUTLIST
Command ===>
************************************************************************ Top of Data *****************************
S E R C M P A R (MVS - 871 - 20140828) 2 TEXTONLY SUNDAY FEBRUARY 1, 2015 (2015/032) 20:21:09 PAGE 1
SYSUT1=CMNTP.S6.V810.BASE.ACTP.SRC(ACPSRC6A),SYSUT2=CMNTP.S6.ACTP.STG6.#000038.SRC(ACPSRC6A)
IDENTIFICATION DIVISION. O N E 1
PROGRAM-ID. ACPSRC6A. O N E 2
O N E 3
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
I *PACKAGE ACTP000038 S6.V810 DIF T W O 4 +
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
...
*PACKAGE ACTP000001 S6.V810 O N E 4
*PACKAGE ACTP000016 S4.V710T19 O N E 5
*PACKAGE ACTP000045 S4.V710T19 O N E 6
*PACKAGE ACTP000007 S4.V711 O N E 7
*PACKAGE ACTP000080 S4.V71201T3 O N E 8
*PACKAGE ACTP000081 S4.V71201T3 O N E 9
*PACKAGE ACTP000082 S4.V71201T4 O N E 10
O N E 11
ENVIRONMENT DIVISION. O N E 12
CONFIGURATION SECTION. O N E 13
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
D SOURCE-COMPUTER. IBM-370. DIF O N E 14 +
--------|---.----1----.----2----.----3----.----4----.----5----.----6----.----7----.----8---------------------
I SOURCE-COMPUTER. IBM-390. DIF T W O 15 +
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
OBJECT-COMPUTER. IBM-370. O N E 15
O N E 16
INPUT-OUTPUT SECTION. O N E 17
FILE-CONTROL. O N E 18
O N E 19
DATA DIVISION. O N E 20
WORKING-STORAGE SECTION. O N E 21
COPY ACPCPY00. O N E 22
COPY ACPCPY6A. O N E 23
LINKAGE SECTION. O N E 24
SER71I - END OF TEXT ON FILE SYSUT1
SER72I - END OF TEXT ON FILE SYSUT2
SER75I - RECORDS PROCESSED: SYSUT1(43)/SYSUT2(44),DIFFERENCES(1,0,1)
EXPLANATION - 1 RECORD DIFFER THAT SYNCHRONIZED TOGETHER
0 RECORDS WERE CONSIDERED INSERTED ON SYSUT1
1 RECORD WAS CONSIDERED INSERTED ON SYSUT2
S E R C M P A R (MVS - 871 - 20140828) 2 TEXTONLY SUNDAY FEBRUARY 1, 2015 (2015/032) 20:21:09 PAGE 2
SYSUT1=CMNTP.S6.V810.BASE.ACTP.SRC,SYSUT2=CMNTP.S6.ACTP.STG6.#000038.SRC
SER71I - END OF DIRECTORY ON FILE SYSUT1
SER72I - END OF DIRECTORY ON FILE SYSUT2
SER78I - MEMBERS PROCESSED: SYSUT1(26)/SYSUT2(4),DIFFERENCES(1),REJECTED BY FILTERS: SYSUT1(25)/SYSUT2(3)
SER80I - TIME OF DAY AT END OF JOB: 20:21:09 - CONDITION CODE ON EXIT: 4
*********************************************************************** Bottom of Data ***************************
Navigate the compare report with standard PF keys.
To exit the comparison report, press PF-3, or type END on the Command line and press Enter. If you specified Y in the Prompt for report disposition field on the Compare panel, the Specify Report Disposition panel (CMNCDISP) is displayed.
...
CMNCDISP ----------------- Specify report disposition -------------------------
Command ===>________________________________________________
Report dataset name: CMNTP.A0171.#C9E48A9.#8D00504.OUTLIST
Report disposition ===> 1 1 Print Dataset and delete
2 Print dataset and keep
3 Delete dataset without printing
4 Keep dataset without printing
Job statement information if printing:
===> //USER015A JOB (X170,374),'S4.V712',____________________________________
===> // CLASS=A,MSGCLASS=Y,NOTIFY=USER015____________________________
===> //*_____________________________________________________________________
===> //*______________________________
Follow the instructions on this panel to delete, print, and/or keep the comparison report. See Batch Compare Mode Results for an example of the printed comparison report.
If you selected multiple components for compare on the Compare From libtype - stagelib panel (CMNCOMPL), each comparison report is displayed in a separate panel in the order that the components were listed on the Compare From libtype - stagelib panel.
Batch Compare Mode Results
If you specified 2 Batch for Compare mode on the Compare panel, or if you specified a print Report disposition on the Specify Report Disposition panel, the comparison report is printed at the SYSPRINT DD statement in a batch job.
...
S E R C M P A R (MVS - 871 - 20140828) 2 TEXTONLY SUNDAY FEBRUARY 1, 2015 (2015/032) 20:28:02 PAGE 1
SYSUT1=CMNTP.S6.V810.BASE.ACTP.SRC(ACPSRC6A),SYSUT2=CMNTP.S6.ACTP.STG6.#000038.SRC(ACPSRC6A)
IDENTIFICATION DIVISION. O N E 1
PROGRAM-ID. ACPSRC6A. O N E 2
O N E 3
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
I *PACKAGE ACTP000038 S6.V810 DIF T W O 4 +
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
*PACKAGE ACTP000001 S6.V810 O N E 4
*PACKAGE ACTP000016 S4.V710T19 O N E 5
*PACKAGE ACTP000045 S4.V710T19 O N E 6
*PACKAGE ACTP000007 S4.V711 O N E 7
*PACKAGE ACTP000080 S4.V71201T3 O N E 8
*PACKAGE ACTP000081 S4.V71201T3 O N E 9
*PACKAGE ACTP000082 S4.V71201T4 O N E 10
O N E 11
ENVIRONMENT DIVISION. O N E 12
CONFIGURATION SECTION. O N E 13
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
D SOURCE-COMPUTER. IBM-370. DIF O N E 14 +
--------|---.----1----.----2----.----3----.----4----.----5----.----6----.----7----.----8---------------------
I SOURCE-COMPUTER. TRS-80. DIF T W O 15 +
++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+>++.++++8+++++++++++++++++++++
OBJECT-COMPUTER. IBM-370. O N E 15
O N E 16
INPUT-OUTPUT SECTION. O N E 17
FILE-CONTROL. O N E 18
O N E 19
DATA DIVISION. O N E 20
WORKING-STORAGE SECTION. O N E 21
COPY ACPCPY00. O N E 22
COPY ACPCPY6A. O N E 23
LINKAGE SECTION. O N E 24
SER71I - END OF TEXT ON FILE SYSUT1
SER72I - END OF TEXT ON FILE SYSUT2
SER75I - RECORDS PROCESSED: SYSUT1(43)/SYSUT2(44),DIFFERENCES(1,0,1)
EXPLANATION - 1 RECORD DIFFER THAT SYNCHRONIZED TOGETHER
0 RECORDS WERE CONSIDERED INSERTED ON SYSUT1
1 RECORD WAS CONSIDERED INSERTED ON SYSUT2
S E R C M P A R (MVS - 871 - 20140828) 2 TEXTONLY SUNDAY FEBRUARY 1, 2015 (2015/032) 20:28:02 PAGE 2
SYSUT1=CMNTP.S6.V810.BASE.ACTP.SRC,SYSUT2=CMNTP.S6.ACTP.STG6.#000038.SRC
SER71I - END OF DIRECTORY ON FILE SYSUT1
SER72I - END OF DIRECTORY ON FILE SYSUT2
SER78I - MEMBERS PROCESSED: SYSUT1(26)/SYSUT2(4),DIFFERENCES(1),REJECTED BY FILTERS: SYSUT1(25)/SYSUT2(3)
SER80I - TIME OF DAY AT END OF JOB: 20:28:02 - CONDITION CODE ON EXIT: 4
******************************** BOTTOM OF DATA
*******************************************************************************
If you selected multiple components for compare on the Compare From libtype - stagelib panel (CMNCOMPL), all comparison reports are in the SYSPRINT DD statement in component name order.