Relinking Load Components

In a package attached to a release, a relink that you initiate through the Relink Load Modules panel is driven by either:

A link-edit control member in a package staging library, baseline library, or release area library.
Calls to subprograms from a load module in a package staging library, a baseline library, or a release area library.

When you relink from area 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.

Follow these steps to access the package that you want to relink 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.
  
  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.
3. On the Release List panel, type line command PK on a release row to select the release that contains the package you want to relink into. Press Enter, and the release - Release Package List panel is displayed.
  
  ...
```
CMNRMPLF        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 describedin Accessing Release Packages and Components.

On the release - Release Package List panel, type RL in the line command of the package that you want to relink into, and press Enter. The Relink Load Modules panel is displayed.

CMNRLNKR                    Rebind Load Modules
Command ===>

Package: . . . . . . . . .  ACTP000038
Relink from . . . . . . .   S           (S(tage),B(aseline),R(elease))
Input library type . . . .  LOS         (Blank for list)
Target library type . . .               (Blank for list)
Member name . . . . . . .           +   (Blank/Pattern for list)

Enter "/" to select option
    Specify release area
    LCT member list

This table describes the information on the panel.

Field	Description
Package	Displays the package you want to relink a load module into.
Relink from	Type the location of the link-edit control member or the load module to be relinked. S Package staging library B Baseline library R Release area library
Input library type	The library type of the like-load module to be relinked from. The input library type may be like-object, like-NCAL or like-load.
Target library type	The library type of the like-load module to be relinked. The output library type must be like-load.
Member name	The name of the bind control member or the like-load member to be relbound Type a name pattern or blank to display a member selection list.
Specify release area	Use this field to determine whether relink 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. Omit to automatically search for latest.
LCT member list	Specify whether this rebind is driven by a bind control member or a load module. If selected, then the bind is driven by a bind control member. Omit to ensure bind is driven by a load module.

The next steps in the relink process depend on the location of the link control or load that is relinked into your package. The location of the link control or load depends on your settings for fields Relink From and Specify Release Area on the Relink Load Modules panel as indicated in this table.

Note

This table and the examples that follow assume a relink driven by a link control (LCT) member.

Relink From	Specify Rel. Area	Location of Source for Relink / Next Steps
S or B	Omitted or selected	ERO relinks from a staging or baseline library depending on the Relink From field setting. The next steps depend on what you specified in the Member Name field: Blank or pattern List - library panel (CMNRMLST). See Step 6 in Recompiling Source Components. Full name Standard relink process. See Step 7 in Recompiling Source Components.
R	Omitted	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 LIST - Consolidated Release Libraries panel pattern (CMNRMLST). See Step 4 in Recompiling Source Components. Full name Standard relink process. See Step 7 in Recompiling Source Components.
R	Selected	ERO displays a selection list of area libraries and baseline that might contain the component you want to relink. 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 (CMNRLRLS).
		Full name Release Library Selection List panel (CMNRLRLS).
		See Step 5 in Recompiling Source Components.

This is an example of the List - Consolidated Release Libraries panel (CMNRMLST). This panel lists the latest version of components matching the library type specified on the Relink Load Modules panel in prior releases and baseline.

...
```
 CMNRMLST            Library Member List         Row 1 to 3 of 3
 Command ===>                                    Scroll ===> CSR

     Input Library:

   Name      + Function  Created    Changed          Size     User
 _ ACPSRCD1              2008/01/18 2009/09/14 16:17 00000001 USER239
 _ ACPSRC30              2010/07/14 2010/11/28 10:20 00000006 USER239
 _ ACPSRC50              2002/05/11 2010/11/28 09:45 00000008 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 relink process is invoked. See Step 7 in Recompiling Source Components.

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

...

CMNRLRLS        Release Library Selection List          Row 1 to 10 of 10
Command ===>                                            Scroll ===> CSR

    Package: ACTP000038     Status: DEV     Install date: 20160411

Library type: LOS

    Dataset                                 Release     Area
    CMNTP.S4.STAG.ACTP.#000038.DEV.LCT
    CMNTP.FIN6430.ACCTPAY.ACTP.LCT          FIN6430     ACCTPAY
    CMNTP.FIN6430.FINANCE.ACTP.LCT          FIN6430     FINANCE
    CMNTP.FIN6410.ACCTPAY.ACTP.LCT          FIN6410     ACCTPAY
    CMNTP.FIN6410.GENLEDGR.ACTP.LCT         FIN6410     GENLEDGR
    CMNTP.FIN6410.FINANCE.ACTP.LCT          FIN6410     FINANCE
    CMNTP.FIN6420.ACCTPAY.ACTP.LCT          FIN6420     ACCTPAY
    CMNTP.FIN6420.GENLEDGR.ACTP.LCT         FIN6420     GENLEDGR
    CMNTP.FIN6420.FINANCE.ACTP.LCT          FIN6420     FINANCE
    CMNTP.S4.V710.BASE.ACTP.LCT             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 Relink Load Modules panel, but they may not contain the component you want or any components at all.

If you specified a full Component Name on the Relink Load Modules panel, and the specified component is in the library you selected on the Release Library Selection List panel, the next step is the standard relink process. See Step 7 in Recompiling Source Components.

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

This is an example of the List - library panel (CMNRMLST).

CMNRMLST            Library Member List             Row 1 to 2 of 2
Command ===>                                        Scroll ===> CSR

    Input library:
    CMNTP.FIN6410.ACCTPAY.ACTP.LCT

    Name        + Function  Created     Changed          Size     User
_ ACPSRC30                  2013/07/14  2015/11/28 09:45 00000006 USER239
_ ACPSRC50                  2002/05/11  2015/11/28 09:45 00000008 USER239
******************************* Bottom of data *******************************

This table describes the commands and line commands you can use on the List - 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
	CANCEL Cancel the function and return to the previous panel. Abbreviation: C
	LONG Display additional component information on a second line.
	SHORT Suppress the additional component information displayed with the Long command. Abbreviation: SH
Line Command	Type a line command to the left of the Name row:
	R Select the component for rebind processing.
	S Select the component for rebind processing.
	B Browse the component.
	H Display component history.
	V View the component. (Applies to bind control only.)

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

If you choose a component for relink that is in another active change package, the History - component warning panel is displayed.

CMNCMPSW            History - ACPSRC50.LOD          Row 1 to 4 of 4
Command ===>                                        Scroll ===> CSR

This component is included in the following packages:

Package    Sta Promoted vv.mm   Last action     Size Procname   User    Release
ACTP000043 DEV S4P1AT           2015/09/01 09:58     CMNCOB2    USER239
ACTP000040 DEV S4P1AT           2015/08/17 19:12     CMNCOB2    USER240
ACTP000037 DEV                  2016/03/28 09:48     CMNCOB2    USER239 FIN6420
ACTP000036 DEV                  2016/03/28 09:46     CMNCOB2    USER239 FIN6410
******************************** Bottom of data *******************************

This panel lists the other packages that contain the component that you want to relink. 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 relink for this component, type CANCEL in the Command line and press Enter. Otherwise, press Enter to relink the component.

The Rebind Job Information panel is displayed.

...

CMNRLNK1                Rebind Job Information
Command ===>

    Package: ACTP000038     Status: DEV     Install date: 20160418

Member name:     ACPSRC50                                       +
Dataset name:    CMNTP.FIN6410.ACCTPAY.ACTP.LCT                 +
LCT member list: YES Input library type: LOS    Target library type: LOD

Language . . . . . . . . COBOL2  (Blank for list)
Compile procedure . . .  CMNCOB2 (Blank for list)
Pgm binder parms . . . .

Enter "/" to select option
    Db2 processing          _ Other Db2 options
    Other options           _ User variables
    Suppress batch messages

Job statement information:
    //USER239O  JOB (X170,374),'REBIND',
    //          CLASS=A,MSGCLASS=Y
    //*
    //*

This table describes the fields on the Rebind Job Information panel.

Field	Description
Member name	Displays the name of the component to be relinked.
Dataset name	Displays the name of the library you are relinking from.
LCT member list	YES or NO - display a member to select from
Input Library type	Displays the component library type and library type description.

If there is a designated procedure for the component being relinked, and the Force Level in that procedure is 2, then the fields on the 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 relink 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, Pgm 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 processing	Indicates whether or not a Db2 pre-process or co-process is to be invoked during the compile.
Other Db2 options	Change or refer to values affecting the Db2 processing.
Other options	Select this field to display and change user options.
User variables	Enter `/` to specify user variables used to pass information to skeleton file tailoring.
Suppress batch messages	Select this field to suppress the component activation messages that are normally issued by the batch job when rebind is successful. If omitted then for rebind executed in batch mode, do not suppress component activation messages sent when rebind is successful.
Job statement information	Type valid job card information.

Type your entries on the Rebind 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.