Configure settings

This page describes how you can configure Mainframe Assessment Tool and the AI models it uses for the assessment.

Configure general settings

To configure general settings for your assessment, follow these steps:

  1. Click the settingsSettings icon.

  2. To edit your preferences for Cloud Logging and Google Analytics, in the General settings section, do the following:

    • To enable Logging, click Enable Cloud Logging.

      By default, Cloud Logging is disabled. Using Cloud Logging might incur additional costs. For more information, see Cloud Logging documentation.

    • To enable Google Analytics, click Enable Google Analytics.

      By default, Google Analytics is enabled. Changes to this setting only take effect after you reload the page.

  3. For Vertex AI project, enter the name for the Google Cloud project ID that you want to use for your assessment.

    To use the Google Cloud project where you created your Mainframe Assessment Tool VM, leave this field blank.

  4. Optional: For Model, select a Gemini AI model.

    By default, Mainframe Assessment Tool uses either Gemini 2.0 Flash-Lite and Gemini 2.0 Flash, with Gemini 2.0 Flash used adaptively to optimize performance. You can configure Mainframe Assessment Tool to use a different model from the following available options:

    • Gemini 1.5 Flash
    • Gemini 1.5 Pro
    • Gemini 2.0 Flash
    • Gemini 2.0 Flash-Lite
    • Gemini 2.5 Pro (Experimental)

    If you run large assessments and change the default model, we recommend that you increase the quota for that model to help ensure faster assessment completion. To adjust quotas, use the Google Cloud console. For more information, see Request a quota adjustment.

    Mainframe Assessment Tool supports all zones in all the Vertex AI regions.

  5. To control the creativity of the model's output, select Custom temperature and set a value between 0.0 and 1.0.

    By default, Mainframe Assessment Tool uses a value of 0.1. For more information, see Model parameters.

  6. Click Save settings.

Configure AI features in new assessments

Mainframe Assessment Tool lets you customize the default parameters for AI insights in your assessments. By default, AI insights are enabled.

To configure AI features in new assessments, follow these steps:

  1. Click the settingsSettings icon.

  2. To generate paragraph-level summaries for COBOL code, select Detailed summaries.

    By default, this option is selected when AI analysis is enabled.

  3. To generate test cases for the assessment specifications generated by Gemini, select Test cases.

    By default, this option is not selected when AI analysis is enabled.

  4. To generate output code samples suggesting translation from mainframe languages to Python, Java, C#, and SQL, select Code suggestions.

  5. For Tech stack hints, enter text that helps Gemini generate code for a specific tech stack. For example, enter Spring Boot and MySQL.

  6. Click Save settings.

Optional: Perform additional actions

This section describes how to perform additional actions, such as clearing the Gemini cache and verifying connectivity to Gemini.

To perform additional actions, follow these steps:

  1. Click the settingsSettings icon.

  2. To test your connectivity from Mainframe Assessment Tool to Google Cloud services, click Verify connectivity.

    If the connection is successful, you see a message similar to the following: Connectivity success.

  3. To clear the Gemini cache, click Clear model cache.

  4. To download your Mainframe Assessment Tool logs, click Download support bundle.

    The support bundle contains the Mainframe Assessment Tool logs as a zip file, which you can share with Google Cloud support to troubleshoot issues.

Disable AI insights for assessments

Disabling AI analysis prevents AI insights from appearing on the Assessments page.

To disable AI analysis for assessments, follow these steps:

  1. In the Default AI features in new assessments section, clear Enable AI insights.

  2. Click Save settings.

What's next