Skip to content

Configuring Promotion Sites, Levels, and Libraries

The Application Administrator configures promotion for an application by defining a hierarchy of sites, promotion levels, library types, and test library names. When developers, project managers, and test coordinators promote or demote a package in the application, they choose a site and a promotion level as the target for their action.

For a discussion of the promotion function, see Promotion And Demotion.

Promotion Definition Order

The order that promotion sites, levels, and library types appear on application administration panels determines the order that promotion libraries are concatenated in batch job JCL.

The following table lists some library concatenations that depend on the promotion definition order.

JCL ddname Library Type Used in batch jobs...
SYSLIB LIKE-C types Copybook expansion steps running CMNWRITE
Copybook libraries in compile and assemble jobs
Copybook libraries in BMS MAP gens
Copybook libraries in IMS PSB/DBD gens
SYSLIB LIKE-L types Load libraries in link edit
Load libraries in IMS PSB/DBD gens
INCLIB Target Type Load libraries in link edit.
OBJLIB Object library types defined in skeleton CMN$$VAR Object libraries in link edit

...

Configuring Promotion For A New Application

Perform these steps to set up promotion for a new application:

  1. On the Application Administration Option panel, type 7 on the Option line and press Enter. The Application - Promotion Site List panel is displayed. When this panel is first accessed for a new application, it is empty:

    CMNLRPMS           DEMX - Promotion Site List            Row 1 to 3 of 3 
    Command ===> ____________________________________________ Scroll ===> CSR
    
                     Force     Rest after    Promote beyond    Internal   Reader class
        Site        demotion    demotion      package level      site        local 
    ___ ________       _           _               _              _
    ___ ________       _           _               _ 
    ___ ________       _           _               _ 
    ___ ________       _           _               _ 
    *************************** Bottom of data *******************************
    

    ...

  2. To populate the Application Promotion Site List panel, type * in the line command for the first empty Site Name entry and press Enter. The Application - Site Selection List panel (CMNRMTSL) is displayed.

    CMNRMTSL            DEMX - Site Selection List             Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
      Site Name 
    _ C001 
    _ C002
    *************************** Bottom of data *******************************
    

    ...

  3. On the Application - Site Selection List panel, type S in the line command for each site that you want to define as a promotion target for the new application. Press Enter to return to the Application - Promotion Site List panel, where the selected sites are displayed.

  4. Complete the other fields on the application - Promotion Site List panel. The following table describes the fields on that panel.

    Field Description
    Line Command Type a line command to the left of a panel row.
    S - Select to see the next panel for this site.
    I - Insert a blank site row.
    R - Repeat an existing site.
    D - Delete an existing site.
    * - Display a selection list of available sites.
    Site The names of all promotion sites at which a change package may be promoted to or demoted from.
    Force demotion If this value is set to 'Y', promotion is forbidden to this site if any other sites are in promotion status. Also, no other sites may be promoted to until this site has been demoted.
    Reset after demotion If this value is set to 'Y', on a selective demotion it will reset the package level to '0' staging if all components are overlaid or at level '0' staging.
    Promote beyond package level If this value is set to 'Y', selective promotion beyond the current package level is allowed. This is displayed as a 1st promotion in promotion history. This will also become the new package promotion level for that site.

    If the value is set to 'Y', for Reset after demotion, it will reset the package level to the highest level that has a promoted component. If none are promoted, it will set the package level to '0' staging. This will also reset the package level if a selective promotion is executed and that promotion is to a lower level. If all components at that level have been promoted to a lower level, the package promotion level will be reset to the highest promotion level that has a component in it.
    Internal Reader class Defines the output class for submitting job JCL to the internal reader.
    site: This is the internal reader class that will be used to submit promotion jobs for a remote site.
    local: This is the internal reader class that will be used to submit promotion jobs for the local site.

    ...

  5. When you finish entering site information on the Application Promotion Site List panel, it might look like this.

    CMNLRPMS            DEMX - Promotion Site List             Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
                        Force       Rest after  Promote beyond  Internal Reader class
        Site           demotion      demotion    package level    site      local 
    ___ C001              N             _             _             A         A 
    ___ C002              N             _             _             A         A 
    *************************** Bottom of data *******************************
    

    ...

  6. You must define promotion levels for each promotion site. On the Application Promotion Site List panel, type S in the line command for a Site Name, and press Enter. The Application/Site Promotion Levels panel is displayed. When this panel is first displayed for a site, it is empty:

    CMNLRPM2           DEMX/C001 - Promotion Levels Row         1 to 12 of 12 
    Command ===> ___________________________________________ Scroll ===> CSR
    
        Nickname    Entity      Level   Procedure
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    ___ ________    ________     ___    ________
    **************************** Bottom of data ******************************
    

    ...

  7. Complete a promotion level entry for each promotion environment you want for this application in this site. The table that follows describes fields on the Application/Site Promotion Levels panel.

    Field Description
    Line Command Type a line command to the left of a panel row.
    S - Select to see the next panel for this promotion level.
    I - Insert a blank promotion level row.
    R - Repeat an existing level.
    D - Delete an existing level.
    Nickname Enter an easily-recognizable name for the promotion libraries. This nickname will be used as a reference on the Promotion/Demotion panels.
    Entity Your security package will perform a check against this entity to determine whether or not the user is authorized to promote to this level.
    Level Type a numeric promotion level. Number promotion levels in increments of 5 or 10 so that more levels can be added in between later. ChangeMan ZMF can accommodate up to 99 levels of promotion. Enter the number for the level associated with this level of promotion.
    Procedure Type the name of the skeleton procedure to be used in ISPF file tailoring to build JCL for promotion jobs. This must be the member name from the ISPF library that contains the skeleton JCL for the procedure. ChangeMan ZMF will search the SKELS concatenation for procedures to display from which the Administrator may select. Enter an '*' in this field if a list is to be displayed.
    CMN$$PRM - For promotion levels with libraries on a local site. If no entry is made, ChangeMan ZMF automatically inserts this skeleton name.
    CMN$$RPM - For promotion levels with libraries on a remote site.

    ...

  8. When you finish defining promotion levels on the Application/Site Promotion Levels panel, might look like this.

    CMNLRPM2           DEMX/C001 - Promotion Levels            Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
        Nickname    Entity      Level   Procedure 
    ___ ONE         CMN8LCAD     10     CMN$$PRM 
    ___ TWO         CMN8LCAD     20     CMN$$PRM
    **************************** Bottom of data ******************************
    

    ...

  9. For each promotion level on the Application/Site Promotion Levels panel you must define target library types and data set names. Type S on the line command of a promotion level, and the Application/Site Promotion Libraries panel is displayed. The first time this panel is displayed for a promotion level it is blank:

    CMNLRPM3            DEMX/C001 - Promotion Libraries        Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
    Promotion name: ONE     Level: 10
    
            Syslib Cleanup
    
        Lib exclude Level Target libraries
    ___ ___   _       _   ________________________________________   + Shadow 
                      _   ________________________________________   + Library 1
                      _   ________________________________________   + Library 2
                      _   ________________________________________   + Library 3
    ___ ___   _       _   ________________________________________   + Shadow
                      _   ________________________________________   + Library 1
                      _   ________________________________________   + Library 2
                      _   ________________________________________   + Library 3
    

    ...

  10. To add library types on the Application/Site Promotion Libraries panel, type * in the line command for the first blank entry on the panel and press Enter. The Library Type Selection List panel is displayed.

    CMNLTPSL             Library Type Selection           List Row 1 to 7 of 7 
    Command ===> ____________________________________________ Scroll ===> CSR
    
    Lib     Description 
    _ CLS   CLIST
    _ JCL   JCL Library Type
    _ LCT   Linkedit Control Cards
    _ LST   Listing
    _ NCL   NCAL subroutine load library
    _ OBJ   Object module library PKG Db2 Bind Package Commands
    **************************** Bottom of data ******************************
    

    ...

  11. On the Library Type Selection List panel, type S in the line command for any application library type that you want to add at the insert point on the Application/Site Promotion Libraries panel. You may select multiple library types, but you can not scroll down to select library types from multiple pages of the Library Type Selection List at one time.

    Note

    Promotion library types usually include executable library types that are tested. However, you may also wish to promote other types to allow for checkout from promotion.

  12. Press Enter to return to the Application/Site Promotion Libraries panel, where the new library types have been added at the insertion point.

  13. On the Application/Site Promotion Libraries panel, type information in the remaining fields for each library type. The following table describes the fields on the Application/ Site Promotion Libraries panel:

    Field Description
    Promotion name Promotion nickname that you selected on the previous panel.
    Level Promotion level that is defined on the previous panel.
    Line Command Type a line command to the left of a row:
    I - Insert a blank library type row.
    R - Repeat an existing library type.
    D - Delete an existing library type.
    * - Display a selection list of available library types.
    Lib Enter a 3-character library type. Enter * to select from the list of defined library types for the current application.
    SYSLIB EXCLUDE Enter a Y in this field to exclude the library type from file tailoring during staging functions (like-source component stage, recompile or relink). This setting effectively excludes the dataset from the promotion library table (RPMLIBTB), and subsequent inclusion in the SYSLIB concatenations for the compilation and binder process.
    You can use this parameter to exclude like-copy and like-load libraries from SYSLIB concatenations and to exclude like-copy libraries from audit.
    If you change this flag during a package lifecycle, audit may find SYNCH15!.
    Y - Exclude promotion libraries from stage, recompile, and relink jobs. Exclude the libraries from audit processing.
    N - Include library in normal processing.
    NOTE Two facilities work together to designate the criteria that audit uses to issue SYNCH15! errors during a package audit: The SYSLIB EXCLUDE flag, which is described here. User exit CMNEX044. Refer to the ChangeMan ZMF Customization Guide and to the comments in module CMNEX044 of the CMNZMF.ASMSRC library for more information about this exit.
    Target libraries
    Shadow
    Library 1
    Library 2
    Library 3
    Enter the fully-qualified dataset names of all promotion targets which ChangeMan ZMF will associate with the library type for this level of promotion. Up to three libraries may be specified. The Shadow Library resides at the local site for common module and overlay checking, and may be defined as one of the three target libraries, if they are located at the local site (accessible via IEBCOPY). If the target libraries are located at a site, then the shadow library must be defined as a separate dataset, and you should use the promotion procedure CMN$$RPM (promote to a site) for promotion and demotion purposes, rather than CMN$$PRM. This procedure will synchronize the shadow library with the targeted components during promotion and demotion, to provide a mirror image of the local site (accessible via IEBCOPY). If the target libraries are located at a site, then the shadow library must be defined as a separate dataset, and you should use the promotion procedure CMN$$RPM (promote to a site) for promotion and demotion purposes, rather than CMN$$PRM.
    This procedure will synchronize the shadow library with the targeted components during promotion and demotion, to provide a mirror image of the site promotion datasets. The CMN$$PRM skeleton does not synchronize the components.
    You may specify 'NULLFILE' as the Shadow Library dataset name if you wish to bypass physical member overlay checking, and rely only on the data stored in the promotion history records. If you do this, overlay messages will not show a 'common' overlay (the component exists in both promotion history AND the target library), nor 'unknown' (the member exists in the target library, but there is no promotion history), but it will show the 'history' status (component not found in the target library, but exists in the promotion history records).

    ...

    Note

    Promotion library types usually only include, as a minimum, executable library types. However, you may want to promote other types to allow for checkout from promotion.

  14. To save the new application promotion definition:

    1. On the Application/Site Promotion Libraries panel, press PF3 or type End on the Command Line and press Enter.
    2. On the Application/Site Promotion Levels panel, press PF3 or type End on the Command Line and press Enter.
    3. On the Application - Promotion Site List panel, press PF3 or type End on the Command Line and press Enter.

Update Promotion For An Application

Perform these steps to update the promotion definitions for an application.

  1. On the Application - Administration Option panel, type 7 on the Option line and press Enter. The Application - Promotion Site List panel is displayed.

    CMNLRPMS              DEMX - Promotion Site List           Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
                       Force           Internal Reader class
         Site        demotion            site       local 
    ____ C001           N                 A           A 
    ____ C002           N                 A           A
    ***************************** Bottom of data *****************************
    

    See the tables above for descriptions of the fields on the Application Promotion Site List panel.

    • To delete a site from the Application Promotion Site List panel, type D (Delete) in the line command field for the site and press Enter.
    • To add a site to the Application Promotion Site List panel, type I (Insert) in the line command field above where you want to insert the site and press Enter. An empty site row is inserted on the panel.
    • Type * in the line command field for the empty site definition and press Enter. The Application - Site Selection List panel is displayed.

      CMNRMTSL DEMX - Site Selection List                    Row 1 to 2 of 2
      Command ===> ________________________________________ Scroll ===> CSR
      
        Site Name 
      _ C001 
      _ C002
      ***************************Bottom of data*****************************
      

    ...

  2. On the Application - Site Selection List panel, type S in the line command for each site that you want to add. Press Enter, and you return to the Application Promotion Site List panel, where the selected sites are displayed.

  3. Complete the other fields on the Application - Promotion Site List panel.

To update promotion levels for a promotion site:

  1. On the Application - Promotion Site List panel, type S in the line command field for a Site Name, and press Enter.

    The application/Site Promotion Levels panel is displayed.

    CMNLRPM2              DEMX/C002 - Promotion Levels         Row 1 to 2 of 2
    Command ===> ____________________________________________ Scroll ===> CSR
    
        Nickname    Entity      Level   Procedure 
    ___ ONE         CMN8LCAD     10     CMN$$PRM 
    ___ TWO         CMN8LCAD     20     CMN$$PRM
    ***************************** Bottom of data *****************************
    

    ...

    See the tables above for descriptions of the fields on this panel.

  2. Complete the other fields on the Application/Site Promotion Levels panel.

To update the library types and promotion libraries for a promotion level:

  1. On the Application/Site - Promotion Levels panel, type S on the line command field for a promotion level.

    The Application/Site - Promotion Libraries panel is displayed.

    CMNLRPM3           DEMX/C002 - Promotion Libraries         Row 1 to 1 of 1 
    Command ===> ____________________________________________ Scroll ===> CSR
    
    Promotion name:  ONE             Level:  10
    
              Syslib  Cleanup
        Lib   exclude  Level  Target libraries
    ___ CLS     N        Y    CMNTP.S8.ONE.C002.DEMX.CLS.SHADOW     + Shadow 
                              CMNTP.S8.ONE.C002.DEMX.CLS            + Library 1
                         _    _________________________________     + Library 2
                         _    _________________________________     + Library 3
    

    See the tables above for descriptions of the fields on this panel.

    • To delete a library type with its promotion libraries from the Application/Site Promotion Libraries panel, type D (Delete) in the line command field for the library type and press Enter.

    • To add a library type with promotion libraries to the Application/Site Promotion Libraries panel, type I (Insert) in the line command field above where you want to insert the library type and press Enter. An empty library type row is inserted on the panel.

    • Type * in the line command field for the empty library type row and press Enter. The Library Type Selection List panel is displayed.

    CMNLTPSL            Library Type Selection List            Row 1 to 7 of 7 
    Command ===> ____________________________________________ Scroll ===> CSR
    
      Lib Description 
    _ CLS CLIST
    _ JCL JCL Library Type
    _ LCT Linkedit Control Cards
    _ LST Listing
    _ NCL NCAL subroutine load library
    _ OBJ Object module library 
    _ PKG Db2 Bind Package Commands
    ***************************** Bottom of data *****************************
    

    ...

  2. On the Library Type Selection List panel, type S in the line command for any application library type that you want to add at the insert point on the Application/Site Promotion Libraries panel. You may select multiple library types, but you cannot scroll down to select library types from multiple pages of the Library Type Selection List at one time.

    Note

    Promotion library types usually include executable library types that are tested. However, you may also wish to promote other types to allow for checkout from promotion.

  3. Press Enter to return to the Application/Site Promotion Libraries panel, where the new library types have been added at the insertion point.

  4. Complete the rest of the fields on the Application/Site Promotion Libraries panel.

  5. To save your updates to the application promotion definition:

    1. On the Application/Site Promotion Libraries panel, press PF3 or type End on the Command Line and press Enter.

    2. On the Application/Site Promotion Levels panel, press PF3 or type End on the Command Line and press Enter.

    3. On the Application - Promotion Site List panel, press PF3 or type End on the Command Line and press Enter.