Configuring Area Promotion Sites and Levels

This sections tells you how to add and update promotion site and level definitions for release areas in ERO administration.

The instructions in this section assume that:

Promotion sites, levels, and libraries are already defined in application administration in the base ChangeMan ZMF product for the applications joined to a release.
You have customized promotion skeletons to execute special processes required for your test environments.
The application administrator has mapped ERO areas to promotion sites and levels.

Initially Defining Promotion Levels for an Area

If you have not previously defined any promotion levels for a release area, use the procedure described in this section to define levels for an area. If you want to update existing promotion levels for an area or add levels, see Adding or Updating Promotion Levels for an Area.

To initially define promotion levels for a release area, you use a series of panels arranged in the following hierarchy:

Promotion Definition Panel Hierarchy	Panel Title	Panel ID
Release	**Release List	CMNRMRAL
Application	release **- Joined Application List	CMNRMRAP
Area	release **Release Area Selection List	CMNRMPMA
Site	release/area **Site Selection List	CMNRMPMS
Level	release/area/site **- Level List	CMNRMPML
Behavior Rules	release/area/site/level **Behavior	CMNRMPMF

Tip

On many of the panels in the process described here, you can select multiple rows to define promotion levels serially. However, until you become familiar with the panels in this process, it is possible to lose track of where you are while processing multiple selections. You may prefer to make a single selection in each panel to define one level, then go to Adding or Updating Promotion Levels for an Area to finish the definition of promotion levels for your release.

Follow these steps to initially define a promotion level for a release area in ERO Administration:

Access the Release List through the following menu path.
1. Type =A on the Command or Option line of any panel in ChangeMan ZMF, then press Enter.
2. Type R on the Option line of the Administration Options panel, and press Enter.
3. Type A on the Option line of the Release Management Administration Options panel, and press Enter.
4. Type release selection criteria in fields on the Release List Parameters panel, or leave the fields blank. Press Enter. and the Release List panel is displayed.
```
 CMNRMRAL            Release List                Row 1 to 3 of 3
 Command ===>                                    Scroll ===> CSR

    Release Sta Install  Work Request    Dept Aud    Creator Pkgs
 __ FIN6410 DEV 20160430 WR 9010         FINANCE     USER239 00005
 __ FIN6420 DEV 20160427 WR 9011         FINANCE     USER239 00005
 __ FIN6430 DEV 20160418 WR 9012         FINANCE     USER239 00006
 ******************************* Bottom of data *******************************
```
The Release List panel shows the releases that have areas defined and satisfy the selection criteria you typed on the Release List Parameters panel. If you entered no selection criteria, this panel shows all releases with areas defined.

Release List panel, type line command RA on a release row and press Enter.

The release Joined Application List panel is displayed.

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

   Appl Lib Sys Prm Join Date Application Description
__ ACTP  Y   Y   N  20160225  Accounts Payable
__ COMM  Y   Y   N  20160225  Common Components
__ GENL Y   Y    N  20160225  General Ledger Accounting
******************************* Bottom of data *******************************

This panel shows all applications joined to the release.

On the release Joined Application List panel, type AP on one or more application rows and press Enter. The release Release Area Selection List panel is displayed.

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

    Area
    Name    Type    Step Description
_ ACCTPAY   SUBSYS  0001 Starting area for Accounts Payable components
_ GENLEDGR  SUBSYS  0002 Starting area for General Ledger components
_ FINANCE   SYSTEM  0003 Final area for Finance components
******************************* Bottom of data *******************************

This panel displays all of the areas defined for the release.

This table describes the fields, commands, and line commands on the release Release Area Selection List panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on an area. CANCEL Cancel panel without update. (Abbreviation: CA) LOCATE area Locate an area. (Abbreviation: LO) REFRESH Refresh the panel display from the VSAM files. (Abbreviation: RE)
Line Command	Type S to select one or more release areas.
Area Name	Displays the area name.
Type	Displays the area type. SUBSYS Subsystem area SYSTEM System area
Step	Displays the step number specified in the area definition. The number in this field determines the order that areas are displayed on ERO panels.
Description	Displays the area description.

On the release Release Area Selection List panel, type S on one or more area rows to add or update promotion sites and levels and press Enter. The release area Site Selection List** panel is displayed.

CMNRMPMS    FIN6430 ACCTPAY Site Selection List     Row 1 to 2 of 2
Command ===>                                        Scroll ===> CSR

    Site    Force   Internal Reader Class
    Name   Demotion   Site      Local
_   SERT4     N        A          A
_   SERP4     N        A          A
******************************* Bottom of data *******************************

This panel displays the promotion sites defined in Application Administration in the base ChangeMan ZMF product.

This table describes the fields, commands, and line commands on the release area Site Selection List panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on a site. CANCEL Cancel panel without update. (Abbreviation: CA) LOCATE site Locate a site. (Abbreviation: LO) REFRESH Refresh the panel display from the VSAM files. (Abbreviation: RE)
Line Command	Type S to select one or more promotion sites.
Site Name	Displays a list of promotion sites defined to the application in Application Administration in the base ChangeMan ZMF product.
Force Demotion	Displays the Force Demotion rule for a site from Application Administration in the base product. In ERO, the values for this rule mean: Y An area cannot be promoted to this site and another site at the same time. You must demote an area from all other sites before you can promote the area to this site. You cannot promote an area to another site until you demote the area from this site. N An area can be promoted to this site and an another site at the same time, unless the Force Demotion rule for the other site is Y. You can promote an area to this site while the area is promoted to another site unless the Forced Promotion rule for the other site is Y. You can promote an area to another site while it is promoted to this site, unless the Force Demote rule for the other site is Y.
Internal Reader Classes	Displays the JES internal reader class from Application Administration in the base product that is used when submitting promotion jobs for a site. Site Internal reader class for remote site. Local Internal reader class for local site.

On the release area Site Selection List panel, type S to select one or more promotion sites and press Enter. The release area site Level List panel is displayed.

CMNRMPML        FIN6430 ACCTPAY SERT4 Level List        Row 1 to 5 of 5
Command ===>                                            SCROLL ===> CSR

  Nickname    Entity    Level   Procedure
_ SERT4UT     ACTPDEV   10      CMN$$PRM
_ SERT4QA     QATCOORD  20      CMN$$PRM
_ SERT4UA     UATCOORD  30      CMN$$PRM
_ SERT4UTE    CMN4RLSM  50      CMN$$PRM
_ SERT4QAE    CMN4RLSM  60      CMN$$PRM
******************************* Bottom of data *******************************

This panel displays the promotion levels defined to the site in Application Administration in the base ChangeMan ZMF product.

This table describes the fields, commands, and line commands on the release/area/ site - Level List panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on promotion level. CANCEL Cancel panel without update. (Abbreviation: CA) LOCATE nickname Locate a promotion level nickname. (Abbreviation: LO) REFRESH Refresh the panel display from the VSAM files. (Abbreviation: RE)
Line Command	Type S to define one or more promotion levels for the area.
Nickname	Displays a list of Nicknames used on promotion panels that represents the promotion level and the set of promotion libraries.
Entity	Displays the security entity defined in your security system that is authorized to promote to and demote from this level.
Level	Displays the promotion level number assigned to this level. This level number is unique for the application and site.
Procedure	Displays the skeleton that is file tailored to create the batch jobs for promotion and demotion for this promotion level.

On the release area site Level List panel, type S to select one or more promotion levels and press Enter. The Promotion Behaviour panel is displayed.

CMNRMPMF                Promotion Behaviour
Command ===>

    Release: FIN6430    Area:ACCTPAY    Site:SERT4  Level:SERT4UTE 50

Enter "/" to select option
    Area Check-in Approved
    Area Blocked
    Area Check-off Approved
    Demotion Required For Retrieve

This panel displays the behavior rules for an area promotion level in ERO. This information is unique to ERO and is not included in Application Administration in the base ChangeMan ZMF product.

This table describes the fields on the Promotion Behavior panel.

Field	Description
Area Check-in Approved	Select to set the Area Check-in Approved rule for the promotion level. The default for this rule is not selected. Select results in area check-in approval being required before you can promote area components to this level. Omitted means that area check-in approval is not required before you can promote area components to this level.
Area Blocked	Select to set the Area Blocked rule for the promotion level. The default for this rule is not selected. Select means the Area must be blocked before you can promote area components to this level. You must demote all area components from this level before you can unblock the area. If not selected, then the Area need not be blocked when you promote area components to this level. You can unblock the area while area components are promoted to this level.
Area Check-off Approved	Select to set the Area Check-off Approved rule for the promotion level. The default for this rule is not selected. Select to require Area check-off approval before you can promote area components to this level. Note: The Area Blocked rule is forced to selected if the Area Check-off Approved rule is selected because an area must be blocked before check-off approvals can be entered. If not selected then Area check-off approval is not required before you can promote area components to this level.
Demotion Required For Retrieve	Select to set the Demotion Required for Retrieving rule. The default for this rule is not selected. If selected then you must demote area components from this level before you can retrieve the components from the area. If not selected then you can retrieve area components while the components are promoted to this level.

Overtype behavior rules you want to change on the Promotion Behavior panel, then press Enter. The promotion site/level is defined for the area, and the release application Promotion panel is updated and displayed.
```
CMNRMPM0        FIN6430 ACTP PROMOTION      Promotion Updated
Command ===>                                SCROLL ===> CSR

    Area    Site    Nickname Level CI-Apr Blocked CO-Apr Retrieve
__  ACCTPAY SERT4   SERT4UTE 50     N       N       N       N
******************************* Bottom of data *******************************
```
This panel lists the promotion site/levels defined for the listed areas in the release and application displayed in the panel header.

If the release application Promotion panel does not display a row for every area/ site/level you intend to use for promotion in the release and application named in the panel header, see Adding or Updating Promotion Levels for an Area for instructions about using this panel to add new promotion levels or update existing promotion definitions.

Adding or Updating Promotion Levels for an Area

If you have previously defined at least one promotion level for a release area, use the procedure described in this section to update that definition or add promotion levels to the area. If you have not previously defined any promotion levels for a release area, see Initially Defining Promotion Levels for an Area.

To update existing promotion level definitions for a release area or to add new levels, you use a series of panels arranged in the following hierarchy:.

Promotion Definition Panel Hierarchy	Panel Title	Panel ID
Release	**Release List	CMNRMRAL
Application	release **- Joined Application List	CMNRMRAP
Defined Promotion Levels by Area	**release/application - Promotion	CMNRMPM0
Area	release **Release Area Selection List	CMNRMPMA
Site	release/area **Site Selection List	CMNRMPMS
Level	release/area/site **- Level List	CMNRMPML
Behavior Rules	release/area/site/level **Behavior	CMNRMPMF

Tip

On many of the panels in the process described here, you can select multiple rows to define promotion levels serially. However, until you become familiar with the panels in this process, it is possible to lose track of where you are while processing multiple selections. You may prefer to make a single selection in each panel to define one level at a time.

Follow these steps to update existing promotion level definitions for a release area or to add new levels to a release area in ERO Administration:

Access the Release List through the following menu path.
1. Type =A on the Command or Option line of any panel in ChangeMan ZMF, then press Enter.
2. Type R on the Option line of the Administration Options panel, and press Enter.
3. Type A on the Option line of the Release Management Administration Options panel, and press Enter.
4. Type release selection criteria in fields on the Release List Parameters panel, or leave the fields blank. Press Enter. and the Release List panel is displayed.
```
 CMNRMRAL            Release List                Row 1 to 3 of 3
 Command ===>                                    Scroll ===> CSR

        Release Sta Install  Work Request    Dept Aud    Creator Pkgs
     __ FIN6410 DEV 20160430 WR 9010         FINANCE     USER239 00005
     __ FIN6420 DEV 20160427 WR 9011         FINANCE     USER239 00005
     __ FIN6430 DEV 20160418 WR 9012         FINANCE     USER239 00006
 ******************************* Bottom of data *******************************
```
The Release List panel shows the releases that have areas defined and satisfy the selection criteria you typed on the Release List Parameters panel. If you entered no selection criteria, this panel shows all releases with areas defined.

On the Release List panel, type line command RA on a release row and press Enter.

The release Joined Application List panel is displayed.

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

   Appl Lib Sys Prm Join Date Application Description
__ ACTP  Y   Y   Y  20160325  Accounts Payable____________________________
__ COMM  Y   Y   N  20160325  Common Components___________________________
__ GENL  Y   Y   N  20160325  General Ledger Accounting___________________
******************************* Bottom of data *******************************

This panel shows all applications joined to the release.

On the release Joined Application List panel, type AP on one or more application rows and press Enter. The release application Promotion panel is displayed.
The release application Promotion panel lists the promotion site/levels already defined for the listed areas in the release and application displayed in the panel header. From this panel you can update an existing site/level for a release area, or you can add a new site/level to the area.
```
CMNRMPM0            FIN6430 ACTP Promotion          Row 1 to 1 of 1
Command ===>                                        Scroll ===> CSR

   Area     Site    Nickname Level CI-Apr Blocked CO-Apr Retrieve
__ ACCTPAY  SERT4   SERT4UTE 50     N       N       N       N
******************************* Bottom of data *******************************
```
- To add a new area/site/level combination, go to Step 7 of Configuring Area Promotion Sites and Levels
- To update an existing site/level, go to the next step.

To update an existing area/site/level on the release application Promotion panel, type UP on one or more panel rows and press Enter. The Promotion Behavior panel is displayed.

CMNRMPMF                Promotion Behaviour
Command ===>

    Release: FIN6430 Area:ACCTPAY Site:SERT4 Level:SERT4UTE 50

Enter "/" to select option
    Area Check-in Approved
    Area Blocked
    Area Check-off Approved
    Demotion Required For Retrieve

This panel displays the behavior rules for an area promotion level in ERO. This table describes the fields on the Promotion Behavior panel.

Field	Description
Area Check-in Approved	Select to set the Area Check-in Approved rule for the promotion level. The default for this rule is not selected. Select to require area check-in approval before you can promote area components to this level. Omit to not require area check-in approval before you can promote area components to this level.
Area Blocked	Select to set the Area Blocked rule for the promotion level. The default for this rule is not selected. Select to require the area must be blocked before you can promote area components to this level. You must demote all area components from this level before you can unblock the area. If omitted, then the area need not be blocked when you promote area components to this level. You can unblock the area while area components are promoted to this level.
Area Check-off Approved	Select to set the Area Check-off Approved rule for the promotion level. The default for this rule is omitted. Select to require area check-off approval before you can promote area components to this level. Note: The Area Blocked rule is forced to a selected state if the Area Checkoff Approved rule is selected because an area must be blocked to before check-off approvals can be entered. If omitted then area check-off approval is not required before you can promote area components to this level.
Demotion Required For Retrieve	Select to set the Demotion Required for Retrieving rule. The default for this rule is omitted. If selected, you must demote area components from this level before you can retrieve the components from the area. If not selected, you can retrieve area components while the components are promoted to this level.

Overtype behavior rules you want to change on the Promotion Behavior panel, then press Enter. The promotion site/level is defined for the area, and the release application Promotion panel is updated and displayed.
```
CMNRMPM0        FIN6430 ACTP Promotion          Promotion Updated
Command ===>                                    Scroll ===> CSR

   Area     Site    Nickname Level CI-Apr Blocked CO-Apr Retrieve
__ ACCTPAY  SERT4   SERT4UTE 50     N       N       N       N
******************************* Bottom of data *******************************
```
This panel lists the promotion site/levels defined for the listed areas in the release and application displayed in the panel header.
- To update an existing site/level, go back to Step 5 above.
- To add a new area/site/level combination, go to the next step.

To add a promotion area/site/level, type * on a row on the release application Promotion panel, and press Enter. The release Release Area Selection List panel is displayed.

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

  Area      Type    Step    Description
_ ACCTPAY   SUBSYS  0001    Starting area for Accounts Payable components
_ GENLEDGR  SUBSYS  0002    Starting area for General Ledger components
_ FINANCE   SYSTEM  0003    Final area for Finance components
******************************* Bottom of data *******************************

This panel displays all of the areas defined for the release.

This table describes the fields, commands, and line commands on the release Release Area Selection List panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on an area. CANCEL Cancel panel without update. (Abbreviation: CA) LOCATE area Locate an area. (Abbreviation: LO) REFRESH Refresh the panel display from the VSAM files. (Abbreviation: RE)
Line Command	Type S to select one or more release areas.
Area	Displays the area name.
Type	Displays the area type. SUBSYS Subsystem area SYSTEM System area
Step	Displays the step number specified in the area definition. The number in this field determines the order that areas are displayed on ERO panels.
Description	Displays the area description.

On the release Release Area Selection List panel, type S on one or more area rows to add or update promotion sites and levels and press Enter. The release/area - Site Selection List panel is displayed.

CMNRMPMS        FIN6430 ACCTPAY Site Selection List     Row 1 to 2 of 2
Command ===>                                            Scroll ===> CSR

  Site      Force     Internal Reader Class
  Name     Demotion     Site      Local
_ SERT4       N          A          A
_ SERP4       N          A          A

******************************* Bottom of data *******************************

This panel displays the promotion sites defined in Application Administration in the base ChangeMan ZMF product.

This table describes the fields, commands, and line commands on the release area Site Selection List panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on a site. CANCEL Cancel panel without update. (Abbreviation: CA) LOCATE site Locate a site. (Abbreviation: LO) REFRESH Refresh the panel display from the VSAM files. (Abbreviation: RE)
Line Command	Type S to select one or more promotion sites.
Site Name	Displays a list of promotion sites defined to the application in Application Administration in the base ChangeMan ZMF product.
Force Demotion	Displays the Force Demotion rule for a site from Application Administration in the base product. In ERO, the values for this rule mean: Y An area cannot be promoted to this site and another site at the same time. You must demote an area from all other sites before you can promote the area to this site. You cannot promote an area to another site until you demote the area from this site. N An area can be promoted to this site and an another site at the same time, unless the Forced Promotion rule for the other site is Y. You can promote an area to this site while the area is promoted to another site unless the Forced Promotion rule for the other site is Y. You can promote an area to another site while it is promoted to this site, unless the Force Demote rule for the other site is Y.
Internal Reader Classes	Displays the JES internal reader class from Application Administration in the base product that is used when submitting promotion jobs for a site. Site Internal reader class for remote site. Local Internal reader class for local site.

On the release area Site Selection List panel, type S to select one or more promotion sites and press Enter. The release area site Level List panel is displayed.

CMNRMPML        FIN6430 ACCTPAY SERT4 Level List        Row 1 to 5 of 5 
Command ===>                                            SCROLL ===> CSR

    Nickname    Entity   Level  Procedure
_   SERT4UT     ACTPDEV   10    CMN$$PRM
_   SERT4QA     QATCOORD  20    CMN$$PRM
_   SERT4UA     UATCOORD  30    CMN$$PRM
_   SERT4UTE    CMN4RLSM  50    CMN$$PRM
_   SERT4QAE    CMN4RLSM  60    CMN$$PRM

******************************* Bottom of data *******************************

This panel displays the promotion levels defined to the site in Application Administration in the base ChangeMan ZMF product.

This table describes the fields, commands, and line commands on the release area site Level List panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on a promotion level. CANCEL Cancel panel without update. (Abbreviation: CA) LOCATE nickname Locate a promotion level nickname. (Abbreviation: LO) REFRESH Refresh the panel display from the VSAM files. (Abbreviation: RE)
Line Command	Type S to define one or more promotion levels for the area.
Nickname	Displays a list of Nicknames used on promotion panels that represents the promotion level and the set of promotion libraries.
Entity	Displays the security entity defined in your security system that is authorized to promote to and demote from this level.
Level	Displays the promotion level number assigned to this level. This level number is unique for the application and site.
Procedure	Displays the skeleton that is file tailored to create the batch jobs for promotion and demotion for this promotion level.

On the release area site Level List panel, type S to select one or more promotion levels and press Enter. The Promotion Behaviour panel is displayed.

CMNRMPMF            Promotion Behaviour 
Command ===>

    Release: FIN6430    Area: ACCTPAY   Site: SERT4     Level: SERT4UTE 60

Enter "/" to select option 
    Area Check-in Approved
    Area Blocked
    Area Check-off Approved
    Demotion Required For Retrieve

This panel displays the behavior rules for an area promotion level in ERO. This table describes the fields on the Promotion Behaviour panel.

Field	Description
Area Check-in Approved	Select to set the Area Check-in Approved rule for the promotion level. The default for this rule is omitted. Select to require area check-in approval before you can promote area components to this level. Omit to not required area check-in approval before you can promote area components to this level.
Area Blocked	Select to set the Area Blocked rule for the promotion level. The default for this rule is omitted. Select to require the area be blocked before you can promote area components to this level. You must demote all area components from this level before you can unblock the area. If omitted then the area need not be blocked when you promote area components to this level. You can unblock the area while area components are promoted to this level.
Area Check-off Approved	Select to set the Area Check-off Approved rule for the promotion level. The default for this rule is omitted. Select to require area check-off approval before you can promote area components to this level. Note: The Area Blocked rule is forced to selected if the Area Check-off Approved rule is selected because an area must be blocked before check-off approvals can be entered. Omit to not require area check-off approval before you can promote area components to this level.
Demotion Required For Retrieve	Select to set the Demotion Required for Retrieving rule. The default for this rule is omitted. Select to require that you must demote area components from this level before you can retrieve the components from the area. Omit to allow you to retrieve area components while the components are promoted to this level.

Overtype behavior rules you want to change on the Promotion Behaviour panel, then press Enter. The promotion site/level is defined for the area, and the release application Promotion panel is displayed.
```
CMNRMPM0        FIN6430 ACTP Promotion          Promotion Updated 
Command ===>                                   Scroll ===> CSR

    Area    Site    Nickname  Level CI-Apr Blocked CO-Apr Retrieve
__  ACCTPAY SERT4   SERT4UTE  50      N       N      N       N
__  ACCTPAY SERT4   SERT4QAE  60      Y       Y      N       Y

******************************* Bottom of data *******************************
```
This panel lists the promotion site/levels defined for the listed areas in the release and application named in the panel header.

If the release application Promotion panel does not display a row for every area/ site/level you intend to use for promotion in the release and application named in the panel header, go to Step 7 in this section to add more areas, sites, and levels.

Go to Step 5 in this section to update an existing row on this panel.