Using Release Area Promotion

ERO release area promotion contains four functions that you use to manage and execute area and base ChangeMan ZMF promotions:

Display promotion history
Check for potential overlay
Display promotion libraries
Promote release area components

Follow the steps in this section to navigate through area promotion panels to promote release area components. From the application - Promotion Options panel (step 6), you can choose the options to display promotion history, check for potential overlay, or display promotion libraries.

Follow these steps to access the release that contains the area that you want to promote.
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 BAS 20160328 WR 9010        FINANCE     USER015 00001
     FIN6430 BAK 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 release areas defined in ERO release administration.

On the Release List panel, type line command AR on a release row to select the release that contains the area you want to promote, then press Enter. The release Release Area List panel is displayed.

CMNRMALF            FIN6430 Release Area List           Row 1 to 3 of 3
Command ===>                                            Scroll ===> CSR

          Area                Status            Area Prior      Next
    Name      Type   Aud  BLK CIA COA CIR COR   step area       area
    ACCTPAY   SUBSYS 00    N   N   N   Y   N    0001            FINANCE
    GENLEDGR  SUBSYS       N   N   N   N   N    0002            FINANCE
    FINANCE   SYSTEM       N   N   N   N   N    0003 GENLEDGR
******************************* Bottom of data *******************************

The release Release Area List panel shows all areas that are defined in the release that you selected.

The fields on release Release Area List panel are described in Notifying Area Check-in Approvers.

On the release Release Area List panel, type line command PA on the panel row for the area you want to promote, then press Enter. The release Joined Application List panel is displayed.

CMNRMAFL            FIN6430 Joined Application List     Row 1 to 3 of 3
Command ===>                                            Scroll ===> CSR

    Appl Join Date  Application Description
_   ACTP 20160325   Accounts Payable____________________________
_   COMM 20160325   Common Components___________________________
_   GENL 20160325   General Ledger Accounting___________________
******************************* Bottom of data *******************************

This panel shows all applications joined to the release that contains the area you want to promote.

On the release Joined Application List panel, type line command S on the panel row for one or more applications that you want to promote in the release area you selected previously. You can also type SETALL and SETOFF in the Command line to select or deselect all applications. Press Enter and the release area application Promotion panel is displayed.
```
CMNRMPLV        FIN6430 ACCTPAY ACTP PROMOTION      Row 1 to 2 of 2
Command ===>                                        Scroll ===> CSR

  Site  Nickname  Level CI-Apr Blocked CO-Apr
_ SERT4 SERT4UTE  50      Y      N       N
_ SERT4 SERT4QAE  60      Y      Y       N
******************************* Bottom of data *******************************
```
This panel shows all promotion sites and levels defined for the release, area, and application named in the panel header.

On the release area application Promotion panel, type line command S on one or more panel rows for the site/levels to which you want to promote.

Note

If you select two promotion levels in the same site, components that are promoted to the first selected level will be cleaned up by the promotion to the second promotion level.

Press Enter, and the Promotion Criteria panel is displayed.

CMNRMPSC                Promotion Criteria
Command ===>

Release: S4712010 Area: GENLEDGR GENL Site: SERT4P1 Promotion: S4P1UT   10

Specify Selection Criteria:
  Component name . . . . . . .                                         +
                                        (Full Name, Blank or Mask)
  Component type . . . . . . . +        (Full Type, Blank or Mask)
  Check-in date: from . . . .       +   (yyyymmdd)
                 to . . . . .       +   (yyyymmdd)
  Check-in user . . . . . . .       +   (Full Name, Blank or Mask)
Enter "/" to select option
  _ Full Promotion/Demotion
  _ Specific Package(s)
  _ Only Eligible Components
  _ Mixed Case

This panel contains selection criteria you can use to preselect area components that are displayed on subsequent promotion panels.

Note

When you leave the area promotion panels and return to the release Release Area List panel, the values on the release/area/application/site/level Criteria panel are reset to the default values you see in the panel image above.

This table describes the fields on the Release List Specification Parameters panel.

Field	Description
Component Name	Type one of the following to select area components by component name. The default for this field is blank. Blank Do not select area components by component name. List area components that satisfy all other selection criteria. Component Name Select area component that match a component name. Mask Select area components with names that fit a mask.
Component Type	Type one of the following to select area components by component (library) type. The default for this field is blank. Blank Do not select area components by component type. List area components that satisfy all other selection criteria. Component Type Select area components that match a component type. Mask Select area components with component types that fit a mask.
Check-in date: from	Type the low end of a range of area component check-in dates to select. This date is inclusive. The default is blank, which is the same as 00000000.
to	Type the high end of a range of area component check-in dates to select. This date is inclusive. The default is blank, which is the same as 99999999.
Check-in user	Type one of the following to select area components by the userid of the person who checked the component in to the area. The default for this field is blank. Blank Do not select area components by check-in userid. List area components that satisfy all other selection criteria. Userid Select area component that were checked in to the area by a specific userid. Mask Select area components that were checked in to the area by userids that fit a mask.
Full Promotion/ Demotion	Specify full or selective promotion or demotion. Select to promote or demote all components. No component list will be displayed. The Check-in user and From/To Date filtering is ignored. If other filtering is supplied, only eligible components are promoted or demoted. Omit to Indicate selective promotion or demotion. All filtering is applied, and the component selection list is displayed.
Specific Package(s)	Type a value to display or suppress a panel to select packages checked in to the area. The default is omitted. Select to display the application Release release Package List panel so you can select area components checked in from specific packages. Omit to suppress the display of the application Release release Package List panel. List area components that satisfy all other selection criteria.
Only Eligible Components	Type a value to list or suppress area components that are currently promoted to the target site/level. The default is Y. Select to list components that are not currently promoted from the area to the target site. Omit to list all components, including those that are already at the target site.
Mixed Case	Type a value to determine the processing of lower case input in the Component Name field. Select to process Component Name input exactly as you type it, upper and lower case. Omit to fold Component Name input to upper case regardless of the case that you type.

Note

If the Full Promotion/Demotion field and the Only Eligible Components field are both selected, package components are fully demoted but the package promotion level remains unchanged. If the Full Promotion/Demotion field is selected and the Only Eligible Components field is omitted, the package promotion level is reset to level 0 (staging).

Note

If you filter the list of area components with selection criteria on the Promotion Criteria panel, use the SETALL command on the Promote_ release area site _Components panel (step 7), you can promote a large number of area components without selecting each component individually from a long list.

After you have typed selection criteria on the release/area/application/site/level Criteria panel, press Enter. The application - Promotion Options panel is displayed.

CMNRMPRM                    ACTP - Promotion Options
Option ===>
    Release: FIN6430    Area: ACCTPAY   Status: DEV Install  Date: 20160318

        H Display history                 O Check for overlay       +
        L Display libraries                                         +

    Promotion Site : SERT4      Promotion Level: SERT4UTE + 50

Enter "/" to select option
    Bypass Overlay Check

Job Statement Information:
    //USER239E JOB  (X170,374),
    //              CLASS=A,MSGCLASS=H,
    //              TIME=1,NOTIFY=USER239
    //*

This is the panel that executes promotion or offers three other functions to assist you in managing your promotion environment.

This table describes the fields on the application - Promotion Option panel.

Field	Description
Option	Type a promotion option, or leave blank and press Enter to promotion area components. H Display promotion history for the application/area/site/level. O Display potential component overlays in the target promotion libraries. L List promotion libraries for the site and level displayed on this panel.
Release	Displays the release ID of the release that contains the area where you are promoting components.
Area	Displays the name of the area containing the components you are promoting.
Release	Displays the status of the release containing the area where you are promoting components. DEV Development status - Releases that are in the process of being built. Applications may still join a release that is in DEV status BLK Block status - Releases that are blocked from any further development and awaiting approval for installation into production and baseline libraries. APR Approve status - Releases that are approved for install by everyone on the approver list and awaiting for distribution, if applicable. REJ Reject status - Releases that were rejected by one or more approvers on the approver list. DIS Distribution status - Approved releases whose components are distributed to all remote sites specified in attached change packages. INS Install status - Releases that are installed in all remote sites specified in attached change packages. BAS Baseline status - Releases with all components baseline rippled in baseline libraries. BAK Backout status - Releases that were in BAS status, then backed out with all components removed from production and baseline libraries. DEL Deleted status - Releases that have been Memo Deleted.
Install Date	Displays the Install From date for the release
Promotion Site	Displays the site that you are promoting to.
Promotion Level	Displays the level within the site you are promoting to.
Bypass Overlay Check	Type your choice for bypassing the check for potential component overlays before promotion is executed. Omit to check area components against target promotion libraries for potential component overlays. If potential overlays are detected, display a panel listing the common components where you can explicitly choose to overlay the component in the promotion library, skip promotion for the problem component, or discontinue the promotion action. Select to bypass the check for potential component overlays in target promotion libraries. Note: If you choose to bypass overlay checking, components in promotion libraries that have the same name and type as components in the area you are promoting are replaced without warning. This may invalidate test results for another project.
Job Statement Information	Job card information for area promotion jobs that will run on the same MVS image as your ISPF session.

If you select one of the three options at the top of the application - Promotion Option panel, see these sections for descriptions of the panel that will display:

If you select Option H, see Displaying Promotion History.
If you select Option L, see Displaying Promotion Libraries.

If you want to continue with area promotion, type your choice for the Bypass Overlay Check, change the Job Statement Information if required, and press ENTER.

The Promote Component List panel is displayed.

CMNRMPDM            Promote Component List          Row 000001 of 000018
Command ===>                                        Scroll ===> CSR

Release: FIN6430 Area: ACCTPAY Site: SERT4

    Component               Package     Promotion           Current
    Name    Type Status     Name        Date    Time  User  Name    Level
    ACPCTL10 CTL            ACTP000038                      STAGING 00
    ACPCTL20 CTL            ACTP000039                      STAGING 00
    ACPCTL30 CTL            ACTP000039                      STAGING 00
    ACPJCL10 ACT            ACTP000038                      STAGING 00
    ACPJCL10 JCL            ACTP000039                      STAGING 00
    ACPJCL20 ACT            ACTP000039                      STAGING 00
    ACPJCL20 JCL            ACTP000039                      STAGING 00
    ACPPRC10 PRC            ACTP000038                      STAGING 00
    ACPPRC20 PRC            ACTP000039                      STAGING 00
    ACPSRC1A LOD            ACTP000038                      STAGING 00
    ACPSRC1A LST            ACTP000038                      STAGING 00
    ACPSRC1A SRC            ACTP000038                      STAGING 00
    ACPSRS1B LOS            ACTP000038                      STAGING 00
    ACPSRS1B LST            ACTP000038                      STAGING 00
    ACPSRS1B SRS            ACTP000038                      STAGING 00
    ACPSRS1C LOS            ACTP000038                      STAGING 00

This panel displays a list of area components that you can promote. This components listed on this panel are a subset of all area components that has been selected by the panels you passed through to get to this panel:

You selected an application on the release - Joined Application List panel. See step 4 in Using Release Area Promotion.
You selected a site/level on the release/area/application - Promotion panel. See step 3 in Using Release Area Promotion.
You may have set additional area component selection criteria on the release/ area/application/site/level Criteria panel. See step 5 in Using Release Area Promotion.

This table describes the fields on the Promote release/area/site Components panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on a component. CANCEL Cancel panel without update. (Abbreviation: C) LOCATE Locate a component. (Abbreviation: L) component SETALL Sets all line commands to S to select all listed components. SETOFF Sets all line commands to blank to deselect any selected components.
Line Command	Type S to select a component for promotion.
Component Name	Displays the component name.
Type	Displays the component library type.
Status	Displays the current component status. Blank means the component is not currently promoted.
Package Name	Displays the package ID of the package from which the component was checked in to the release.
Promotion Date	Displays the date that the component was last promoted or demoted. (yyyymmdd)
Time	Displays the system time that the component was last promoted or demoted. (hh:mm)
User	Displays the userid of the person who last promoted or demoted the component.
Current Name / Level	Displays the nickname of and level number of the promotion level to which the component was last promoted. “Staging 00” means the component is not currently promoted.
Level	Displays the target check-in area.

Type Line command S on a panel row for an area component to select the component for promotion, or type SETALL to select all listed components for promotion.

Note

If you filter the list of area components with selection criteria on the release area application site level Criteria panel (step 6), then use the SETALL command on the Promote Component List panel, you can promote a large number of area components without selecting each component individually from a long list.

When you are satisfied with your selections on the Promote Component List panel, press Enter.

If there are no problems with promoting any of the area components you selected, and if there are more selected promotion levels to process for an application, you are returned to the release area application site level Criteria panel to process the next promotion level.

If all selected promotion levels are processed and there are more selected applications to process, you are returned to the release area application Promotion panel to process the next application.

When you have processed all selected applications and promotion levels, you are returned to the release Release Area List panel, which is shown in step 10.

Promotion skeletons are file tailored in the background to build promotion jobs, and the promotion jobs are submitted. MVS SEND messages inform you of the outcome of the promotion jobs.

If you left the Bypass Overlay Check field set to N on the application - Promotion Option panel, and if potential overlays are detected, the Common Components site/level panel is displayed.

CMNRMPCO        Common Components           Row 000001 of 000002
Command ===>                                Scroll ===> CSR

Site: SERT4     Promotion level: SERT4UTE 50

Name    Type Package Release    Promotion   Date       User    Status
ACPJCL10 JCL ACTP000075         SERT4UTE 50 2005/11/04 WSER239 Common
ACPJCL30 JCL ACTP000075         SERT4UTE 50 2005/11/04 WSER239 Common
******************************* Bottom of Data *******************************

This panel tells you that the target promotion libraries or history for the target promotion site/level contain one or more components that match the name and type of components that you are trying to promote from a release area.

This table describes the fields on the Common Components site/level panel.

Field	Description
Command	Cancel Cancel panel without update. (Abbreviation: C)
Component Name	Displays the name of the 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 where the component in the promotion library originated.
Release	The release ID of the release where the component in the promotion library originated. If this field is blank, the component was promoted from a the package, not from a release area.
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)
User	Displays the userid 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 or area 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 or area 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 or area 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 or area promoting the component to this promotion level in this site before the component was restaged.

You have two choices for action on the Common Components site/level panel.

You can type Cancel on the command line, or press F3, to return to the Promote release/area/site Components panel and abandon your attempted area promotion until you can resolve the potential overlay.
You can press Enter and proceed with the promotion.

Caution

If there is a component in the promotion library that you overlay with the component from your area promotion, you could invalidate someone else’s test results.

If you choose to ignore the potential overlay warning, and you press Enter on the Common Components site/level panel to proceed with your area promotion, you are returned to the release - Release Area List panel. Promotion skeletons are file tailored in the background to build promotion jobs, and the promotion jobs are submitted. MVS SEND messages inform you of the outcome of the promotion jobs.

CMNRMALF        FIN6430 RELEASE AREA LIST       Promotion Submitted
Command ===>                                    Scroll ===> CSR

        Area               Status           Area Prior     Next
    Name    Type   Aud BLK CIA COA CIR COR  Step Area      Area
__ ACCTPAY SUBSYS  00   Y   Y   Y   N   N   0001          FINANCE
__ GENLEDGR SUBSYS      Y   Y   Y   N   N   0002          FINANCE
__ FINANCE SYSTEM       Y   Y   Y   N   N   0003 ACCTPAY
******************************* Bottom of data *******************************

...

Displaying Promotion History

You can view history entries for promotion to and demotion from a site/level. Follow these steps to choose the Display Promotion History option in area promotion.

Follow the instructions in Using Release Area Promotion to get to the application - Promotion Option panel (step 6).

On the application - Promotion Option panel, type H on the Option line and press Enter. The Promotion History panel is displayed.

CMNRMPPH            Promotion History           Row 000001 of 000011
Command ===>                                        Scroll ===> CSR

Promotion Site: SERT4       Promotion level: SERT4UTE 50

Count   Package    Date       Time  TSOID   Status    History
0000012 ACTP000038 2016/02/27 04:57 USER239 Completed Selective Promotion
0000006 ACTP000039 2016/02/27 04:57 USER239 Completed Selective Promotion
0000004 ACTP000039 2016/02/27 04:54 USER239 Completed Selective Demotion
0000002 ACTP000038 2016/02/27 04:54 USER239 Completed Selective Demotion
0000004 ACTP000039 2016/02/27 04:45 USER239 Completed Selective Promotion
0000002 ACTP000038 2016/02/27 04:45 USER239 Completed Selective Promotion
0000012 ACTP000038 2016/02/27 04:42 USER239 Completed Selective Demotion
0000006 ACTP000039 2016/02/27 04:42 USER239 Completed Selective Demotion
0000004 ACTP000039 2016/02/27 04:40 USER239 Completed Selective Promotion
0000012 ACTP000038 2016/02/27 04:39 USER239 Completed First Promotion
0000002 ACTP000039 2016/02/27 04:38 USER239 Completed First Promotion
****************************** Bottom of Data ********************************

This panel shows all promotion and demotion activity against the site/level.

Area promotion shares the promotion hierarchy defined in application administration with package promotion in the base product. Promotion history shows all activity against a site/level, which may include package promotions and area promotions.

Since each promotion job copies components that originated in a single package, promotion history for area promote and demote actions may show several entries for the one area promotion action you took. There will also be multiple promotion jobs, and multiple promotion history entries, when a release area being promoted contains many components that originated in the same package.

This table describes fields on the site/level Promotion History panel.

Field	Description
Count	Displays the number of area components promoted or demoted.
Package	Displays the ID of the package where area promotion components originated, or the ID of a package that was promoted.
Date	Displays the date when the when the promote or demote action was taken. (yyyymmdd)
Time	Displays the time when the promote or demote action was taken. (hh:mm)
TSOID	Displays the TSOID of the person who initiated the promote or demote action.
Status	Displays the current status of the batch promotion process. SUBMITTED The batch process was submitted, but all jobs have not completed successfully. A job may be waiting for an initiator, a job may still be running, or a job may have failed. COMPLETED The batch promote or demote process has completed successfully.
History	Displays the type of action in the promote or demote request. Selective Promotion Area promote or selective promote of package components Selective Demotion Area demote or selective demote of package components First Promotion First selective promote of a package component while the package is at Level 0 Full Promotion Full package promote Full Demotion Full package demote

Displaying Promotion Libraries

You can list the promotion libraries that are the target of your promotion action. Follow these steps to choose the Display Promotion Libraries option in area promotion.

Follow the instructions in Using Release Area Promotion to get to the application - Promotion Option panel (step 6).

On the application - Promotion Option panel, type L on the Option line and press Enter. The site/level Libraries panel is displayed.

...

CMNRMPLB            Promotion Libraries             Row 000001 Of 000024
Command ===>                                            Scroll ===> CSR

Site: SERT4 Promotion: SERT4UTE 50 +

    Library
    Type    Target Libraries
    ACT     PROD3.SERT4.PROM.ACTP.SERT4UTE.ACT      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.ACT      Library 1
    CPY     PROD3.SERT4.PROM.ACTP.SERT4UTE.CPY      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.CPY      Library 1
    CPS     PROD3.SERT4.PROM.ACTP.SERT4UTE.CPS      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.CPS      Library 1
    CTL     PROD3.SERT4.PROM.ACTP.SERT4UTE.CTL      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.CTL      Library 1
    JCL     PROD3.SERT4.PROM.ACTP.SERT4UTE.JCL      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.JCL      Library 1
    LCT     PROD3.SERT4.PROM.ACTP.SERT4UTE.LCT      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.LCT      Library 1
    LOS     PROD3.SERT4.PROM.ACTP.SERT4UTE.LOS      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.LOS      Library 1
    LOD     PROD3.SERT4.PROM.ACTP.SERT4UTE.LOD      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.LOD      Library 1
    LST     PROD3.SERT4.PROM.ACTP.SERT4UTE.LST      Shadow
            PROD3.SERT4.PROM.ACTP.SERT4UTE.LST      Library 1