Promoting Packages And Components

This section describes how to promote packages and components.

Selecting A Promotion Site And Options

Follow these steps to select a promotion site and choose promotion options.

Bring up the Promote/Demote A Change Package menu.

CMNRPM00                               Promote/Demote a Change Package
Option ===>___________________________________________________________

       P Promote                                             D Demote
   Package . . . ACTP000038

On the Promote/Demote a Change Package menu, type a Package ID, type P in the Option field, and press Enter. The Promote Site List panel is displayed.

CMNRPM01                        PROMOTE Site List                      Row 1 to 3 of 3
Command ===>______________________________________________________    Scroll ===> CSR

          Package: DEMO000182        Status: DEV         Install date: 20230120

            Demote reqd  ------------- Last promotion details    --------------
  Site      prior sites  Type          Promotion Lvl Date        Time  User
__D001           N       Full Promote  1  D001LV1    2018/01/11  08:20 WSER27
__LOCAL          Y                     0
******************************* Bottom of data ********************************

Note

You can access the Promote Site List panel from the Change Package List by typing option PR beside a package. The Promote Site List is suppressed if there is only one site defined for an application. This table describes the fields on the Promote Site List panel.

Field	Description
*package user variables	Package user variables USR0101-USR0810 and USR1601- USR7205 now appear at the top of the Promote/Demote Site List (CMNRPM01) panel. (Not shown in the example above.)
Package	Displays the Package ID of the current change package
Status	Displays the current status of the change package.
Install date	Displays the date when this package is proposed for installation. (yyyymmdd).
Site	Displays the promotion site names defined for the application.
Demote reqd prior sites	Indicates the restriction on promoting to more than one site at the same time. Y: A package cannot be promoted in this site until it is fully demoted in all other sites. N: A package can be promoted in this site at the same time it is promoted in other sites if the Demote reqd prior sites is N for those sites also.
Last promotion details	Displays the last successful promote or demote action for this package in each site.
Type	Displays the type of action taken. Full Promote: The package was fully promoted. Part Promote: Package components were selectively promoted. 1st Promote: Package components were selectively promoted while the package was at Level 0 (not promoted). Full Demote: The package was fully demoted. Part Demote: Package components were selectively demoted.
Promotion lvl	Displays the numeric promotion level and the name of the last promotion or demotion target.
Date	Displays the date of the last action. (yyyymmdd)
Time	Displays the time that the last action was completed. (hh:mm)
User	Displays the UserID of the person who initiated the last action.

On the Promote Site List panel, type an S next to the Site where you want to promote the package or components, and press Enter. The Promote Options panel is displayed.

CMNRPM03                               Promote Options
Option ===>___________________________________________________________________

       F  Full promotion           S   Selective promotion
       H  Display history          O   Check for overlay

          Package: ACTP000001       Status: DEV       Install date: 20171119

Promotion site:               SERT6
Current promotion level:      S6P1UT + 10

Next promotion level . . 20
Schedule: date . . . . . ______     time . . . . . _____

Enter "/" to select option
  _ Short selection list     _ Bypass overlay check
  / User variables           _ Suppress batch messages

Job statement information:
    //USER015B JOB (SM-1IKF-SM),'COMPARE',
    //        CLASS=A,MSGCLASS=X,NOTIFY=USER015
    //*
    //* JOB TO PROMOTE

This table describes the fields on the Promote Options panel:

Field	Description
Option	Type a one-character code for the promotion action you want to perform: F: Fully promote the change package. S: Selectively promote components in the change package. H: Display all promote or demote actions that were initiated for this package O: Check a target promotion level for potential component overlays.
Schedule	date - The date (yyyymmdd) to promote the package or component.
	time - The time (hh:mm) to promote the package or component.
Short selection list	If not selected, then display all package components on the selective promotion selection list. If selected, then limit the selection list for selective promotion to package components that are not currently promoted to the target level, including components that may have been re- staged, newly activated into the package, or overlaid by promotion of another package.
Bypass overlay check	Type your choice for bypassing the check of the target promotion libraries for potential component overlays before promotion is executed. Select this option to bypass the check for potential component overlays in target promotion libraries.
	NOTE** Components in promotion libraries that have the same name as components in your package are replaced.
	If not selected, then check target promotion libraries for potential component overlays. If potential overlays are detected, display a panel listing the common components, and allow the user the opportunity to discontinue the promotion action.
User Variables	Enter '/' to specify user variables V01 through V10 on panel CMNUSV1 to pass information to skeleton file tailoring.
Suppress batch messages	Type your choice for broadcasting a SEND message at the completion of the promotion job to tell you whether the promotion function was a success. If not selected then broadcast a SEND message at the completion of the promotion job. Select this option to suppress the SEND message normally broadcast at the completion of the promotion job.
Job statement information	Job card information for promotion jobs that will run on the same MVS image as the user.

On the Promote Options panel, type the appropriate entries and press Enter.
- To fully promote your package, type F in the Option field. See Full Promote.
  - To selectively promote components in your package, type S in the Option field. See Selective Promote.
- To display the promotion and demotion history of the package for this site, type H in the Option field. See Displaying Promotion/Demotion History For A Site.
- To check a target promotion level for potential component overlays, type O in the Option field. See Check for Potential Overlays.

Full Promote

This section assumes that you executed the steps in Selecting A Promotion Site and Options and that you selected Option F on the Promote Options panel.

If you typed YES in the Bypass Overlay Check field on the Promotion Options panel, ChangeMan ZMF immediately builds full promote job JCL and submits the first job.

If the batch promotion process is successful, you will receive an MVS send message telling you that your package was promoted and indicating the site, nickname and promotion level to which it was promoted and the date and time that the process was completed.
If you typed NO in the Bypass Overlay Check field on the Promotion Options panel, ChangeMan ZMF examines the target promotion libraries and promotion history to detect potential overlays.
1. If no potential overlays are detected, ChangeMan ZMF builds full promote job JCL and submits the first job.
  
  If the batch promotion process is successful, MVS sends a message telling you that your package was promoted and indicating the site, nickname and promotion level to which it was promoted and the date and time that the process was completed.
2. If potential overlays are detected, the Common Components panel is displayed to show components that may be common between your change package and the target promotion libraries.
```
CMNRPM06                 Common Components: Lvl 20 (S6P1IT)                  OVERLAY WARNING
Command ===>                                                                Scroll ===> CSR

         Package: ACTP000038            Status: DEV                Install date: 20150218

Name + Type   Package      Sta    Promotion    Date        Time    User      Status
ACPSRCEE LOD  ACTP000032   DEV   20 S6P1IT    2015/02/01   22:06   USER015   Common
ACPSRCEE SRC  ACTP000032   DEV   20 S6P1IT    2015/02/01   22:06   USER015   Common
******************************* Bottom of data ********************************
```
  See the full description of the Common Components panel for a description of each field on this panel.
3. Carefully examine the component and package information displayed on the Common Components panel. Contact the people who promoted packages that are listed on this panel to discuss the impact of overlaying their components in test libraries. They may be able to demote their package so you can promote your package without overlays.
4. If you want to stop your promotion process, press PF3 or type End on the Command line and press Enter. No test libraries change.
5. If you choose to ignore the overlay warning, press Enter to continue your promotion. ChangeMan ZMF builds full promote job JCL and submits the first job.
  
  If the batch promotion process is successful, MVS sends a message telling you that your package was promoted and indicating the site, nickname and promotion level to which it was promoted and the date and time that the process was completed.

Caution

If you ignore the overlay warning and promote your package, you may copy components from your package over existing components in test libraries. This may invalidate test results for other projects.

Selective Promote

This section assumes you executed the steps in Selecting A Promotion Site And Options and that you selected Option S on the Promote Options panel.

When you select Option S on the Promotion Option panel and press Enter, the Promote To panel is displayed.

CMNRPM05            PROMOTE TO: SERT6 Lvl 20 (S6P1IT)              Row 1 to 10 of 10
Command ===> ______________________________________________________  Scroll ===> CSR

         Package: ACTP000038       Status: DEV       Install date: 20150218
  Name   +   Type Status         Promotion     Date       Time    User     REQUEST
_ ACPSRCCE   LOD                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRCCE   SRC                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRCEE   LOD                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRCEE   SRC                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRC1A   LOD                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRC1A   SRC                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRC6A   LOD                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRC6A   SRC                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRC92   LOD                10  S6P1UT    2015/02/01  22:16   USER015
_ ACPSRC92   SRC                10  S6P1UT    2015/02/01  22:16   USER015
******************************* Bottom of data ********************************

This table describes the fields on the Promote To:

Field	Description
Package	Displays the Package ID of the current change package.
Status	Displays the current status of the change package.
Install date	Displays the date when this package is proposed for installation. (yyyymmdd).
Name	Displays the names of the package components that are ACTIVE and in a library type set up for promotion for the target promotion level.
Type	Displays the library type of the listed component.
Status	Displays the status of the promoted component. Blank: Component has never been promoted in this package or has not changed since it was last promoted. Restaged: Component was staged again in this package since it was last promoted in this package. These components are treated as if they are at promotion level 0. Overlaid: Component has been overlaid in the promotion library by another package since the last promotion in this package. These components are treated as if they are at promotion level 0. Deleted: Component was promoted in this package but deleted from the package. These components will only show on the demotion list and are only eligible for demotion.
Promotion	Displays the level number and nickname of the last promotion level to which the component was promoted in this package.
Date	Displays the date when the component was last promoted in this package. (yyyymmdd).
Time	Displays the time when the component was last promoted in this package. (hh:mm).
User	Displays the TSO ID of the person who last promoted the component in this package.
REQUEST	Displays the action requested for each listed component. Type S beside a component and press Enter to change the Request field to `SELECT`. Type D beside a selected component to change the Request back to blank.

Type S beside each component that you want to selectively promote.
1. Press Enter to change the Request field to *SELECT*.
2. Type D beside any selected component to deselect it and exclude it from selective promotion.
3. Press PF3 or type End on the Command line and press Enter to execute the selective promote.
If you typed Yes in the Bypass Overlay Check field on the Promotion Options panel, ChangeMan ZMF immediately builds selective promote job JCL and submits the first job.

If the batch promotion process is successful, MVS sends a message telling you that your package was promoted and indicating the site, nickname and promotion level to which it was promoted and the date and time that the process was completed.
If you typed No in the Bypass Overlay Check field on the Promotion Options panel, ChangeMan ZMF examines the target promotion library and history to detect potential overlays.
1. If no potential overlays are detected, ChangeMan ZMF builds selective promote job JCL and submits the first job.
  
  If the batch promotion process is successful, MVS sends a message telling you that your package was promoted and indicating the site, nickname and promotion level to which it was promoted and the date and time that the process was completed.
2. If potential overlays are detected, the Common Components panel is displayed to show components that may be common between your change package and the target promotion libraries. See the full description of the Common Components panel for a description of each field on this panel.
3. Carefully examine the component and package information displayed on the Common Components panel. Contact the people who promoted packages that are listed on this panel to assess the impact of overlaying their components in test libraries. They may be able to demote their package so you can promote your package without overlays.
4. If you want to stop your promotion process, press PF3 or type End on the Command line and press Enter.
5. If you choose to ignore the overlay warning, press Enter to continue your promotion process.
  
  ChangeMan ZMF builds selective promote job JCL and submits the first job. If the batch promotion process is successful, MVS sends a message telling you that your package was promoted and indicating the site, nickname and promotion level to which it was promoted and the date and time that the process was completed.

Caution

If you ignore the overlay warning and promote your package, you may copy components from your package over existing components in test libraries. This can invalidate test results for other projects.

Check for Potential Overlays

This section assumes you executed the steps above and that you selected Option O on the Promote Options panel.

Use this promotion option before you promote your package to see if there are other projects that already promoted the components you are changing. If you overlay a component that was promoted from another change package, you might invalidate testing that is being conducted by the person who promoted the component previously.

When you select Option O on the Promotion Option panel and press Enter, the Common Components panel is displayed to show components that may be common between your change package and the target promotion libraries.

CMNRPM06                Common Components: Lvl 20 (S6P1IT)             OVERLAY WARNING
Command ===>                                                          Scroll ===> CSR

      Package: ACTP000038        Status: DEV        Install date: 20150218
Name + Type  Package     Sta    Promotion   Date       Time      User         Status
ACPSRCEE LOD ACTP000032  DEV    20  S6P1IT  2015/02/01 22:06     USER015      Common
ACPSRCEE SRC ACTP000032  DEV    20  S6P1IT  2015/02/01 22:06     USER015      Common
******************************* Bottom of data ********************************

This table describes the fields on the Common Components panel.

Field	Description
Package	Displays the Package ID of the current change package
Status	Displays the current status of the change package.
Install date	Displays the date when this package is proposed for installation. (yyyymmdd).
Name	Displays the name of the package component that already exists in the target promotion library or in history for this promotion target. This is the member that will potentially be overlaid if the current promotion action is continued.
Type	Displays the library type of the common component.
Package	Displays the Package ID of the package from which the component in the target promotion library was promoted.
Sta	Displays the status of the package from which the component in the target promotion library was promoted.
Promotion	Displays the nickname and level number of the target promotion level.
Date	Displays the date when the component in the target promotion library was promoted. (yyyymmdd)
Time	Displays the time when the component in the target promotion library was promoted. (hh:mm)
User	Displays the TSO ID of the person who promoted the component in the target promotion library.
Status	Displays the type of potential overlay.
	Common: The component is physically present in the target promotion library, and there is history of another package promoting the component to this promotion level in this site.
	Nohist: The component is physically present in the target promotion library, but there is no history of another package promoting the component to this promotion level in this site.
	History: The component is not physically present in the target promotion library, but there is history of another package promoting the component to this promotion level in this site.
	Restaged: The component is physically present in the target promotion library, and there is history of this package promoting the component to this promotion level in this site before the component was restaged.

Carefully examine the component and package information displayed on the Common Components panel. Contact the people who promoted packages that are listed on this panel to assess the impact of overlaying their components in test libraries. They may be able to demote their package so you can promote your package without overlays.