Stay organized with collectionsSave and categorize content based on your preferences.
This page describes how to upload your applications to Mainframe Assessment Tool
and perform an assessment of the assets that Mainframe Assessment Tool
discovers in the uploaded codebase.
You can perform an asset discovery on your own, or request for
assistance from a Google customer engineer.
Before you begin
To prepare for your assessment, make sure that you have completed the following
prerequisites:
Upload your mainframe application files to Mainframe Assessment Tool
To upload the application files to Mainframe Assessment Tool, follow these steps:
Create a zip file containing all the applications that you want to
migrate.
Mainframe Assessment Tool supports only zip files with a maximum size of 400 MB.
If your application zip file is larger than 400 MB, then consider splitting
the file into smaller zip files based on business domains and upload a
zip file for each domain.
If the applications contain references to external artifacts such as
programs or tables, we recommend that you include these dependencies as
well. If available, provide the source code of the following types:
COBOL programs (cobandcbl)
COBOL copybooks (incandcpy)
Easytrieve programs (ezt)
HLASM programs (asm)
JCL jobs (jcl)
JCL procedures (proc)
JCL includes
JCL card data (ctl)
PL/I programs (pliandpl1)
RPG/RPGLE programs (rpgandrpgle)
RPG/RPGLE include files (rpgincandrpgleinc)
Don't include binaries and other non-source files in the zip file.
To upload the zip file to Mainframe Assessment Tool, follow these steps:
To open Mainframe Assessment Tool on your local machine, open a web
browser window and go tohttp://localhost:PORT.
ReplacePORTwith the port number you used on
your local machine for the tunneled connection to the Mainframe Assessment Tool.
On theHomepage, clickCreate assessment.
For name, enter a name.
Optional: For Description, enter a description for the assessment.
To upload a zip file, clickSelect file. The file browser opens. Select
a zip file that you want to upload. You can upload only one file at a time.
ClickNext.
To configure AI-generated insights, follow these steps:
To generate paragraph-level summaries for COBOL code, selectDetailed summaries. By default, this option is selected.
To generate test cases for the assessment specifications generated by
Gemini, selectTest cases. By default, this option
is not selected.
To generate code samples that translate mainframe languages to Python,
Java, C#, and SQL, selectCode suggestions. By default, this option
is not selected.
ForTech stack hints, enter text that helps
Gemini generate code for a specific tech stack. For example,
enterSpring Boot and MySQL.
ClickNext.
Optional: To add one or more domains that represent a distinct area of
functionality, clickAdd domain.
This information is used for automated assignment, and lets you filter
and review results based on specific contexts after the assessment is
complete.
ClickNext.
ClickCreate assessment.
After you upload the zip file, Mainframe Assessment Tool unpacks and processes
the source code. TheAssessmentspage displays a new entry in the table
for each discovered asset, showing its assessment status.
Pending:assessment is waiting its turn.
In Progress:analysis is in progress.
Analyzed:assessment has been completed.
Failed:the assessment 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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Create an assessment\n\nThis page describes how to upload your applications to Mainframe Assessment Tool\nand perform an assessment of the assets that Mainframe Assessment Tool\ndiscovers in the uploaded codebase.\n\nYou can perform an asset discovery on your own, or request for\nassistance from a Google customer engineer.\n\nBefore you begin\n----------------\n\nTo prepare for your assessment, make sure that you have completed the following\nprerequisites:\n\n- [Configure your Google Cloud project for Mainframe Assessment Tool](/mainframe-assessment-tool/docs/configure-your-project)\n- [Set up and access Mainframe Assessment Tool](/mainframe-assessment-tool/docs/create-vm)\n\nUpload your mainframe application files to Mainframe Assessment Tool\n--------------------------------------------------------------------\n\nTo upload the application files to Mainframe Assessment Tool, follow these steps:\n\n1. Create a zip file containing all the applications that you want to\n migrate.\n\n Mainframe Assessment Tool supports only zip files with a maximum size of 400 MB.\n If your application zip file is larger than 400 MB, then consider splitting\n the file into smaller zip files based on business domains and upload a\n zip file for each domain.\n\n If the applications contain references to external artifacts such as\n programs or tables, we recommend that you include these dependencies as\n well. If available, provide the source code of the following types:\n - COBOL programs (`cob` and `cbl`)\n - COBOL copybooks (`inc` and `cpy`)\n - Easytrieve programs (`ezt`)\n - HLASM programs (`asm`)\n - JCL jobs (`jcl`)\n - JCL procedures (`proc`)\n - JCL includes\n - JCL card data (`ctl`)\n - PL/I programs (`pli` and `pl1`)\n - RPG/RPGLE programs (`rpg` and `rpgle`)\n - RPG/RPGLE include files (`rpginc` and `rpgleinc`)\n\n Don't include binaries and other non-source files in the zip file.\n2. To upload the zip file to Mainframe Assessment Tool, follow these steps:\n\n 1. To open Mainframe Assessment Tool on your local machine, open a web\n browser window and go to `http://localhost:`\u003cvar translate=\"no\"\u003ePORT\u003c/var\u003e.\n\n Replace \u003cvar translate=\"no\"\u003ePORT\u003c/var\u003e with the port number you used on\n your local machine for the tunneled connection to the Mainframe Assessment Tool.\n 2. On the **Home** page, click **Create assessment**.\n\n 3. For name, enter a name.\n\n 4. Optional: For Description, enter a description for the assessment.\n\n 5. To upload a zip file, click **Select file**. The file browser opens. Select\n a zip file that you want to upload. You can upload only one file at a time.\n\n 6. Click **Next**.\n\n3. To configure AI-generated insights, follow these steps:\n\n 1. To generate paragraph-level summaries for COBOL code, select\n **Detailed summaries**. By default, this option is selected.\n\n 2. To generate test cases for the assessment specifications generated by\n Gemini, select **Test cases**. By default, this option\n is not selected.\n\n 3. To generate code samples that translate mainframe languages to Python,\n Java, C#, and SQL, select **Code suggestions**. By default, this option\n is not selected.\n\n 4. For **Tech stack hints** , enter text that helps\n Gemini generate code for a specific tech stack. For example,\n enter `Spring Boot and MySQL`.\n\n 5. Click **Next**.\n\n4. Optional: To add one or more domains that represent a distinct area of\n functionality, click **Add domain**.\n\n This information is used for automated assignment, and lets you filter\n and review results based on specific contexts after the assessment is\n complete.\n5. Click **Next**.\n\n6. Click **Create assessment**.\n\nAfter you upload the zip file, Mainframe Assessment Tool unpacks and processes\nthe source code. The **Assessments** page displays a new entry in the table\nfor each discovered asset, showing its assessment status.\n\n- **Pending:** assessment is waiting its turn.\n- **In Progress:** analysis is in progress.\n- **Analyzed:** assessment has been completed.\n- **Failed:** the assessment didn't complete.\n\nIf you see errors after importing your file, you can review the error message\ndirectly in Mainframe Assessment Tool.\n\nTo view more details about the assessment progress for an item, click the\nreference ID next to it in the table. This opens a page that shows all the\nsteps together with the status.\n\nWhat's next\n-----------\n\n- Learn how to [view and understand assessment results](/mainframe-assessment-tool/docs/review-results)."]]
