Measure ChangeMan ZMF Customization Upgrade Progress
To measure the progress of upgrading all customizations during a ChangeMan ZMF upgrade project, we have created a ChangeMan ZMF report. It took us about 2 minutes to generate using our AbitMORE SCM Reporting solution.
Let's start with a little background info:
All customized components currently in production (used in a pre ZMF 8.x release like 7.1.x, 6.x or 5.x) are managed by a traditional CMN-on-CMN application. At the beginning of this upgrade project, we checked out all customized components into about five change packages (e.g.: the customizations related to housekeeping jobs are in a separate package, the vendor version of the new release was staged in a separated package, etc). Additionally, we entered scratch requests in these packages for any customized components that appeared to be obsolete. The more components we could scratch, the fewer we needed to upgrade.
To get an idea of the progress, we are not interested in the actual component names. Instead, we want to know the number of components for each type (such as SKL, JCL, REXX, etc.). Additionally, we want to understand their status in these packages. The status of each component falls into one of the following categories:
Checkout (= we've not done anything to upgrade it)
Active (= upgrade is completed, or no changes needed)
Scratch (= the customization has become obsolete)
Here is what the report looks like:
***************************** Top of Data ******************************
Date: 06/08/23 CMN/ZMF upgrade progress Time: 18:32:17
Cmp type: CTL Subtotal: 16
Cmp type: JCL Subtotal: 30
Cmp type: MSG Subtotal: 1
Cmp type: PNL Subtotal: 1
Cmp type: PRC Subtotal: 6
Cmp type: REX Subtotal: 7
Cmp type: SRC Subtotal: 3
Cmp type: TBL Subtotal: 1
Cmp status: ACTIVE Subtotal: 65
Cmp type: JCL Subtotal: 48
Cmp type: PNL Subtotal: 11
Cmp type: REX Subtotal: 41
Cmp type: SKL Subtotal: 110
Cmp type: SRC Subtotal: 3
Cmp status: CHECKOUT Subtotal: 213
Cmp type: JCL Subtotal: 2
Cmp type: PNL Subtotal: 14
Cmp type: REX Subtotal: 76
Cmp type: SKL Subtotal: 23
Cmp status: SCRATCH Subtotal: 115
Created using AbitMORE ® SCM Reporting 3.1.0 www.abitmore-scm.com
**************************** Bottom of Data *****************************
What the report indicates:
We currently have approximately 400 components to consider for this upgrade. Of these, 115 (over 25%) have already been confirmed as obsolete and can be scratched, providing an added benefit of not requiring similar upgrade efforts for future ZMF releases.
We have 65 components that are already marked as active, which is over 15%.
About 213 components (approximately 50% of the total) still need investigation (checkout) and potential upgrading to the new release.
We have opted for a traditional summary report on the mainframe where we are working on the upgrade within ChangeMan ZMF. However, we could have run the same report with the option to generate a CSV file and have it emailed to a manager as an attachment. This would allow the manager to open the file in their preferred spreadsheet application and view the data with charts and graphs, such as pie charts.
It’s also noteworthy that the data in the report are live and not extracted from a "cached" version of the ChangeMan ZMF metadata stored on a database server. Reports and graphs based on cached data are like using a GPS that shows your location from 24 hours ago. Additionally, generating the report is quick, taking only a matter of seconds.
Since a manager might want a daily updated version of the report, they can simply schedule our report generation job for automatic execution. If desired, they can also maintain versions of the CSV files on the mainframe in ChangeMan ZMF's well-known stacked reverse delta format.
Moreover, our AbitMORE SCM Commander solution is available to further facilitate this upgrade process. For example, it simplifies scanning all customized components by using an out-of-the-box solution to search for specific strings across all components in a package. This functionality is similar to ISPF 3.15, which scans multiple staging libraries in one go, but without the need to first look up all the staging DSNs in the package.
Update on the Report (About a Month Later):
We have completed (most of) the customization upgrades. Here’s the current status of the report:
***************************** Top of Data ****************************** Date: 06/09/23 CMN/ZMF upgrade progress (excl. DOCU) Time: 15:36:35 Cmp type: CLD Subtotal: 2 Cmp type: CLW Subtotal: 2 Cmp type: CTL Subtotal: 82 Cmp type: JCL Subtotal: 30 Cmp type: MSG Subtotal: 1 Cmp type: PNL Subtotal: 11 Cmp type: PRD Subtotal: 2 Cmp type: PRW Subtotal: 4 Cmp type: REX Subtotal: 43 Cmp type: SKL Subtotal: 118 Cmp type: SRB Subtotal: 6 Cmp type: TBL Subtotal: 1 Cmp status: ACTIVE Subtotal: 302 Cmp type: JCL Subtotal: 18 Cmp status: CHECKOUT Subtotal: 18 Cmp type: CTL Subtotal: 3 Cmp type: JCL Subtotal: 16 Cmp type: PNL Subtotal: 15 Cmp type: REX Subtotal: 77 Cmp type: SKL Subtotal: 33 Cmp status: SCRATCH Subtotal: 144 Created using AbitMORE ® SCM Reporting 3.1.0 www.abitmore-scm.com **************************** Bottom of Data *****************************
The only remaining task is to review, correct, and extend some of the ChangeMan ZMF housekeeping jobs related to the 18 JCLs still in checkout status.
