Skip to content

Recompiling Source Components

When you attach a package to a release, you can recompile like-source components residing in area libraries in your release, in area libraries in prior releases, or in baseline libraries. You can also recompile from promotion libraries.

You can let ERO search for the latest version of the component in area libraries and baseline. See Searching Area Libraries for Latest for information on latest versions in ERO.

When a component is recompiled into a package attached to a release, the recompile SYSLIB DD statements include release area libraries that fit the rules that are specified in release administration.

Follow these steps to recompile like-source components into a package attached to a release. This example shows an online recompile process.

  1. Follow these steps to access the package that you want to recompile into.

    1. Type =7 on the Command or Option line of any panel in ChangeMan ZMF, then press Enter.

    2. Type release selection criteria in fields on the Release List Specifications Parameters panel, or leave the fields blank, and press Enter.

    3. The Release List panel is displayed.

      CMNRMRLF            Release List            Row 1 to 2 of 2
      Command ===>                                Scroll ===> CSR
          Release Sta Install  Work request   Dept Aud    Creator Pkgs
          FIN6410 DEV 20160328 WR 9010        FINANCE     USER015 00001
          FIN6430 DEV 20160328 WR 9030        FINANCE     USER015 00003
      ******************************* Bottom of data *******************************
      

      The Release List panel shows releases that:

      • Satisfy the selection criteria you typed on the Release List Parameters panel.

      • Have change packages attached to them.

    4. On the Release List panel, type line command PK on a release row to select the release that contains the package you want to recompile into. Press Enter, and the release - Release Package List panel is displayed.

      ...

       CMNMPLF         FIN6430 - Release Package List      Row 1 to 1 of 1
       Command ===>                                    Scroll ===> CSR
      
           Package    Sta Area    Install DT/TM Last Promotion     Aud Chkd In
           ACTP000032 DEV ACCTPAY 20160429 2359 SERT6 S6P1IT   00          N
           ACTP000038 DEV ACCTPAY 20160429 2359 SERT6 S6P1IT   00          N
       ******************************* Bottom of data *******************************
      

      The release - Release Package List panel shows all packages that are attached to the release that you selected.

      The fields on the release - Release Package List panel are described in Accessing Release Packages and Components.

  2. On the release - Release Package List panel, type RC in the line command of the package that you want to recompile into, and press Enter. The Recompile Source panel is displayed.

    CMNRCMPR                    Recompile Source
    Option ===>
    
       blank Member selection list      L List libraries containing component
    
    Package . . . . . . . . . ACTP000038
    Component name . . . . .  ACPSRC99                                  +
    Source library type . . . SRC       (Blank for list)
    Library level . . . . . . 1         (Baseline 0, Promotion 1 to nn)
    Recompile mode . . . . .  2         (1-Online, 2-Batch)
    
    Enter "/" to select option
        / Search release areas
        / Specify release areas
    

    This table describes the fields on the Recompile Source panel.

    Field Description
    Option Type L to display the component - type Library List panel that shows baseline, promotion, and area libraries that contain the component specified in the Component Name and Library Type fields. You cannot use a pattern in the Component Name field if you use this option.
    Package Displays the package ID of the change package you are recompiling into.
    Component name Type the name of the component you want to recompile. Other options:

    Pattern   Build and display a filtered list of components from the origin library. You can select components to recompile from the list. Note: Do not type * by itself unless you want to recompile all components in the library.

    Blank   Display a list of all components in the origin library. You can select components to recompile from the list.

    *   Recompile all components in the library.
    Source library type Type the library type of the components you want to recompile. Leave this field blank to display a list of library types to select from.
    Library level Type an integer to indicate the baseline version or promotion level where you want to get the source to recompile. Note: If you type Y in Search Release Areas below, the contents of this field is ignored.

    0    Recompile from the current or 0 level baseline library.

    1 to 99   Integers from 1 to 99 mean recompile a future version in a promotion library. The integers are level numbers in a promotion site/level. If there are multiple promotion sites with the level number you specify, the Promotion Library Selection List panel is displayed, where you select one of the listed promotion libraries.

    Blank   You can leave this field blank if you type L in the Option field.
    If you type L in the Option field, the component - type Library List panel is displayed that shows you the baseline and promotion libraries that contain the component specified in the Component Name and Source Library Type fields. You can select a library on this list to check out from regardless of the version or level that you specified in the Library Level field.
    Recompile mode Type 1 or 2 to determine whether recompile is performed online with your terminal locked or in a batch job.
    1   Recompile components online.
    2   Recompile components in batch mode.
    Search release areas Used to determine whether release area libraries are included in the search for the component you want to recompile.
    Select to recompile from area libraries or baseline.
    Omit to recompile from area promotion libraries or baseline.
    Specify release area Used to determine whether recompile will display a library selection list.
    Select to display a selection list of area libraries and baseline that might contain the component(s) you want to recompile.
    Automatically search for latest.

    Type your entries on the Recompile Source panel, selecting option 1-Online for Recompile Mode, and press Enter.

  3. The next steps in the recompile process depend on the location of the source that is recompiled into your package. The location of the source depends on your settings for fields Search Release Areas and Specify Release Area on the Recompile Source panel as indicated in this table.

    Search Rel. Areas Specify Rel. Area Location of Source for Recompile / Next Steps
    Not selected Selected or not ERO recompiles source from a promotion or baseline library depending on the Library Level field setting. The next steps depend on what you specified in the Component Name field:
    Blank or pattern   Recompile From - library panel (CMNRCMP2). See Step 6 in Recompiling Source Components.

    Full name   Standard recompile process. See Step 7 in Recompiling Source Components.
    Selected Not selected ERO automatically finds the latest version of the component in area libraries and baseline.
    The next steps depend on what you specified in the Component Name field:
    Blank or pattern   Recompile From - Consolidated Release Libraries panel (CMNRCMP2). See Step 4 in Recompiling Source Components.
    Full name Standard recompile process. See Step 7 in Recompiling Source Components.
    Selected Selected ERO displays a selection list of area libraries and baseline that might contain the component you want to recompile. You select the release area library or baseline. The next steps depend on what you specified in the Component Name field:
    Blank or pattern   Release Library Selection List panel (CMNLBLS3). See Step 5 in Recompiling Source Components.
    Full name   Release Library Selection List panel (CMNLBLS3). See Step 5 in Recompiling Source Components.
  4. This is an example of the Recompile From - Consolidated Release Libraries panel (CMNRCMP2). This panel lists the latest version of components matching the library type specified on the Recompile Source panel in prior releases and baseline.

    ...

    CMNRCMP2            Recompile Member List           Row 1 to 14 of 14
    Command ===>                                        Scroll ===> CSR
                                                                   ID
        Input library:
        CMNTP.S4.V710.BASE.ACTP.SRC
    
      Name     Function vv.mm Created    Changed           Size Init User
    _ ACPSRCD1          02.01 2002/05/07 2010/07/15 17:54   51    15 USER239
    _ ACPSRC1A          03.01 2002/05/07 2010/11/27 16:21   30    23 USER239
    _ ACPSRC2A          02.01 2010/07/14 2010/08/04 16:31   25    24 USER240
    _ ACPSRC80          01.03 2002/05/07 2010/08/05 13:45   22     1 USER240
    _ ACPSRC90          02.01 2002/05/07 2010/08/05 14:21   23     1 USER240
    _ ACPSRC91          02.01 2002/05/07 2010/08/05 14:21   23    15 USER240
    _ ACPSRC92          02.01 2002/05/07 2010/08/05 14:22   23    15 USER240
    _ ACPSRC93          01.01 2002/05/07 2010/07/15 11:56   22    15 USER239
    _ ACPSRC94          01.01 2002/05/07 2010/07/15 11:56   22     1 USER239
    _ ACPSRC95          01.01 2002/05/07 2010/07/15 11:56   22    15 USER239
    _ ACPSRC96          01.01 2002/05/07 2010/07/15 11:56   22    15 USER239
    _ ACPSRC97          01.01 2002/05/07 2010/07/15 11:56   22    15 USER239
    _ ACPSRC98          01.01 2002/05/07 2010/07/15 11:56   22    15 USER239
    _ ACPSRC99          02.01 2002/05/07 2010/11/28 09:36   24     1 USER239
    ******************************* Bottom of data *******************************
    

    Select one or more components on the Recompile From - Consolidated Release Libraries panel for recompile into your release package.

    Note

    The name of the release area library or baseline library containing the latest component version listed on the Recompile From - Consolidated Release Libraries panel is not displayed until you get to the Online Recompile Job Information panel (CMNRCMP1).

    When you make your member selection on this panel and press Enter, the standard recompile process is invoked. See Step 7 in Recompiling Source Components.

  5. This is an example of the Release Library Selection List panel (CMNLBLS3).

    ...

    CMNLBLS3        Release Library Selection List      Row 1 to 7 of 7
    Command ===>                                        Scroll ===> CSR
    
        Package: ACTP000038 Status: DEV Install date: 20160418
    
    Library type: SRC
    
      Dataset                           +   Release     Area
    _ CMNTP.FIN6410.ACCTPAY.ACTP.SRC        FIN6410     ACCTPAY
    _ CMNTP.FIN6410.GENLEDGR.ACTP.SRC       FIN6410     GENLEDGR
    _ CMNTP.FIN6410.FINANCE.ACTP.SRC        FIN6410     FINANCE
    _ CMNTP.FIN6420.ACCTPAY.ACTP.SRC        FIN6420     ACCTPAY
    _ CMNTP.FIN6420.GENLEDGR.ACTP.SRC       FIN6420     GENLEDGR
    _ CMNTP.FIN6420.FINANCE.ACTP.SRC        FIN6420     FINANCE
    _ CMNTP.S4.V710.BASE.ACTP.SRC           BASELINE
    ******************************* Bottom of data *******************************
    

    This table describes the fields on the Release Library Selection List panel.

    Field Description
    Command Type a command, or leave Command blank to type a Line Command on an dataset.
    CANCEL   Cancel panel without action. (Abbreviation: C)
    REFRESH   Refresh the panel display from data stores. (Abbreviation: R)
    Package Displays the change package ID.
    Status Displays the package status.
    Install date Displays the package install From date.
    Line Command S (Select) is the only valid line command code.
    Dataset Displays area library names for the specified library type.
    Note: Area libraries from prior releases are listed.
    Release Displays the release ID for the area library, or displays BASELINE for the baseline library.
    Area Displays the release area name for the area library, or displays blank for the baseline library.

    Note

    Libraries listed on the the Release Library Selection List panel match the library type you specified on the Recompile Source panel, but they may not contain the component you want or any components at all.

    If you specified a full Component Name on the Recompile Source panel, and the specified component is in the library you selected on the Release Library Selection List panel, the next step is the standard recompile process. See in Recompiling Source Components.

    If you did not specify a full Component Name on the Recompile Source panel, the next panel that is displayed is the Recompile From: library panel (CMNRCMP2), which is described in the next step.

  6. This is an example of the Recompile From: library panel (CMNRCMP2).

    CMNRCMP2            Recompile Member List           Row 1 to 14 of 14
    Command ===>                                        Scroll ===> CSR
                                                                  ID
        Input library:
        CMNTP.S4.V710.BASE.ACTP.SRC
    
      Name Function vv.mm Created    Changed              Size Init User
    _ ACPSRCD1      02.01 2002/05/07 2010/07/15 17:54       51   15 USER239
    _ ACPSRC1A      03.01 2002/05/07 2010/11/27 16:21       30   23 USER239
    _ ACPSRC2A      02.01 2010/07/14 2010/08/04 16:31       25   24 USER240
    _ ACPSRC80      01.03 2002/05/07 2010/08/05 13:45       22    1 USER240
    _ ACPSRC90      02.01 2002/05/07 2010/08/05 14:21       23    1 USER240
    _ ACPSRC91      02.01 2002/05/07 2010/08/05 14:21       23   15 USER240
    _ ACPSRC92      02.01 2002/05/07 2010/08/05 14:22       23   15 USER240
    _ ACPSRC93      01.01 2002/05/07 2010/07/15 11:56       22   15 USER239
    _ ACPSRC94      01.01 2002/05/07 2010/07/15 11:56       22    1 USER239
    _ ACPSRC95      01.01 2002/05/07 2010/07/15 11:56       22   15 USER239
    _ ACPSRC96      01.01 2002/05/07 2010/07/15 11:56       22   15 USER239
    _ ACPSRC97      01.01 2002/05/07 2010/07/15 11:56       22   15 USER239
    _ ACPSRC98      01.01 2002/05/07 2010/07/15 11:56       22   15 USER239
    _ ACPSRC99      02.01 2002/05/07 2010/11/28 09:36       24    1 USER239
    ******************************* Bottom of data *******************************
    

    This table describes the commands and line commands you can use on the Recompile From: library 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.
    REFRESH   Display updated information on this panel. Abbreviation: R
    SORT heading   Sort listed components by information under the specified column heading. Abbreviation: SO
    LOCATE member   Locate a component by information in the last sorted column or by Name if the components were not sorted. Abbreviation: L
    LONG   Display additional component information on a second line.
    SHORT   Suppress the additional component information displayed with the LONG command.
    CANCEL   Cancel the function and return to the previous panel. Abbreviation: C
    BROWSE member   Browse the specified component in the selected library. Abbreviation: B
    SELECT member   Select the specified component for recompile. Abbreviation: S
    HISTORY member   Display component history for the specified component. Abbreviation: H
    Line Command Type a line command to the left of the Name row:
    S   Select the component for recompile processing.
    B   Browse the component in the baseline library.
    H   Display component history.

    When you make your member selection on this panel and press Enter, the standard recompile process is invoked, which continues in the next step.

  7. If you choose a component for recompile that is in another active change package, Component Warning panel is displayed.

    CMNCMPSW            History - ACPSRC99.SRC          Row 1 to 2 of 2
    Command ===>                                        Scroll ===> CSR
    
    This component is included in the following packages:
    
    Package    Sta Promoted vv.mm Last action      Size  Procname User    Release
    ACTP000037 DEV          02.01 2010/11/28 08:28 00024 CMNCOB2  USER239 FIN6420
    ACTP000036 DEV          02.01 2010/11/28 09:37 00024 CMNCOB2  USER239 FIN6410
    ******************************* Bottom of data *******************************
    

    This panel lists the other packages that contain the component that you want to recompile. Make sure that you are coordinating your work with the other developers who have checked out or staged the component into their packages.

    If you want to abandon the recompile for this component, type CANCEL in theCommand line and press Enter. Otherwise, press Enter to recompile the component.

  8. If you continue the recompile process, the Confirm Recompile Request panel is displayed.

    CMNRCMPC            Confirm RECOMPILE Request
    Command ===>
    
    Package: ACTP000038
    Component name:     ACPSRC99 +
              type:     SRC
    Language:           COBOL2
    Changed Date:       20160328
            Time:       10250
    Procedure:          CMNCOB2
    User:               USER239
    RELEASE             FIN6410
    Area:               ACCTPAY
    

    If you want to abandon the recompile for this component, type CANCEL in the Command line and press Enter. Otherwise, press Enter to recompile the component.

  9. If you continue the recompile process, the Online Recompile Job Information panel is displayed.

    CMNRCMP1        ONLINE Recompile Job Information        HISTORY ASSUMED
    Command ===>
    
        Package: ACTP000038     Status: DEV     Install date: 20160418
    
    Component:      ACPSRC99                                            +
    Library type:   SRC - Source for Programs to be Linked Executable
    Dataset name:   CMNTP.FIN6410.ACCTPAY.ACTP.SRC                      +
    
    Language . . . . . . . COBOL2  (Blank for list)
    Compile procedure . .  CMNCOB2 (Blank for list; ? for designated procedure)
    Compile parms . . . .
    Pgm binder parms . . .
    
    Enter "/" to select option
        Db2 precompile
        Precompile variables
        Display Other Options
        Suppress batch messages
    
    Job statement information:
        //USER239K JOB (X170,374),'SRECOMP',
        //         CLASS=A,MSGCLASS=Y
        //*
        //*
    

    This table describes the fields on the Online Recompile Job Information panel.

    Field Description
    Component Displays the name of the component being recompiled.
    Library type Displays the component library type and library type description.
    Dataset name Displays the name of the library you are recompiling from.

    If there is a designated procedure for the component being recompiled, and the Force Level in that procedure is 2, then the fields on the Online Recompile Job Information panel are presented in display mode. If the Force Level of the designated procedure is 1, you can restore the fields on this panel to the values required for freeze by typing ? in the Compile Procedure field.

    Field Description
    Language Type the source language. If you leave the Language field blank, the Language Selection List is displayed when you press Enter. If the Language field contains information when the panel is first displayed, the short ISPF message in the upper right corner of the panel tells you where the language was obtained:
    HISTORY ASSUMED   Obtained from component history.
    DESIGNATED ENFORCED   Obtained from a designated procedure.
    PRIOR ASSUMED   Obtained from a prior use of this panel for another component during your current ChangeMan ZMF session.
    Compile procedure Type the compile procedure to be used to recompile the component. Compile procedures are members in the ChangeMan ZMF skeleton library that are processed by ISPF file tailoring to create stage JCL. If you leave the Compile Procedure blank, but there is only one compile procedure defined for the specified language, the Compile Procedure field is filled automatically when you press Enter. If you leave the Compile Procedure field blank, and if there are multiple compile procedures defined in administration for the specified language, the Compile Procedure Selection List panel is displayed when you press Enter.
    Type ? to restore Language, Compile Procedure, Compile Parms, Binder Parms, Db2 Precompile, and User Options from a designated procedure with Force Level 1.
    Compile parms Type compile options that are not already in effect through: System defaults.
    Compile Procedure skeletons.
    User Options. See Other Options below.
    Pgm binder parms Type binder options that are not already in effect through:
    System defaults for the compiler. Compile Procedure skeletons.
    User Options. See Other Options below.
    Db2 precompile Select to include a Db2 precompile step in the stage job.
    Omit to not include a Db2 precompile step in the stage job.
    Precompile variables Select to display the Db2 Physical Subsystems panel to set additional options for Db2 components. Field Db2 Precompile must be Yes.
    Omit to not display the Db2 Physical Subsystems panel.
    Display other options Select to display the Stage: User Options panel before submitting the stage job.
    Omit to not display the Stage: User Options panel before submitting the stage job. Obtain User Options from component history or from a designated procedure with Force Level 2.
    Suppress batch messages Select this field so that for a recompile executed in batch mode, suppress component activation messages sent when recompile is successful.
    N   Omit this field so that for a recompile executed in batch mode, do not suppress component activation messages sent when recompile is successful.
    Job statement information Type valid job card information.

    Type your entries on the Online Recompile Job Information panel and press Enter. If you set the Other Options field to Y, the Stage: User Options panel is displayed. Type your entries on this panel and press Enter. A recompile job is submitted.

  10. After recompile completes successfully, the new load module and compressed listing reside in the staging libraries of your package. You must check in the package into its starting release area to copy the recompile components from the package staging libraries into release area libraries.