Verifying the installation using the Installation Verification Program (IVP)

After you complete the SMP/E installation of CUAZ, use the CUAZ Installation Verification Program (IVP), CBUIVPJ, to verify that the CUAZ host component is installed correctly and functional.

Overview

The CUAZ IVP, CBUIVPJ, is located in the CUAZ sample library HLQ.SBOZJCL, where HLQ is the prefix used for the target libraries in your CUAZ SMP/E installation.

Run the IVP on any system on which you plan to use CUAZ.

Using CBUIVPJ

To proceed with the IVP process on the selected system, edit CBUIVPJ according to the included JCL description, then submit it.

This job contains the following steps:
  1. CLEAN1: Deletes IVP-related data sets potentially allocated by a previous IVP job run
  2. PRECMD1: Allocates IVP-related data sets prefixed with the IVP user ID
  3. LKED1: Link-edits the COBOL program HLQ.SCBUJCL(CBUOBJ1) supplied in the sample library into the CBUPGM1 module
  4. GO1: Runs the CBUPGM1 program
  5. VERIFY1: Verifies the z/OS version eligibility for running IBM COBOL Upgrade Advisor for z/OS®
  6. GO2: Runs the CBUPGM1 program along with the profiler
  7. CUA1: Analyzes the results of the COBOL program run
  8. RUNPY1: Generates CUAZ report using the Python script provided
  9. VERIFY2: Verifies the IBM Z server type eligibility for running IBM COBOL Upgrade Advisor for z/OS®
  10. REPORT: Reports the IVP results

You will receive a return code of 0 for each of the preceding steps when the IVP runs successfully. After the REPORT step completes, a report is available in the SYSTSRPT output file and in the JESMSGLG JOBLOG.

The following example shows a sample JESMSGLG JOBLOG. Note that the Installation verification successful! message is present in both the JOBLOG and in the console.
JOB08295  HTRT01I                                         CPU (Total)  
JOB08295  HTRT02I Jobname  Stepname ProcStep    RC    I/O hh:mm:ss.th  
JOB08295  HTRT03I CBUIVPJ  CLEAN1               00      7       00.00  
JOB08295  HTRT03I CBUIVPJ  PRECMD1              00     36       00.00  
JOB08295  HTRT03I CBUIVPJ  LKED1                00    235       00.01  
JOB08295  HTRT03I CBUIVPJ  GO1                  00    408       00.07  
JOB08295  HTRT03I CBUIVPJ  VERIFY1              00     44       00.00  
JOB08295  HTRT03I CBUIVPJ  GO2                  00    791       00.09  
JOB08295  HTRT03I CBUIVPJ  CUA1                 00  21604       00.03  
JOB08295  HTRT03I CBUIVPJ  RUNPY1               00     98       00.00  
JOB08295  HTRT03I CBUIVPJ  VERIFY2              00     44       00.00  
JOB08295  +***     Installation verification successful!   *** USERID
JOB08295  HTRT03I CBUIVPJ  REPORT               00     58       00.00
Note: After a successful IVP program run, additional output files can be found in the following data sets generated under your user ID:
  • userid.CUA.IVP.SYSPROFD: Contains the profiling report
  • userid.CUA.IVP.OUTPUT(CBUPGM1): Contains the CUAZ IVP report output

Error handling

If the VERIFY1 step fails, the following message displays in both the JOBLOG and in the console:
z/OS version: xx.xx is not a supported z/OS version to run IBM COBOL Upgrade Advisor for z/OS.
If the VERIFY2 step fails, the following message displays in both the JOBLOG and in the console:
IBM z server: 2817 (zEnterprise 196) is not a supported hardware level to run IBM COBOL Upgrade Advisor for z/OS.
If the CUA1 step has a return code of 4, the following message displays in CBULOG:
CBU5051W: Profile read but contained zero total samples. Analysis will proceed without using performance information.
This is an indication that the following Language Environment PTFs need to be installed:
  • z/OS 2.5: UI99295
  • z/OS 3.1: UI99296

Install the required PTFs and then run the CBUIVPJ job again.