Host-based code review on z/OS

Host-based code review provides a sample procedure, AKGCR, that you can customize and submit to run code review in batch mode on z/OS. AKGCR is located in AKG.#CUST.PROCLIB, unless your systems programmer specified a different location during the setup job. If it is not in this location, check with the z/OS systems programmer who configured the Developer for z/OS® server. For more information about the configuration of host-based code review, see Host-based code analysis.
Host-based code review runs with input parameters that specify the locations of source code, the set of rules to use in the analysis, the location of analysis results, and various other configuration settings. In the input parameters, you can specify:
  • The source code to review. It can analyze either COBOL or PL/I, or both in the same procedure call. You can specify data sets to be searched for copybooks or include files.
  • The rule sets to use for the review. It can accept the same rule sets as the ones you might be using in the Eclipse client, as well as the same built-in rules, CICS® and SQL language extension rules, and custom rules. You can reuse your user-written rule plug-ins without alterations. (However, calls from user-written rules to Eclipse graphical user interface methods are not supported.)
  • Software analysis configurations and baseline analysis configurations to use for the review.
  • The location of the output data files it generates.
The input parameters and other features are described in the comments in the AKGCR procedure. Some of the input parameters, such as rule sets and custom rules, must be defined in data files that you create and upload to the z/OS UNIX System Services file system where the code review application runs. For information about the data files, see Creating and uploading data files.

Running host-based code review

You run the z/OS code review application by calling the AKGCR JCL start procedure that passes the input parameters to the AKGCRX REXX program. This program checks the input parameters and does other preprocessing. It then calls a shell script that starts the code review application itself. The code review application is a Java™ application that runs on non-GUI Eclipse (headless Eclipse) for z/OS.

You can integrate the AKGCR procedure into your existing batch processes. You can run multiple instances of the AKGCR procedure at the same time.