Skip to content

Configuring Production Libraries

Baseline libraries are the permanent repository for current and prior versions of application components. In a relatively simple data center environment where production applications have access to ChangeMan ZMF baseline libraries, you may choose to have baseline libraries serve as production execution libraries.

However, if you want to maintain a separate set of production execution libraries, you must configure production libraries in ChangeMan ZMF application administration. If production applications run on other LPARs or CPUs without shared DASD, you must configure ChangeMan ZMF applications to manage one or more installation sites, each with a set of production libraries.

There are three kinds of production libraries

  • Production execution libraries - These libraries contain the application components that execute in the production environment.

  • Production backup libraries - These libraries contain the prior version of production library components. Before a component is installed in a production library, the existing production component is copied to the backup library. If a package is backed out, components in the backup libraries are copied back into the production libraries.

  • Temporary libraries - These production override libraries contain components installed with temporary packages. When the temporary change package duration has passed, package components are removed from the temporary libraries.

Before you configure production libraries in a D or DP environment, you must define installation sites. See Defining Application Sites. For any kind of development environment, you must set the Install In Prod indicator to Y or C for each library type on the Baseline Configuration Part 1 of 2 panel for which you want to set up production libraries. See Configuring Baseline Libraries.

Note

For the special case of an ALL environment where the only production libraries you need are temporary production override libraries, see Configuring Temporary Override Libraries for ALL Environments.

Note

If you want to use a DP environment like an A (ALL) environment without defining production libraries:
1. Define a Global Site (=A.G.6) with:
  1. Site Name that is the same as the Site Node Name in Global Parameters, and...
  2. Logical Unit Name that is the same as the Logical Unit Or System Name in Global Parameters.
2. Define this site as the only site in each application in Application Administration (=A.A.8).
3. Define each baseline library type with Install In Prod set to N in every application in Application Administration (=A.A.B).
With this configuration, several jobs are executed at package installation that perform no function other than to record completion in the package master and/or trigger submission of the next installation job.

Defining Production Libraries For A New Application

Perform these steps to set up production libraries for a new application.

  1. On the Update Application Administration Options panel, select Option P and press Enter. If you are configuring a DP environment, 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 *******************************
    
  2. On the application - Site Selection List panel, select a site by typing S in the line command for the site, and press Enter.

  3. The application - site Production Libraries panel (CMNCPRDL) is displayed.

    CMNCPRDL          DEMX - C001 Production Libraries         Row 1 to 7 of 7 
    Command ===> ____________________________________________ Scroll ===> CSR
    
        Type Production dataset name    +
             Temporary dataset name     +
             Backup dataset name        + 
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    ___ ____ _________________________________________________  +
             _________________________________________________  +
             _________________________________________________  +
    **************************** Bottom of data *******************************
    

    This table describes the fields on the application - site Production Libraries panel (CMNCPRDL).

    Field Description
    Line Command Valid line commands:
    I - Insert a new line.
    R - Repeat an existing line.
    D - Delete a line.
    Type Enter the library type. Enter '*' to select from a list of valid library types defined by Application Admin. HINT: To enter several library types that have similar dataset names, enter all information for one library type, then repeat the lib type line and change the necessary characters.
    Production dataset name Enter the fully-qualified dataset name for the production library associated with the respective library type. This becomes the target library for components within Permanent change packages upon installation.
    NOTE: In an ALL environment, production datasets are optional.
    Temporary dataset name Enter the fully-qualified dataset name for the temporary library associated with the respective library type. Components in Temporary packages are installed in this library. NOTE: Temporary datasets are required regardless of environment type.
    Backup dataset name Enter the fully-qualified dataset name for the backup production library associated with the respective library type. At install time, production libraries are backed up into this library.
    NOTE: In an ALL environment, backup datasets are optional.

    ...

  4. On the application - site Production Libraries panel, type * in the line command of the first empty library type and press Enter. The Library Type Selection List 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 *******************************
    
    Field Description
    Lib Display of all valid defined library types.
    Description The descriptive free-form text associated with each library type.

    ...

    This list includes only those library types for which you specified Y or C in the Install In Prod field on the application - Baseline Configuration panel.

  5. On the on the Library Type Selection List panel, type S in the line command for every library type and press Enter. You are returned to the application - site Production Libraries panel, where library types are filled in.

  6. On the application - site Production Libraries panel, complete the set of production library names for each library type.

    Note

    Type NULLFILE in the Temporary Dataset Name field if you prohibit temporary packages in this application by setting the Allow Temporary Packages indicator to NO in application administration parameters.

    CMNCPRDL           DEMX - C001 Production Libraries        Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
            Type Production dataset name    +
                 Temporary dataset name     +
                 Backup dataset name        + 
    ___ CLS CMNTP.S7.V820.PROD.DEMX.C001.CLS 
            CMNTP.S7.V820.TEMP.DEMX.C001.CLS 
            CMNTP.S7.V820.BACK.DEMX.C001.CLS 
    ___ JCL CMNTP.S7.V820.PROD.DEMX.C001.JCL 
            CMNTP.S7.V820.TEMP.DEMX.C001.JCL 
            CMNTP.S7.V820.BACK.DEMX.C001.JCL
    **************************** Bottom of data *******************************
    

    ...

  7. Press PF3 to save your changes and return to the site - Site Selection List (for a D or DP environment) or the Update Application Administration Options panel (in an ALL environment.).

Updating Production Libraries

Perform these steps to update production libraries for an application.

  1. On the Update Application Administration Options panel, select Option P and press Enter. If you are configuring a DP environment, 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 *******************************
    

    ...

  2. On the application - Site Selection List panel, select a site by typing S in the line command for the site, and press Enter.

  3. The application - site Production Libraries panel (CMNCPRDL) is displayed. (If you are configuring an ALL environment, this is the first panel you see.)

    CMNCPRDL          DEMX - C001 Production Libraries        Row 1 to 2 of 2 
    Command ===> ___________________________________________ Scroll ===> CSR
    
        Type Production dataset name    +
             Temporary dataset name     +
             Backup dataset name        + 
    
    ___ CLS  CMNTP.S7.V820.PROD.DEMX.C001.CLS 
             CMNTP.S7.V820.TEMP.DEMX.C001.CLS 
             CMNTP.S7.V820.BACK.DEMX.C001.CLS 
    ___ JCL  CMNTP.S7.V820.PROD.DEMX.C001.JCL 
             CMNTP.S7.V820.TEMP.DEMX.C001.JCL
             CMNTP.S7.V820.BACK.DEMX.C001.JCL 
    **************************** Bottom of data ******************************
    

    This table describes the fields on the application - site Production Libraries panel (CMNCPRDL).

    Field Description
    Line Command Valid line commands:
    I - Insert a new line.
    R - Repeat an existing line.
    D - Delete a line.
    Type Enter the library type. Enter '*' to select from a list of valid library types defined by Application Admin.
    HINT: To enter several library types that have similar dataset names, enter all information for one library type, then repeat the lib type line and change the necessary characters.
    Production dataset name Enter the fully-qualified dataset name for the production library associated with the respective library type. This becomes the target library for components within Permanent change packages upon installation.
    NOTE: In an ALL environment, production datasets are optional.
    Temporary dataset name Enter the fully-qualified dataset name for the temporary library associated with the respective library type. Components in Temporary packages are installed in this library.
    NOTE: Temporary datasets are required regardless of environment type.
    Backup dataset name Enter the fully-qualified dataset name for the backup production library associated with the respective library type. At install time, production libraries are backed up into this library.
    NOTE: In an ALL environment, backup datasets are optional.

    ...

  4. If you want to remove a set of production libraries for a library type, type D in the line command for the library type and press Enter. The library type and its production libraries are removed from the application - site Production Libraries panel.

    Note

    If you remove a library type from the application - site Production Libraries panel, you must reset the Install In Prod indicator to N or C for that library type on the Baseline Configuration Part 1 of 2 panel. See Configuring Baseline Libraries.

  5. To add a library type and a set of production libraries to the application - site Production Libraries panel, follow these steps:

    1. Type I (Insert) in the line command above where you want to insert the library type and press Enter. An empty library type entry is inserted on the panel.

    2. Type * in the line command for the empty library type entry and press Enter. The Global 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 **************************
      

      This list includes only those library types for which you specified Y or C in the Install In Prod field on the application - Baseline Configuration panel.

    3. On the on the Library Type Selection List panel, type S in the line command for the library type you want to add and press Enter. You are returned to the application - site Production Libraries panel, where the new library type is filled in at the insertion point.

  6. On the application - site Production Libraries panel, add a set of production libraries for each new library type, or change existing library names.

    Note

    Type NULLFILE in the Temporary Dataset Name field if you prohibit temporary packages in this application by setting the Allow Temporary Packages indicator to NO in application administration parameters.

    CMNCPRDL           DEMX - C001 Production Libraries        Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
        Type Production dataset name    +
             Temporary dataset name     +
             Backup dataset name        +
    
    ___ CLS  CMNTP.S7.V820.PROD.DEMX.C001.CLS 
             CMNTP.S7.V820.TEMP.DEMX.C001.CLS 
             CMNTP.S7.V820.BACK.DEMX.C001.CLS 
    ___ JCL  CMNTP.S7.V820.PROD.DEMX.C001.JCL 
             CMNTP.S7.V820.TEMP.DEMX.C001.JCL 
             CMNTP.S7.V820.BACK.DEMX.C001.JCL
    **************************** Bottom of data ******************************
    
  7. Press PF3 to save your changes and return to the site - Site Selection List (for a D or DP environment) or the Update Application Administration Options panel (in an ALL environment).

Configuring Temporary Override Libraries for ALL Environments

Temporary change packages populate temporary override libraries concatenated over production execution libraries. These override libraries are defined in ChangeMan ZMF application administration as production libraries.

If you are configuring an ALL environment where you use baseline libraries for production execution libraries, and you do not need to define a full set of production libraries, follow these steps to define production override libraries for temporary packages.

  1. On the Application Administration Option panel, type the application mnemonic in the Application field, type B on the Option line, and press Enter. The application - Baseline Configuration Part 1 of 2 panel is displayed.

  2. On the application - Baseline Configuration Part 1 of 2 panel, type Y or C in the Install In Prod field for each library type for which you want a production execution override library.

  3. When you are finished making entries on the application - Baseline Configuration Part 1 of 2 panel, press Enter to save your changes, and you are returned to the Update Application Administration Options panel.

  4. On the Update Application Administration Options panel, type P in the Options field and press Enter. The application - Production Libraries panel is displayed.

  5. On the application - Production Libraries panel, type * in the line command for an empty row. The Library Type Selection List is displayed. This list includes only those library types for which you specified Y in the Install In Prod field on the application - Baseline Configuration panel.

  6. On the on the Library Type Selection List panel, type S in the line command for every library type and press Enter. You are returned to the application - Production Libraries panel.

  7. On the application - Production Libraries panel, make these entries for every library type:

    1. Type NULLFILE in the Production Dataset Name field

    2. Type the dataset name of the temporary production execution override library in the Temporary Dataset Name field.

    3. Type NULLFILE in the Backup Dataset Name field

  8. Press PF3 to save your changes and return to the Update Application Administration Options panel.

Update Parameters Across Applications

Select option U - Update Parameters across applications and you will see panel CMNPLST4 - Application - Update Options. You have these choices:

CMNPLST4                        ACTP - Update Options 
Option ===> __________________________________________________________________

1  Library Type Update Library types
2  Baseline Update Baseline libraries
3  Production Update Production libraries

The Update function allows for copying or deleting of application parameters from one application to mulitple target applications.

To copy or delete parameters, enter the associated option in the Option field and press the ENTER key.

Then on the next panel CMNPLST3, use the list of applications to select applications to propagate the desired administrative changes.

LINE COMMANDS

S Update parameters to this application

APPL

All application mnemonics that the user has update access to.

DESCRIPTION

The short description of the application entered when the application was created.

HIGHEST #

The total number of change packages ever created for each application.

STATUS

Indicates whether the application is LOCKED , IN USE or *Select. LOCKED applications cannot be updated. IN USE denotes that another administrator is currently updating the application. *Select indicates this will be a target application for the update.

Application Copy Tool

This copies an application's administrative, package and history data. The first part is accessed in Application Admin option Z, this option will call CMNADMAC to copy an application's administration, package and history records to flat package and component master files. The flat package and component files are allocated using the global development model dsnames with a package number of zeros.

For example the Component file CMNTP.S7.ACTP.STG8.#000000.COMPNT and package file CMNTP.S7.ACTP.STG8.#000000.PACKAGE, where ACPT is the application being copied and 000000 is the zero package number.

The second part to this process is the loading of the application's administrative, package and history records at the target system. To accomplish this, the job provided in the CNTL member ACTLOAD (which executes CMNADMAL) must be modified to your shop standards and executed. You will need to provide the datasets for the JOBLIB, parms for SUBSYS (target system id) and USER (userid with authority), SER#PARM dataset, and CMAST and PMAST DDs (component/package master names produced by the first part). Note that you should take a secure backup of the package master and component master before running this job.