Crear y actualizar evaluaciones

En esta página, se describe cómo subir tus aplicaciones a Mainframe Assessment Tool y realizar una evaluación de los recursos que Mainframe Assessment Tool descubre en la base de código subida.

Puedes realizar un descubrimiento de recursos por tu cuenta o solicitar asistencia a un ingeniero de atención al cliente de Google.

Antes de comenzar

Para prepararte para la evaluación, asegúrate de haber completado los siguientes requisitos previos:

Sube los archivos de tu aplicación de mainframe a Mainframe Assessment Tool

Para subir los archivos de la aplicación a Mainframe Assessment Tool, sigue estos pasos:

  1. Crea un archivo ZIP que contenga todas las aplicaciones que deseas migrar.

    Mainframe Assessment Tool solo admite archivos ZIP con un tamaño máximo de 400 MB. Si el archivo ZIP de tu aplicación supera los 400 MB, considera dividirlo en archivos ZIP más pequeños según los dominios comerciales y sube un archivo ZIP para cada dominio.

    Si las aplicaciones contienen referencias a artefactos externos, como programas o tablas, te recomendamos que también incluyas estas dependencias. Si está disponible, proporciona el código fuente de los siguientes tipos:

    • Programas de COBOL (cob y cbl)
    • Copybooks de COBOL (inc y cpy)
    • Programas de Easytrieve (ezt)
    • Programas de HLASM (asm)
    • Trabajos de JCL (jcl)
    • Procedimientos de JCL (proc)
    • Incluye JCL
    • Datos de la tarjeta JCL (ctl)
    • Programas de PL/I (pli y pl1)
    • Programas de RPG/RPGLE (rpg y rpgle)
    • Incluye archivos de RPG/RPGLE (rpginc y rpgleinc)
    • Configuraciones del programador para BMC Control-M

    No incluyas archivos binarios ni otros archivos que no sean de origen en el archivo ZIP.

  2. Para subir el archivo ZIP a Mainframe Assessment Tool, sigue estos pasos:

    1. Para abrir Mainframe Assessment Tool en tu máquina local, abre una ventana del navegador web y ve a http://localhost:PORT.

      Reemplaza PORT por el número de puerto que usaste en tu máquina local para la conexión tunelizada a Mainframe Assessment Tool.

    2. En la página Principal, haz clic en Crear evaluación.

    3. En Nombre, ingresa un nombre.

    4. Opcional: En Descripción, ingresa una descripción para la evaluación.

    5. Para subir un archivo ZIP, haz clic en Seleccionar archivo. Se abrirá el navegador de archivos. Selecciona el archivo ZIP que deseas subir. Solo puedes subir un archivo a la vez.

    6. Haz clic en Siguiente.

  3. Para configurar estadísticas generadas por IA, sigue estos pasos:

    1. Para generar resúmenes a nivel de párrafo para el código COBOL, selecciona Resúmenes detallados. De forma predeterminada, esta opción está seleccionada.

    2. Para generar casos de prueba para las especificaciones de evaluación generadas por Gemini, selecciona Casos de prueba. De forma predeterminada, esta opción no está seleccionada.

    3. En Orientación de generación adicional, ingresa texto para agregar a las instrucciones de Gemini durante la generación de IA.

    4. Haz clic en Siguiente.

  4. Para configurar los modelos de Gemini y el nivel de calidad de la evaluación, configura el paso Modelo y calidad y, luego, haz clic en Siguiente.

    De forma predeterminada, Mainframe Assessment Tool usa el nivel de calidad Equilibrado recomendado. Para obtener más información sobre los niveles de calidad, elegir un modelo específico y conservar los datos en tu región, consulta Elige modelos y calidad.

  5. Opcional: Para agregar uno o más dominios que representen un área distinta de funcionalidad, haz clic en Agregar dominio.

    Los dominios te permiten filtrar y revisar los resultados en función de contextos específicos después de que se completa la evaluación.

  6. Haz clic en Siguiente.

  7. Haz clic en Crear evaluación.

Después de subir el archivo ZIP, Mainframe Assessment Tool descomprime y procesa el código fuente. En la página Evaluaciones , se muestra una entrada nueva en la tabla para cada recurso descubierto, que muestra su estado de evaluación.

  • Pendiente: La evaluación está esperando su turno.
  • En curso: El análisis está en curso.
  • Analizado: Se completó la evaluación.
  • Con errores: No se completó la evaluación.

Si ves errores después de importar el archivo, puedes revisar el mensaje de error directamente en Mainframe Assessment Tool.

Para ver más detalles sobre el progreso de la evaluación de un elemento, haz clic en el ID de referencia junto a él en la tabla. Se abrirá una página que muestra todos los pasos junto con el estado.

Elige modelos y calidad

Configura los modelos de Gemini para una evaluación durante la creación o la edición de una evaluación. Esta configuración solo se aplica a esa evaluación.

De forma predeterminada, Mainframe Assessment Tool optimiza los modelos para cada paso de evaluación según el nivel de calidad seleccionado. La herramienta enruta los pasos de razonamiento complejos a modelos más pesados y los pasos más simples a modelos más ligeros.

Selecciona un nivel de calidad

En Optimizar para, selecciona uno de los siguientes niveles de calidad:

  • Equilibrado (recomendado): Equilibra la velocidad y la profundidad para la mayoría de las evaluaciones. Este es el nivel predeterminado.
  • Rápido: Muestra los resultados más rápidos con modelos más ligeros.
  • Extendido: Maximiza la profundidad del análisis con modelos más pesados.

Cada nivel de calidad muestra los modelos de Gemini que se usan para cada paso.

Especifica un solo modelo

Para ejecutar todos los pasos de evaluación en un solo modelo en lugar de optimizar por nivel, selecciona Usar un modelo específico en su lugar y elige un modelo de la lista. Cada modelo se etiqueta como Disponibilidad general o Vista previa.

Mainframe Assessment Tool admite todas las zonas dentro de las regiones disponibles de Agent Platform.

Aplica la residencia de datos

De forma predeterminada, Mainframe Assessment Tool enruta las llamadas al modelo a la ubicación óptima para los modelos seleccionados, incluida la región de evaluación, una región múltiple o el extremo global de Agent Platform.

Para restringir las llamadas al modelo a la región de evaluación y a su región múltiple asociada, habilita Conservar los datos en mi región. Cuando se habilita esta configuración, Mainframe Assessment Tool realiza las siguientes acciones:

  • Inhabilita los niveles de calidad que requieren un modelo de Gemini que no está disponible en la región de evaluación. Estos niveles se etiquetan como No disponible en esta región.
  • Oculta los modelos de la lista de modelos específicos que no están disponibles en la región de evaluación.

Si no hay ningún modelo compatible disponible en la región de evaluación, la evaluación no se puede ejecutar con la opción Conservar los datos en mi región habilitada. Para continuar con la evaluación, inhabilita Conservar los datos en mi región para permitir las llamadas al modelo fuera de la región.

Agrega archivos a una evaluación existente

Después de crear una evaluación, puedes agregarle archivos ZIP adicionales. Los archivos del nuevo archivo ZIP se combinan con los archivos existentes en la evaluación. Si deseas reemplazar archivos existentes, el nuevo archivo ZIP debe incluir los archivos que reemplazas con la misma estructura de ruta de acceso.

Para agregar archivos a una evaluación existente, sigue estos pasos:

  1. Abre Mainframe Assessment Tool en un navegador web.
  2. En el menú de navegación, haz clic en Evaluaciones.
  3. En la página Evaluaciones, busca la evaluación que deseas modificar, y haz clic en Abrir evaluación.
  4. Haz clic en Agregar un archivo.
  5. Haz clic en Seleccionar archivo y elige el archivo ZIP que deseas subir. Solo puedes subir un archivo a la vez.
  6. Haz clic en Agregar.

Después de subir los archivos, Mainframe Assessment Tool vuelve a iniciar el análisis. Si reemplazas archivos, se vuelven a evaluar por completo, y es posible que cambie cualquier análisis existente para estos archivos. Durante el reprocesamiento, aparece un indicador Obsoleto junto a los archivos que se están reprocesando.

Actualiza los detalles y la configuración de la evaluación

Después de crear una evaluación, puedes actualizar su nombre y descripción, y modificar la configuración de las estadísticas generadas por IA.

Para actualizar los detalles o la configuración de la evaluación, sigue estos pasos:

  1. Abre Mainframe Assessment Tool en un navegador web.
  2. En el menú de navegación, haz clic en Evaluaciones.
  3. En la página Evaluaciones, busca la evaluación que deseas modificar, y haz clic en Abrir evaluación.
  4. Haz clic en settingsEditar la configuración de la evaluación.
  5. Opcional: En el paso Detalles de la evaluación , edita el nombre y la descripción y, luego, haz clic en Siguiente.
  6. Opcional: En el paso Configuración de IA , modifica la configuración de IA según sea necesario y, luego, haz clic en Siguiente.
  7. Opcional: En el paso Modelo y calidad , configura los modelos o el nivel de calidad y, luego, haz clic en Siguiente. Para obtener más información, consulta Elige modelos y calidad.
  8. En el paso Dominios, haz clic en Siguiente. No puedes editar dominios después de crear una evaluación.
  9. Haz clic en Actualizar evaluación.

Después de actualizar la configuración, Mainframe Assessment Tool vuelve a iniciar el análisis.

¿Qué sigue?