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 descubre en la base de código subida.

Puedes realizar el descubrimiento de activos 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 unidad central a la Mainframe Assessment Tool

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

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

    La herramienta 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 COBOL (cob y cbl)
    • Libros de copias de COBOL (inc y cpy)
    • Programas de Easytrieve (ezt)
    • Programas en HLASM (asm)
    • Trabajos de JCL (jcl)
    • Procedimientos JCL (proc)
    • La JCL incluye
    • Datos de la tarjeta JCL (ctl)
    • Programas en PL/I (pli y pl1)
    • Programas RPG/RPGLE (rpg y rpgle)
    • Archivos de inclusión de RPG/RPGLE (rpginc y rpgleinc)
    • Configuraciones del programador para BMC Control-M

    No incluyas archivos binarios ni otros archivos que no sean de código fuente 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 a través de túnel a la herramienta de Mainframe Assessment.

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

    3. En el 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 un archivo ZIP que quieras subir. Solo puedes subir un archivo a la vez.

    6. Haz clic en Siguiente.

  3. Para configurar las 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 que genera Gemini, selecciona Casos de prueba. De forma predeterminada, esta opción no está seleccionada.

    3. Para generar muestras de código que traduzcan lenguajes de mainframe a Python, Java, C# y SQL, selecciona Sugerencias de código. De forma predeterminada, esta opción no está seleccionada.

    4. En Sugerencias de pila de tecnología, ingresa texto que ayude a Gemini a generar código para una pila tecnológica específica. Por ejemplo, ingresa Spring Boot and MySQL.

    5. 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, cómo elegir un modelo específico y cómo mantener 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 según 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, la Mainframe Assessment Tool lo descomprime y procesa el código fuente. En la página Assessments, se muestra una entrada nueva en la tabla para cada recurso descubierto, en la que se indica 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 la Herramienta de evaluación de Mainframe.

Para ver más detalles sobre el progreso de la evaluación de un elemento, haz clic en el ID de referencia que se encuentra 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. Estos parámetros de configuración solo se aplican a esa evaluación.

De forma predeterminada, la Mainframe Assessment Tool optimiza los modelos para cada paso de la 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: Devuelve los resultados más rápidos con modelos más ligeros.
  • Extendido: Maximiza la profundidad del análisis con modelos más pesados.

En cada nivel de calidad, se indican los modelos de Gemini que se usan en cada paso.

Cómo especificar un solo modelo

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

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

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 Keep data in my region. Cuando este parámetro de configuración está habilitado, la 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 Keep data in my region habilitada. Para continuar con la evaluación, inhabilita Keep data in my region para permitir llamadas al modelo fuera de la región.

Cómo agregar 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 reemplazarás con la misma estructura de ruta de acceso.

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

  1. Abre la 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 que subas los archivos, Mainframe Assessment Tool volverá a iniciar el análisis. Si reemplazas archivos, se volverán a evaluar por completo, y es posible que cambie el análisis existente para estos archivos. Durante el nuevo procesamiento, aparece un indicador de Obsoleto junto a los archivos que se están volviendo a procesar.

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 una evaluación, sigue estos pasos:

  1. Abre la 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 ConfiguraciónEditar 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 Cómo elegir modelos y calidad.
  8. En el paso Dominios, haz clic en Siguiente. No puedes editar los dominios después de crear una evaluación.
  9. Haz clic en Actualizar evaluación.

Después de que actualices la configuración, Mainframe Assessment Tool volverá a iniciar el análisis.

¿Qué sigue?