Summary: This document provides information about the extension providing Mainframe analysis support.
Please see Mainframe Analyzer - 1.0 - Release Notes for more information.
This extension provides support for Mainframe (Cobol, CICS, JCL, IMS...). If your application contains Mainframe source code and you want to view these object types and their links with other objects, then you should install this extension.
When installed, this extension replaces the Mainframe Analyzer embedded in CAST AIP Core:
- The Mainframe Analyzer embedded in AIP Core will continue to exist and will be shipped "out of the box" with AIP Core.
- Critical bugs will continue to be fixed in the Mainframe Analyzer embedded in AIP Core but no new features or functionality will be added.
- The Mainframe Analyzer extension will have exactly the same features and functionality on release as the Mainframe Analyzer embedded in AIP Core, therefore analysis results will be identical.
- The Mainframe Analyzer is compatible with AIP Core ≥ 8.3.26.
- All future development of the Mainframe Analyzer (new features, functionality etc.) will be completed in the Mainframe Analyzer extension only. Critical bug fixes will be fixed in the Mainframe Analyzer extension (as well as the analyzer embedded in AIP Core).
- The behaviour is as follows:
- Nothing is automatic - for both AIP Console and "legacy" CAST AIP deployments, the Mainframe Analyzer extension must be manually downloaded and installed in order to use it (* see note below)
- If the extension is installed, CAST AIP Console/CAST Management Studio will automatically detect that it exists and will use the extension rather than the analyzer embedded in AIP Core.
- Once the extension has been installed and used to produce analysis results, it is not possible to reverse this choice by removing the extension and re-analyzing the source code again.
Starting AIP Console 1.26, if Mainframe source code is detected by AIP Console during delivery, the Mainframe extension will automatically be downloaded and installed replacing the Mainframe Analyzer embedded in AIP Core. If you do not want this to occur, you must blacklist the Mainframe extension using the
aip-node-app.properties file on the AIP Node responsible for analyzing your application. See Blacklisting extensions for more information.
Features / support added in the extension
IBM MQ Series
The analyzer supports IBM MQSeries (see Mainframe - Technical notes), but the following support has been added in the extension:
- MQSeries objects are now supported via Batch and CICS environments (ex: CSQBOPEN, CSQCOPEN).
- MQSeries objects are now identified without the copybook CMQODV.
|A green tick indicates that OMG Function Point counting and Transaction Risk Index are supported.|
|Quality and Sizing||A green tick indicates that CAST can measure size and that a minimum set of Quality Rules exist.|
CAST AIP core release
Supported DBMS servers
This extension is compatible with the following DBMS servers:
|CAST Storage Service/PostgreSQL|
|An installation of any compatible release of CAST AIP core (see table above)|
Required third-party software
Please see: Mainframe - Required third-party software.
Dependencies with other extensions
The extension is shipped with a parameterization XML file called Parametrization_Cobol.xml file - see Mainframe - Analysis configuration for more information about this. This file takes priority over the same file delivered in AIP Core (in
Configuration\Parametrization\Cobol) therefore if you are moving to using the Mainframe Analyzer, you must ensure the following:
- You must copy the file (or the rules in file) from the AIP Core installation folder
Configuration\Parametrization\Cobolinto the deployed extension on your AIP Node(s):
If you upgrade to a newer release of the extension, and if you have modified the Parametrization_Cobol.xml file to add custom rules, you must ensure that you copy the file (or the rules) into the new extension installation location, e.g.:
- Current extension installation location:
- New extension installation location:
- Current extension installation location:
Download and installation instructions
Application qualification information
Please see: Mainframe - Application qualification specifics.
Prepare and deliver the source code
Please see: Mainframe - Prepare and deliver the source code.
Analysis configuration and execution
Please see: Mainframe - Analysis configuration and execution and all child pages:
What analysis results can you expect?
Please see: Mainframe - Analysis results.
Please see: Mainframe - Structural rules.