Skip to content

Using the M+R Option to Reapply Customization

Execute this procedure to set up the ChangeMan ZMF M+R Option to merge your modifications from the ZMF release from which you are migrating into version 8.3 components.

  1. Log in to ChangeMan ZMF. On the ChangeMan(R) Primary Option Menu (CMN@PRIM), select option C (M+R). The first time you select the M+R Option, the Reconcile (CDFPANEL) panel is displayed.
    View All -------------------------RECONCILE --------------------------------
    Command ===> _________________________________________________Scroll ===> CSR 
    B:WALKTR#1 C:WALKTR#2 665
    ******************************** TOP OF DATA *********************************
    000000 ********/* 2017/07/26 17:19:40 CMNTP.CMN814.C6.WALKTHRU 
    000001 WELCOME to Merge+Reconcile (M+R) from Serena Software, Inc. 
    000002 
    000003 The M+R walk-through consists of tutorial text and reconciliation 
    000004 actions that can be browsed and/or executed on the same panel so that 
    000005 you can immediately try any discussed primary or line command. 
    000006 
    000007 The Reconcile panel looks like the ISPF/PDF Edit panel and executes 
    000008 almost all ISPF/PDF commands. Both have a line command area (first 6 
    000009 characters on a line) and a data area which is scrollable. 
    000010 The 3rd line on both panels is reserved for the long text of a message 
    000011 in case you need it; meanwhile, M+R uses it to relate the nicknames 
    000012 of the derivative versions with their one-character IDs. 
    000013 The first record (with 000000 number) is created by M+R to register the 
    000014 date and time of the reconciliation, and the dataset name of the Base 
    000015 version. 
    000016 
    000017 The Reconcile panel displays the result of the comparison and merging 
    000018 of the versions, and marks the differences in the line command area: 
    000019 
    000020 -records COMMON in all the versions have their sequence numbers 
    000021 displayed in the command area; 
    000022 -records in the Base version that are MISSING in some derivatives are 
    000023 marked with the "less" symbol '<' and the IDs of those derivatives; 
    000024 -records in some derivatives that are ADDED (i.e. missing in the Base 
    000025 version) are marked with the "greater" symbol '>' and the IDs of 
    000026 those derivatives; 
    000027 -records in some derivatives that are REPLACING records of the Base 
    000028 version are marked with the "difference" symbol '<>' and the IDs of 
    000029 those derivatives; the corresponding Base records are marked with 
    000030 the "less" symbol '<' and keep their sequence number. 
    000031 
    000032 Each line on the Reconcile panel has a specific color depending on its 
    000033 origin. You can choose your own color scheme from the Profile panel. 
    000034 The default colors are: white for Base records; yellow for the first 
    000035 derivative records; pink for the second derivative records; etc.; 
    000036 red reversed for common records in two or more (up to 7) derivatives. 
    000037
    
  2. Read the Reconcile tutorial for an overview of the M+R Option. Press PF8 to page down and PF7 to page up.

  3. Further down on this same panel is an example (in color) of some of the results you might see.

    View All -----------------------------RECONCILE -----------------------------ROW 39 TO 77 OF 173 
    Command ===> ___________________________________________________________________Scroll ===> CSR 
    B:WALKTR#1 C:WALKTR#2
    000038 An example of the M+R graphics and coloring can be seen if you place 
    000039 the cursor on the next line and page down. Then page down again. 
    000040 // * 
    000041 // WSER37TN JOB (9602,848),'CMNBOW10',CLASS=E, 
    < 0042 //  TIME=(,15) 
    <>BC__ //  TIME=(,30) 
    000043 // STEPLIB DD DSN=WSER99.CMN416.LINKLIB,DISP=SHR 
    000044 // CMNBOW10 EXEC PGM=CMNBOW10,REGION=4M 
    000045 // CMNGBLFL DD DISP=(,CATLG,DELETE), 
    > B___ //  UNIT=SYSDA, 
    000046 //  SPACE=(CYL,(2,1)), 
    < _C__ //  VOL=SER=VOL333, 
    000048 //  DCB=(RECFM=VB,LRECL=5000,BLKSIZE=23476), 
    000049 //  DSN=&TSOID..&PKGMST..GLOBAL 
    000050 // CMNCMPFL DD DISP=(,CATLG,DELETE), 
    000051 //  UNIT=SYSDA, 
    < 0052 //  SPACE=(CYL,(15,5)), 
    <>B___ //  SPACE=(CYL,(20,10)), 
    <>_C__ //  SPACE=(CYL,(25,15)), 
    000053 //  DCB=(RECFM=VB,LRECL=5000,BLKSIZE=23476), 
    000054 //  DSN=&TSOID..&PKGMST..COMPONNT 
    000055 //  
    000056 // * 
    000057 Let's recap the differences between the 3 versions of the JCL jobdeck. 
    000058 The 42nd Base record is replaced in both derivatives with the same
    000059 text "TIME=(,30)". Accordingly, the Base record is marked with "< 0042" 
    000060 and the replacing line with "<>BC__" where "B" and "C" are the IDs of 
    000061 the derivatives. 
    000062 One record is added in the derivative "B" after the 45th Base record: 
    000063 it is marked with "> B___". 
    000064 The 47th Base record is missing in the derivative "C"; therefore, this 
    000065 record is marked with "< _C__" instead of with its sequence number. 
    000066 The 52nd Base record is replaced in both derivatives but with different 
    000067 text: "SPACE=(CYL,(20,10))," vs. "SPACE=(CYL,(25,15)),". 
    000068 
    000069 #0 You can browse each of the derivatives separately by issuing "View B" 
    000070 or "View C". You can try this right now, then issue "Locate 41" to 
    000071 view, then issue "View All" (or "v *"), and then "Find #1" to continue. 
    000072 Note that the replacing records are shown together with the replaced 
    
    4. Press PF3, or type End and press Enter, to exit from the Reconcile tutorial and select M and press Enter. The Member Reconciliation Menu (SER@MAIN) is displayed.

    SER@MAIN                        Member Reconciliation Menu 
    Option ===> ____________________________________________________________________
    0 Profile Update user profile settings 
    1 Versions Specify base and derivative data sets and member names 
    2 Execute Execute (compare and merge) the specified versions of a file 
    3 Save Save the current reconciliation as "work in suspense" (wis) 
    4 Load Load prior "work in suspense" for edit now 
    5 Edit Resume editing the current reconciliation or just loaded wis 
    5P Print Print the last view (snapshot) of the reconciliation 
    6 Export Export a successful reconciliation effort to a file 
    6P Exp print Print a successful reconciliation effort 
    7 Analysis Analyze the progress and complexity of the reconciliation 
    7P Anl print Print analysis of the reconciliation progress and complexity 
    X Exit 
    
    Do not merge and reconcile at the member level. Instead, merge and reconcile your modifications at the library level so you can work with all members in the custom library at the same time.

  4. Press PF3, or type End and press Enter, to exit from the Member Reconciliation Menu. The Merge+Reconcile main menu (SER@PRIM) is displayed.

    SER@PRIM                        Merge+Reconcile     
    Option ===> ___________________________________________________________________
    M Reconcile Up to 8 versions of a member or sequential data set 
    L Consolidate Up to 8 versions of a library -PDS, panvalet, librarian 
    S Synchronize Up to 8 versions of source and copy/include libraries 
    J Compare Up to 8 versions of a jcl lib after symbol substitution 
    C Changes From prior releases of merge+reconcile (m+r) 
    W Walk through The version reconciliation process with m+r 
    T Tutorial 
    X Exit 
    
    6. On the Merge+Reconcile main menu, choose option L -Consolidate up to 8 versions of a Library. The Library Consolidation Menu (SER@TEAM) is displayed.

    SER@TEAM                    Library Consolidation Menu 
    Option ===> ______________________________________________________________________
    0 Profile Update user profile settings 
    1 Versions Specify base and derivative library data set names 
    3 Workplace Display consolidation workplace listing version members 
    4 Batch job Batch execution (compare and merge) of version libraries 
    5 Project Create or select a consolidation project 
    X Exit
    
    7. On the Library Consolidation Menu, choose option 0 -Profile. The Profile panel (SERPROFL) is displayed.

    SERPROFL Profile Option ===> 
    0 Restore Back out all changes to the profile options and data sets
    1 Compare Specify version comparison options 
    2 Colors Specify coloring scheme for versions codelines 
    3 Editing Select merged versions editing options 
    4 Export Select export options for the consolidated version 
    5 Data Sets Specify Work In Suspense, print and export data set names 
    6 Filtering Auto-delete certain merged code lines upon business rules 
    T Tutorial Information about setting up M+R reconciliation profile 
    X Exit 
    
    8. On the Profile panel, choose option 5 -Data Sets. The Profile Data Sets panel (SERDSNML) is displayed.
    SERDSNML                        Profile Data Sets 
    Command ===> 
    WIS dsname . . . . . . . _________________________________________________________
    Print dsname . . . . . . _________________________________________________________
    Export dsname . . . . .  __________________________________________________________
    Export DSORG . . . . . . PDS___ (PDS, SEQ, PAN, LIB, or blank)
    Export member mask . . . _______(Mask to rename Base members on export)
    LIB module name . . . .  LIB____ (LIBrarian update module name: LIBR, LIBRARY)
    
    9. Type names for three new data sets that are used by the M+R Option when you merge and consolidate libraries. Use data set names that comply with your standards for permanent personal data sets.

    WIS dsname userid.MR.WIS
    Print dsname userid.MR.PRINT
    Export dsname userid.MR.EXPORT

    Note

    Press PF1 to obtain help at any time.

  5. Press PF3, or type End and press Enter to exit from the Profile Data Sets panel (SERDSNML). The M+R Option allocates the named data sets with the appropriate characteristics, and the Profile panel (SERPROFL) is displayed.

  6. Press PF3, or type End and press Enter, to exit from the Profile panel. The Library Consolidation Menu is displayed. Using the M+R Option to Reapply Customization
  7. On the Library Consolidation Menu (SER@TEAM), choose option 1 -Versions. The Versions (SERCDFCM) panel is displayed.

    SERCDFCM                      Versions 
    Command ===> ____________________________________________________________________
        CMN Export package: _____________Libtype:____ Export member:_________________ 
                                                     -Member---Type Nickname Id 
    Base: ___________________________________________ ________  ___  ________ __
                                         Last Member: ________
                 or CMN appl/pkg: ______ Libtype: ____ 
    Drv1: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____ 
    Drv2: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____  
    Drv3: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____  
    Drv4: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____  
    Drv5: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____ 
    Drv6: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____  
    Drv7: ___________________________________________ ________  ___  ________ __
                 or CMN appl/pkg: ______ Libtype: ____                   
    
  8. On the Versions panel, type the data set names of libraries you want to compare. Define your Base and Derivative versions in this order:

    Base Vendor library for old version
    Drv1 Custom library for old version
    Drv2 Vendor library for new version

    For the Base, Derivative 1, and Derivative 2 libraries, type an entry in the Type and Nickname fields. For the Derivative 1 and Derivative 2 libraries, type an entry in the ID fields. Do not type a Member name for any library.

    SERCDFCM -------------------------VERSIONS ------------------------------
    Command ===>
    
            CMN Export Package: __________ LibType: ___
                                                        -Member---Type Nickname Id
    Base: PROD99.CMNZMF.OLDREL.SKELS__________________ __________ PDS BASE____  _
                                            Last Member: ________ 
                or CMN Appl/Pkg: __________ LibType: ___    
    Drv1: PROD99.CMNZMF.CUSTOM.SKELS____________________ ________ PDS CUSTOM__ C
                or CMN Appl/Pkg: __________ LibType: ___
    Drv2: PROD99.CMNZMF.NEWREL.SKELS__________________ __________ PDS NEW_____ N
                or CMN Appl/Pkg: __________ LibType: ___ 
    Drv3: ____________________________________________ __________ ___ ________ _
                or CMN Appl/Pkg: __________ LibType: ___ 
    
    Press PF1 to display a help panel if you need assistance.

  9. Press PF3, or type End and press Enter, to exit from the Versions panel. The Library Consolidation Menu (SER@TEAM) is displayed.

  10. On the Library Consolidation Menu, choose option 3 -Workplace, and the Consolidation Workplace panel (CDFPANEL) is displayed.

    CDFPANEL -----------------Consolidation Workplace --------ROW 1 to 20 of 293 Command ===> Scroll ===> CSR Base: PROD99.CMNZMF.OLDREL.SKELS_ 
    Difference  Base  Member Action  Compl  Custom  New  Derv  #3  Derv #4  
    @$$.....  _  $$$INDEX  $$$INDEX  $$$INDEX  
    @$$.....  _  #VARLIST  #VARLIST  #VARLIST  
    @.$.....  _  CMN$$ACB  CMN$$ACB  
    @$$.....  _  CMN$$ASM  CMN$$ASM  CMN$$ASM  
    @.=.....  _  CMN$$AUD  CMN$$AUD  
    @.=.....  _  CMN$$BBL  CMN$$BBL  
    @.=.....  _  CMN$$BDT  CMN$$BDT  
    @$=.....  _  CMN$$BLA  CMN$$BLA  CMN$$BLA  
    @.$.....  _  CMN$$BLG  CMN$$BLG  
    @.......  _  CMN$$BND  
    @.=.....  _  CMN$$BSN  CMN$$BSN  
    @.$.....  _  CMN$$CAS  CMN$$CAS  
    @.=.....  _  CMN$$CA7  CMN$$CA7  
    @.$.....  _  CMN$$CBL  CMN$$CBL  
    @.=.....  _  CMN$$CIC  CMN$$CIC  
    @.$.....  _  CMN$$CKA  CMN$$CKA  
    @.$.....  _  CMN$$CKO  CMN$$CKO  
    @.....  _  CMN$$CLN  
    

  11. Type S next to a component Base Member name to see a merged version of the member. Use instructions in the following resources to merge your custom modifications into the version 8.3 members:

    • M+R Option Getting Started Guide

    • M+R Option Quick Reference

    • PF1 Help from the Consolidation Workplace

    Note

    Do not do anything to a component on the Consolidation Workplace panel (CDFPANEL) if no member from the custom library is displayed. Do not reconcile differences between two vendor components.

  12. Type E next to a component Base Member name to copy the merged member from your WIS file into the Export File you specified in Step9.

  13. Copy the members from your M+R Option Export file into your ChangeMan ZMF 8.3 custom library.