Skip to content

Sample Audit Report Program CMNRARPT

Serena provides sample program CMNRARPT that formats audit information from the area audit Db2 tables into a report that looks similar to the package audit report produced by the base ChangeMan ZMF product.

CMNRARPT performs no analysis of component relationships; all relationship analysis is performed by release area audit program CMNRA000 before the Db2 tables are loaded.

Program CMNRARPT is written in COBOL so you can modify it to display area audit information in any format you want. You may include additional data from the area audit Db2 tables. For information about area audit Db2 tables, see Appendix A.

You may also call Serena XML Services from the reporting program to incorporate additional information in the audit report. See the ChangeMan ZMF XML Services Getting Started Guide.

The release audit report produced by sample program CMNRARPT includes these sections.

  • Directory information for non-load components

  • Directory information for load components

  • Copybook within Source

  • NCAL Loads within composite loads

  • Object components within composite loads

  • Summary

  • Recommendations

An example of the report produced by CMNRARPT follows.

...

        Change Man  Release Audit Report     Thursday April 21,2016      (2016/112) 02:41:58                                     PAGE: 1
                    ***********************************(Release Area Processing)************************************
                    *Release Identifier      ===> R4000110 Created: 20160212 Release Install Date ===> 20160214    *
                    *Area Identifier         ===> START Area Status                               ===> UNBLOCKED   *
                    *Component analysis type ===> Description of Member from Directory Entry for Lib Type-(LST)    *
************************************************************************************************************************************
*------------- P r e v i o u s  V e r s i o n -------------*            *------------------ A r e a  L i b r a r y ----------------*
************************************************************            ************************************************************
    Name   Build  Area     Changed       Release     Tso-id                Name   Build Appl/Pkg#     Changed     Size VV.MM Tso-ID
________ ____ ________  ________________ ________ ________              ________ ____ __________ ________________ ____ _____ ________
SMITHIES                2016-02-17 06.55            SERS                SMITHIES        DEMO003359 2016-02-18 09.17 535 02.01 SNEVIN
       Change Man   Release Audit Report      Thursday April          21,2016 (2016/112) 02:41:58                         PAGE: 2
                    ***********************************(Release Area Processing)************************************
                    *Release Identifier      ===> R4000110 Created: 20160212 Release Install Date ===> 20160214    *
                    *Area Identifier         ===> START Area Status                               ===> UNBLOCKED   *
                    *Component analysis type ===> Description of Member from Directory Entry for Lib Type-(SRC)    *
************************************************************************************************************************************
*------------- P r e v i o u s  V e r s i o n -------------*            *------------------ A r e a  L i b r a r y ----------------*
************************************************************            ************************************************************
    Name    Build Area      Changed     Release     Tso-id                 Name   Build Appl/Pkg#     Changed     Size VV.MM Tso-ID
________ ____ ________ ________________ ________ ________               ________ ____ __________ ________________ ____ _____ ________
SMITHIES                2016-02-17 06.54            SNEVIN              SMITHIES        DEMO003359 2016-02-18 09.17     7 02.01 SNEVIN
    Change Man Release Audit Report         Thursday April            21,2016 (2016/112) 02:41:58                         PAGE: 3
                    ***********************************(Release Area Processing)************************************
                    *Release Identifier      ===> R4000110 Created: 20160212 Release Install Date ===> 20160214    *
                    *Area Identifier         ===> START Area Status                               ===> UNBLOCKED   *
                    *Component analysis type ===> Description of Member from Directory Entry for Lib Type-(LOD)    *
************************************************************************************************************************************
*------------- V e r s i o n  L i b r a r y --------------*              *----------------- A r e a  L i b r a r y ----------------*
*************************************************************            ***********************************************************
    Name     Size    Linkdate   Setssi  Build  Area   Release                 Name    Appl/Pkg#   Build   Size   Linkdate  Setssi  AC
  ________ ________ __________ ________ ____ ________ ________             ________ __________ ____ ________ __________ ________ __
  SMITHIES  00000003 2016-02-17 699410C1 ERR0315! SMITHIES DEMO003359 32 2016-02-18 699583A4 00
    Change Man Release Audit Report         Thursday April            21,2016 (2016/112) 02:41:58                         PAGE: 4
                    ***********************************(Release Area Processing)************************************
                    *Release Identifier      ===> R4000110 Created: 20160212 Release Install Date ===> 20160214    *
                    *Area Identifier         ===> START Area Status                               ===> UNBLOCKED   *
                    *Component analysis type ===> Copybook (CPY) Members within Source (SRC) Code                  *

...

************************************************************************************************************************************
*------------- V e r s i o n  L i b r a r y --------------*              *----------------- A r e a  L i b r a r y ----------------*
*************************************************************           ************************************************************
Copybook                                                        Source  Copybook   Lib
  Name   Build Area         Changed     Release   Tso-id        Name     Name      Type  Build  Appl/Pkg#      Changed       Tso-id
________ ____ ________ ________________ ________ ________       ________ ________  ____  ____   __________ ________________ ________
NO COPS RECORDS FOUND
    Change Man Release Audit Report         Thursday April      21,2016     (2016/112) 02:41:58                           PAGE: 5
               ***********************************(Release Area Processing)************************************
               *Release Identifier      ===> R4000110 Created: 20160212   Release Install Date ===> 20160214  *
               *Area Identifier         ===> START                        Area Status          ===> UNBLOCKED *
               *Component analysis type ===> NCAL (NCL) Loads within Composite Load Module (LOD)              *
************************************************************************************************************************************
*------------- V e r s i o n  L i b r a r y --------------*             *----------------- A r e a  L i b r a r y -----------------*
*************************************************************           ************************************************************
  Called  Module                                              Calling  Called   Lib
  Module   Size    Linkdate    Setssi Build Area    Release   Module   Module   Type Appl/Pkg#  Build Size     Linkdate   Setssi
________ ________ __________ ________ ____ ________ ________  ________ ________ ____ __________ ____ ________ __________ ________
               32 2016-02-17 699410C1                         SMITHIES          LOD  DEMO003359            32 2016-02-18 699583A4
INGRAM          8 2016-02-22 699A8958                         ERR0315!
LUMLEY          8 2016-02-22 699A9EBF                         ERR0315!
        Change Man Release Audit Report     Thursday April        21,2016   (2016/112) 02:41:58                           PAGE: 6
                  ***********************************(Release Area Processing)*************************************
                  *Release Identifier      ===> R4000110 Created: 20160212    Release Install Date ===> 20160214  *
                  *Area Identifier         ===> START                         Area Status          ===> UNBLOCKED *
                  *Component analysis type ===> Object (OBJ) Components within Composite Load Module (LOD)        *
************************************************************************************************************************************
*------------- V e r s i o n   L i b r a r y --------------*            *----------------- A r e a  L i b r a r y -----------------*
*************************************************************           ************************************************************
Object           Changed Date Module                          Calling  Object  Lib                          Changed date Module
Name     Size     /Linkdate   Setssi  Build  Area   Release   Module   Name    Type Appl/Pkg#  Build  Size   /Linkdate   Setssi
________ ________ __________ ________ ____ ________ ________ ________ ________ ____ __________ ____ ________ __________ ________
NO COBJ RECORDS FOUND
        Change Man Release Audit Report   Thursday April    21,2016   (2016/112) 02:41:58                                       PAGE: 7
                  ***********************************(Release Area Processing)*************************************
                  *Release Identifier      ===> R4000110 Created: 20160212    Release Install Date ===> 20160214  *
                  *Area Identifier         ===> START Area Status                                  ===> UNBLOCKED *
                  *Component analysis type ===> LCT Components which generate named executables                   *
************************************************************************************************************************************
*------------- V e r s i o n   L i b r a r y --------------*            *----------------- A r e a  L i b r a r y -----------------*
*************************************************************           ************************************************************
Target    Module  Change/                                     LCT      Target  Lib                           Change/
Module     Size   Linkdate    Setssi  Build  Area   Release  Cmponent  Module  Type Appl/Pkg#  Build  Size   Linkdate   Setssi
________ ________ __________ ________ ____ ________ ________ ________ ________ ____ __________ ____ ________ __________ ________
NO CLCT RECORDS FOUND
        Change Man Release Audit Report   Thursday April    21,2016   (2016/112) 02:41:58                                       PAGE: 8

                  ***************************(Release Area Processing - HFS Components)***************************
                  *Release Identifier      ===> R4000110 Created: 20160212    Release Install Date ===> 20160214  *
                  *Area Identifier         ===> START Area Status                                  ===> UNBLOCKED *
                  *Component analysis type ===> Description of Member from Directory Entry for Lib Type-(SRC)     *
************************************************************************************************************************************
*------------- V e r s i o n   L i b r a r y --------------*            *----------------- A r e a  L i b r a r y -----------------*
*************************************************************           ************************************************************
Component Name
                  Release    Area     Changed             ID            Appl/Pkg#     Changed           Size        ID
                  ________ ________ ___________________ ________        __________ ___________________ _________ ________
NO DIRSRC HFS RECORDS FOUND
        Change Man Release Audit Report   Thursday April    21,2016   (2016/112) 02:41:58                                       PAGE: 9
                   ***************************(Release Area Processing - HFS Components)***************************
                   *Release Identifier      ===> R4000110 Created: 20160212   Release Install Date ===> 20160214  *
                   *Area Identifier         ===> START Area Status                                 ===> UNBLOCKED *
                   *Component analysis type ===> Description of Member from Directory Entry for Lib Type-(LOD)    *
************************************************************************************************************************************
*------------- P r e v i o u s  V e r s i o n --------------*           *----------------- A r e a  L i b r a r y -----------------*
*************************************************************           ************************************************************
Component Name
          Timestamp       Size      Release   Area                                 Appl/Pkg#      Timestamp         Size
    ___________________ _________   _______  _______                              __________  ___________________ _________
NO DIRLOD HFS RECORDS FOUND
        Change Man Release Audit Report   Thursday April    21,2016   (2016/112) 02:41:58                                       PAGE: 10
                   ***************************(Release Area Processing - HFS Components)***************************
                   *Release Identifier      ===> R4000110 Created: 20160212   Release Install Date ===> 20160214  *
                   *Area Identifier         ===> START Area Status                                 ===> UNBLOCKED *
                   *Subcomponent relationships to libtype-(HFS)                                                   *
************************************************************************************************************************************
*------------- P r e v i o u s  V e r s i o n --------------*           *----------------- A r e a  L i b r a r y -----------------*
*************************************************************           ************************************************************
>>Component Name -> Subordinate Name
          Timestamp       Size        Area   Release                     Libtype    Appl/Pkg#      Timestamp         Size
    ___________________ _________   _______  _______                     _______    __________  ___________________ _________
NO CLOD HFS RECORDS FOUND
        Change Man Release Audit Report   Thursday April    21,2016   (2016/112) 02:41:58                                       PAGE: 11
                                              Legend and Summary Report
The area level of audit chosen at this point is 0 -
    Audit is recommended but entirely optional.
Error Conditions Detected:
    ERR0315! (BASELINE SUB-CMPNT HAS A MORE RECENT DATE THAN COMPOSITE)        ===> 0002
Highest return code encountered               ===> 8
Area START    passed the Audit with a return code of   8.
        Change Man Release Audit Report   Thursday April    21,2016   (2016/112) 02:41:58                                       PAGE: 12
                                              Recommendation Summary Report
Listed below are some solutions to resolving error situations that have
been detected within this audit report.

    ERR0315! THE FIRST SUB-COMPONENT (SUBRTN) FOUND IN THE RELEASE
      AREA/BASELINE SEARCH CONCATENATION IS IN BASELINE. IT HAS A CHANGE DATE WHICH
      IS LATER THAN THE COMPOSITE COMPONENT IN THE AUDITED AREA.
      REBUILD THE COMPOSITE IN THE AUDITED AREA TO INCLUDE THE UPDATED SUB-COMPONENT
      FROM BASELINE.

    End of job; RC = 08
Audit Report produced by CMNRARPT dated 07/08/14 07.32.02
******************************* BOTTOM OF DATA *********************************************************************************