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

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

    La 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 en COBOL (cob y cbl)
    • Libros de copias de COBOL (inc y cpy)
    • Programas de Easytrieve (ezt)
    • Programas de 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)

    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 la herramienta de evaluación de Mainframe, sigue estos pasos:

    1. Para abrir la herramienta de evaluación de Mainframe 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 el archivo ZIP que quieres 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. Opcional: Para agregar uno o más dominios que representen un área distinta de funcionalidad, haz clic en Agregar dominio.

    Esta información se usa para la asignación automática y te permite filtrar y revisar los resultados según contextos específicos después de que se completa la evaluación.

  5. Haz clic en Siguiente.

  6. 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á en espera.
  • 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 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 que se encuentra junto a él en la tabla. Se abrirá una página que muestra todos los pasos junto con el estado.

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 quieres 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. En el paso Detalles de la evaluación, edita el nombre y la descripción, y, luego, haz clic en Siguiente.
  6. En el paso Configuración de IA, modifica la configuración de IA según sea necesario y, luego, haz clic en Siguiente.
  7. En el paso Dominios, haz clic en Siguiente. No puedes editar los dominios después de crear una evaluación.
  8. Haz clic en Actualizar evaluación.

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

¿Qué sigue?