Skip to content

Configuring Baseline Libraries

Baseline libraries are the permanent repositories for application components. Use the baseline configuration function to specify physical baseline library names and to set the following related parameters:

  • The technology or file type used to store current and prior versions of components
  • How many prior versions of components are held in baseline libraries
  • Whether components are copied to separate production libraries as well as to baseline libraries when a change package is installed.

    If you have set the parameter for Keep Baseline by Site on the Application Parameters - Part 1 of 4 panel, baseline libraries must be configured for each site. See Configuring Remote Sites for details.

Allocating Baseline Libraries

  1. Select Option B on the Update Application Administration Options panel. The Application - Baseline Configuration Part 1 of 2 panel (CMNCBAS1) is displayed.

    CMNCBAS1     DEMX - Baseline Configuration Part 1 of 2     Row 1 to 7 of 7 
    Command ===> ____________________________________________ Scroll ===> CSR
    
                                    Baseline
                        Install     storage
        Type    Levels  in prod     means 
    ___ CLS       10       Y        SD 
    ___ JCL       10       Y        SD
    ___ LCT       10       N        SD 
    ___ LST       3        N        P 
    ___ NCL       3        N        P 
    ___ OBJ       3        N        P
    ___ PKG       10       N        SD 
    *************************** Bottom of data *******************************
    

    The following table describes the field of the Application - Baseline Configuration Part 1 of 2 panel (CMNCBAS1) and the information that you can enter when you create new libraries.

    Field Description
    Type Type the library type. Enter a * to select from the list of valid library types.
    Levels Enter the number of baseline levels to maintain for each library type. The range is from 2 to 10. Baseline libraries with storage means SD can retain a maximum of 999 levels; LA can retain up to 255.
    Install in prd Enter 'Y' if the library type is to be moved into the production libraries upon installation. Enter 'N' if the library type is not to be moved into the production libraries. Enter 'C' if the movement of the library type into the production libraries is dependent on their existence at the site.
    Baseline storage means Specify the means of maintaining the baseline libraries. Valid values for this field are as follows:
    SD - STACKED REVERSE DELTA - The 0 level baseline version is stored in a PDS or PDSE. All prior versions are stored as reverse delta records in a single PDS or PDSE. NOTE: This is the most efficient storage means for text components that can be compressed with delta technology.
    P - PDS or PDSE - The 0 level baseline library is a PDS or a PDSE, and each prior version level is stored in a separate PDS or PDSE library without compression.
    H - Hierarchical File System - The 0 level baseline library is a zFS directory, and each prior version level is stored in a separate zFS directory without compression.
    L - LIBRARIAN managed master files
    LA - LIBRARIAN ARCHIE managed master files
    PV - PANVALET managed files

    ...

  2. To update an existing library, type S to select a row to specify the actual data set names for the item. The Application Baseline Configuration Part 2 of 2 panel (CMNCBAS2) is displayed.

    CMNCBAS2     DEMX - Baseline Configuration Part 2 of 2     Row 1 to 2 of 2 
    Command ===> ____________________________________________ Scroll ===> CSR
    
        Library type:       CLS
        Levels maintained:  10
        Storage means:      Stacked Reverse Delta
    
      Lvl   Dataset name        +                           Status 
    _ -000  CMNTP.S7.V820.BASE.DEMX.CLS 
    _ -009  CMNTP.S7.V820.BASE.DEMX.CLS.DELTA 
    *************************** Bottom of data *******************************
    

    ...

    The Application Baseline Configuration Part 2 of 2 panel (CMNCBAS2) specifies the names of an application's baseline libraries. The rows are already generated when you access the panel. From this panel you can verify or allocate (specify V or A) the baseline library data sets. ChangeMan ZMF uses these names when it creates batch jobs to ripple an application's baseline libraries after a change package has been installed. These libraries must exist and ChangeMan ZMF must be able to update them.

    If you have set the parameter for Keep Baseline by Site on the Application Parameter Part 1 of 2 panel (CMNGLP01), baseline libraries must be configured for each site. See Configuring Remote Sites.

  3. In a row of the Application Parameter Part 1 of 2 panel (CMNGLP01), type A or V and press Enter to allocate or verify these baseline library. Verify will display the allocation details.

    Note

    This option is not available for Librarian or Panvalet.

    • If you typed V in a row, the Dataset Information panel (CMNDSINF) is displayed.

      CMNDAIPO                    Dataset Information 
      Command ===> _________________________________________________________
      
      Library Type    CLS
      Dataset Name    CMNTP.S7.V820.BASE.DEMX.CLS
      
      General Data:                   Current Allocation:
       Management class  . .           Allocated tracks  . . 1
       Storage class . . . . COMMON    Allocated extents . . 1
        Volume serial  . . . SRSM31    Maximum dir. blocks . 4
        Device type  . . . . 3390 
       Data class  . . . . .
        Organization . . . . PO       Current Utilization:
        Record format  . . . FB        Used tracks . . . . . 1
        Record length  . . . 80        Used extents  . . . . 1
        Block size . . . . . 27920     Used dir. blocks  . . 1
        1st extent tracks  . 1         Number of members . . 0
        Secondary tracks . . 2
        Extended Attributes
      
      Extended Information:           Date Information:
       Creation Time . . . .           Creation  . . . . . . 2018/04/23
       Creation Job  . . . .           Last referenced . . . 2018/04/30
       Creation Step . . . .           Expiration  . . . . . ***NONE***
      

      ...

    • If you verify, and a baseline library data set does not exist, the long message "CMN2650I - Unable to allocate dsname dataset", and *Error is displayed in the STATUS column next to the data set name.

    • If the dataset is a PDSE then a different panel CMNDAIPE is displayed.

      CMNDAIPE                    Dataset Information 
      Command ===> _________________________________________________________
      
      Library Type    DOC
      Dataset Name    CMNTP.S7.V820.BASE.ACTP.DOC
      
      General Data:                   Current Allocation:
       Management class  . .           Allocated tracks  . . 1
       Storage class . . . . COMMON    Allocated extents . . 1
        Volume serial  . . . SRSM31    Maximum dir. blocks . NOLIMIT
        Device type  . . . . 3390 
       Data class  . . . . .
        Organization . . . . PO       Current Utilization:
        Record format  . . . FB        Used pages  . . . . . 5
        Record length  . . . 80        % Utilized  . . . . . 45
        Block size . . . . . 32720     Number of members . . 0
        1st extent tracks  . 1
        Secondary tracks . . 5
        Data set name type . LIBRARY
        Data set version . . 2
        Extended Attributes
      
      Extended Information:           Date Information:
       Creation Time . . . .           Creation: . . . . . . 2018/08/01
       Creation Job  . . . .           Last referenced . . . 2018/08/01
       Creation Step . . . .           Expiration  . . . . . ***NONE***
      

      ...

    • If you typed A, in a row, the Allocate Dataset panel (CMNALCDS) is displayed.

      CMNALCDS                       Allocate Dataset 
      Command ===> _________________________________________________________
      
      Library type: CLS
      Dataset name: CMNTP.S7.V820.BASE.ACTP.CPY
      
      Management class . . . . ________   (Blank for default management class) 
      Storage class  . . . . . ________    (Blank for default storage class)
       Generic unit name . . . SYSDA      (Generic group name or unit) 
       Volume serial . . . . . SRSM31     (Required if Generic unit unspecified) 
      Data class . . . . . . . ________   (Blank for default data class) 
       Space units . . . . . . TRK        (Trk, cyl or blk) 
        Primary quantity . . . 4          (In above units) 
        Secondary quantity . . 2          (In above units) 
        Directory blocks . . . 4          (Must be greater than zero if PDS) 
        Record format  . . . . FB 
        Record length  . . . . 80
        Block size . . . . . . 0 
        Dataset type . . . . . PDS        (LIBRARY for PDSE, PDS, or blank) 
        Dataset version  . . . ________   (PDSE version) 
        Extended attributes  . ________   (NO, OPT or blank)
      

      ...