Run discovery and assessment

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Using Mainframe Assessment Tool, you can assess mainframe applications implemented in different languages, and gather detailed information about every component. You can perform an asset discovery on your own, or request for assistance from a Google customer engineer.

This document describes how to upload applications to Mainframe Assessment Tool and perform an assessment of the assets that Mainframe Assessment Tool discovers in the uploaded codebase.

Before you begin

• Complete the steps to create a Mainframe Assessment Tool VM.
• If you want to use the experimental AI assessment capabilities, do the following:
  • On the Settings page, select Enable AI Analysis.
  • Make sure that Mainframe Assessment Tool has access to the necessary Google Cloud services by clicking Verify Connectivity.
  • Optional: Customize advanced AI configuration such as the model and the level of the generated details.

Upload applications to Mainframe Assessment Tool

1. To upload the applications to Mainframe Assessment Tool, first create a zip file containing all the applications that you want to migrate.

   Note: Mainframe Assessment Tool supports Pkzip files only.

   If the applications contain references to external artifacts such as programs or tables, it is recommended that you include these dependencies as well. If available, provide the source code of the following types:

   • COBOL programs (cob and cbl)
   • COBOL copybooks (inc and cpy)
   • Easytrieve programs (ezt)
   • HLASM programs (asm)
   • JCL jobs (jcl)
   • JCL procedures (proc)
   • JCL includes
   • JCL card data (ctl)

   You must not include binaries and other non-source files in the zip file.

2. To upload the zip file to Mainframe Assessment Tool, follow these steps:

   1. To open Mainframe Assessment Tool on your local machine, open a web browser window and go to http://localhost:PORT.

      Replace PORT with the port number you used on your local machine for the tunneled connection to the Mainframe Assessment Tool.

   2. Click Create assessment.

   3. Enter a new reference ID.

   4. Optional: add a Description.

   5. Click Upload file. The Open file dialog appears.

      Note: The size of the zip file must not exceed 50 MB. If your file is larger than 50 MB, then consider splitting the file into smaller files and upload them as separate assessments.

   6. Select the zip file that you created, and then click Select.

   7. To start the discovery and assessment, click Run Discovery.

Review discovery and assessment progress

After you've uploaded the zip file, Mainframe Assessment Tool unpacks it and starts processing the source code to create new assets. In the table on the Home page, a new entry is created that shows the assessment status for each discovered asset. These statuses are as follows:

• Pending. The step is waiting its turn.
• In Progress. The step is in progress.
• Completed. The step has been completed.
• Failed. The step didn't complete.

If you see errors after importing your file, you can review the error message directly in Mainframe Assessment Tool.

To view more details about the assessment progress for an item, click the reference ID next to it in the table. This opens a page that shows all the steps together with the status.

What's next

• Learn how to review the assessment results.