Running a load library scan

Edit online

The load library scan is a static scan that looks at all the programs in selected load modules, showing your full COBOL inventory across one or more load libraries. This topic explains the input fields required to run the load library scan.

Load library report

Required input fields

COBOL Upgrade Advisor install location
Data set name where the server component of CUAZ, CBUBE, is installed. Contact your system programmer if you need more details.
COBOL Upgrade Advisor output location
Data set name, including the member name, where the CUAZ output will be stored. The format is QUAL1.QUAL2.QUAL3(MEMBER).
You can allocate the data set using the recommended parameters listed in the following table:
Data set Recommended allocation parameters
hlq.CUAZOUT.OUTPUT

Space units: CYLS

Primary quantity: 5

Secondary quantity: 10

Directory blocks: 20

Record format: VB

Record length: 32756

Block size: 32760

Data set name type: Library

Advanced input fields

These input fields are automatically populated by CUAZ, and can be customized as necessary.
CUAZReportGenerator.py program path
The UNIX path to the CUAZReportGenerator.py Python program. The default SMP/E installed location is /usr/lpp/IBM/cbu/v1r1/pytools. Contact your system programmer if you need more details.
Python install location
The location of the Python executable that runs the script. The default SMP/E installed location is /usr/lpp/IBM/cyp/v3rXX/pyz/bin/Python3, where XX is the Python 3 version. Contact your system programmer if you need more details.
Job name
Name of the job to be submitted by the launcher. The default is USERID, where CUAZ replaces this with the USERID detected with your current account ID. The job name can be changed to follow a different naming scheme.
HLQ
Name of a temporary data set high-level qualifier. The default is USERID, where CUAZ replaces this with the USERID detected with your current account ID. The HLQ can be changed to follow a different naming scheme.

Select load libraries

Select which load libraries to include in the load library scan from the list of data sets.

This list shows:
  • Data set: The name of the data set

    This list is automatically populated with data sets under your HLQ. Use the search bar to find data sets under other HLQs. Ensure you have READ access to the selected load libraries.

    Note: The load library scan only requires READ access, but the application scan requires READ and EXECUTE access. This is important if you run both scans. To learn more about these permissions and how to change them, refer to Protecting a data set. To learn more about universal access, refer to Universal access authority (UACC) for data sets
  • Members: The total number of members in the data set
    Note: A member can be either a load module or a program object. Each member can be produced by statically linking together multiple CSECTs (referred to as programs). CUAZ only detects programs written in COBOL, even though they can be written in a number of other languages. This can cause a discrepancy between the number of members shown when selecting load libraries and the number of programs shown in the Load library or Application overview.

Load library summary

Verify that the load libraries specified for the scan are correct, and provide the output report name.

Optionally, select Edit JCL to modify the JCL before submitting the load library scan. Any changes that you make to the JCL apply only to the current scan.