Rational Developer for System z, Versión 7.6.1

Generación de una macro HATS para el entorno de ejecución HATS

Este tema describe los pasos para la generación de una macro HATS para el entorno de ejecución HATS.

Antes de generar una macro HATS, consulte las restricciones descritas en la sección Limitaciones de las características y posibilidades al generar macros HATS o al reproducir flujos.

Parte 1. Crear un archivo de propiedades de generación

Utilice el asistente Nuevas propiedades de generación para crear un archivo de propiedades de generación. El archivo de propiedades de generación contiene varios parámetros que son necesarios para el asistente Generar código de tiempo de ejecución en la Parte 3.

Para utilizar el asistente Nuevas propiedades de generación:

  1. Inicie el asistente Nuevas propiedades de generación:
    1. En el Explorador de proyectos EST, pulse con el botón derecho del ratón el flujo para el que desea generar un nuevo archivo de propiedades de generación (por ejemplo, MySFP_0001.seqflow).

    2. Seleccione Nuevo > Archivo de propiedades de generación.

    Se abrirá el asistente Nuevas propiedades de generación.

    Nota: De forma alternativa, para iniciar el asistente, puede seguir estos pasos:
    1. En el menú principal del entorno de trabajo, seleccione Nuevo > Archivo de propiedades de generación.

    2. Se abrirá el asistente Nuevas propiedades de generación.

    Si no ha seleccionado un flujo, puede especificar el flujo en la primera página del asistente.

  2. En la primera página del asistente, denominada Propiedades de generación - Archivo nuevo, complete los campos de esta manera:
    • En el campo Nombre de archivo, especifique un nombre para el archivo que se utilizará para almacenar las propiedades de generación.
    • En el campo Proyecto destino ya debe figurar el proyecto que contiene el flujo seleccionado.
    • En el campo Flujo ya debe figurar el flujo seleccionado.
    • Marque el recuadro de selección Validar flujos ante entornos de ejecución para que el asistente determine si el flujo seleccionado puede utilizarse para generar código de tiempo de ejecución para cada uno de los entornos de ejecución soportados.
      • Este nivel de validación comprueba sólo si los tipos de nodos del flujo seleccionado son válidos para cada uno de los entornos de ejecución soportados. Al generar el código para el entorno de ejecución, se realiza una validación más exhaustiva.
      • Los resultados de esta validación se visualizan en la próxima página del asistente. Si el flujo seleccionado puede utilizarse para generar código para un entorno de ejecución en función de este nivel de validación, la selección correspondiente a dicho entorno de ejecución quedará habilitada. De lo contrario, la selección queda inhabilitada.

  3. Pulse Siguiente. Se abre la página Propiedades de generación - Selección de tiempo de ejecución.

  4. Seleccione Host Access Transformation Services. Si esta selección no está disponible y ha marcado el recuadro de selección Validar flujos ante entornos de ejecución en la página anterior, significa que el flujo contiene uno o más nodos de un tipo que no está soportado por el entorno de ejecución HATS.

    Las restricciones adicionales de HATS que pueden provocar anomalías en la validación incluyen:
    • Los nodos Invoke deben estar asociados con operaciones de pantalla.

  5. Pulse Finalizar.

  6. El asistente Nuevas propiedades de generación hace lo siguiente:
    1. Crea un archivo de propiedades de generación predeterminado para la macro HATS y da al archivo el nombre especificado por el usuario.
    2. Almacena el archivo en Generación > HATS > [nombre flujo].
    3. Se cierra.

Cuando finaliza el asistente Nuevas propiedades de generación, Enterprise Service Tools abre el nuevo archivo de propiedades de generación con el editor de propiedades de generación.

Parte 2. Modificar las propiedades de generación, si fuera necesario

Utilice el editor de propiedades de generación para modificar las propiedades de generación que quiera modificar:

  1. El editor de propiedades de generación muestra las propiedades de generación.

    Nota: El editor de propiedades de generación sólo muestra un conjunto de propiedades, porque sólo se generará una única macro HATS utilizando este archivo de propiedades de generación. No puede seleccionar nodos individuales para modificar.
  2. Modifique las propiedades de generación que quiera modificar (consultar Propiedades de generación para el entorno de ejecución HATS).

  3. Guarde los cambios y cierre el editor.

Parte 3. Ejecutar el asistente Generar código de tiempo de ejecución

Genere la macro HATS utilizando el asistente Generar código de tiempo de ejecución:

  1. Inicie el asistente Generar código de tiempo de ejecución:

    1. En el Explorador de proyectos EST, pulse con el botón derecho del ratón el archivo de propiedades de generación que ha modificado en la parte 2.

      Nota:

      De forma alternativa, en la carpeta Flujos, puede pulsar cualquier flujo con el botón derecho del ratón. Después puede especificar un archivo de propiedades de generación determinado en la primera página del asistente.

    2. Seleccione Generar > Generar código de tiempo de ejecución.

      Nota: Si no ha seleccionado un archivo de propiedades de generación, el asistente Generar código de tiempo de ejecución permite seleccionar uno. Si no existe ningún archivo de propiedades de generación, las herramientas del proyecto de flujo de servicio le solicitan que cree uno.

    Se abrirá el asistente Generar código de tiempo de ejecución.

  2. En la primera página del asistente Generar código de tiempo de ejecución, denominada Selección de archivo, complete los campos de la siguiente manera:
    • En el campo Nombre de archivo ya debe figurar el archivo seleccionado.
    • Para enviar el código a otra ubicación, marque el recuadro de selección Generar en otra ubicación.

  3. Para la generación local, pulse Finalizar y continúe en el paso 5.

  4. Para generación remota, pulse Siguiente. Se abre la página Selección de ubicaciones de destino. Rellene los campos del siguiente modo:
    • Pulse Examinar para localizar el proyecto de flujo de servicios en el que desea almacenar la macro HATS.
    • Pulse Finalizar.

  5. El asistente Generar código de tiempo de ejecución genera el código de tiempo de ejecución a partir de la información del archivo de propiedades de generación especificado. El proceso de generación tarda unos segundos en finalizar. Se visualiza un mensaje de resultado, que indica si la generación ha sido satisfactoria. Pulse Detalles para ver los mensajes relativos a la generación de código.

    El asistente Generar código de tiempo de ejecución almacena la macro en Generación > HATS > nombre de flujo en el proyecto seleccionado (generación local) o en una carpeta especificada en un sistema z/OS remoto (generación remota). El nombre de la macro es el mismo que el del flujo desde el que se generó la macro más la extensión .hma

  6. Si lo desea, compruebe las estructuras del archivo generado del siguiente modo:
    1. Renueve la carpeta del proyecto del espacio de trabajo. Se visualizará el archivo hma.
    2. Abra el archivo para comprobar que el contenido es correcto.

El asistente Generar código de tiempo de ejecución almacena la macro en Generación > HATS > [nombre flujo] en el proyecto seleccionado (generación local) o en una carpeta especificada (generación remota). El nombre de la macro es el mismo que el del flujo desde el que se generó la macro más la extensión .hma

Parte 4. Comprobar los resultados de ejecutar el asistente Generar código de tiempo de ejecución

Después de que se haya cerrado el asistente Generar código de tiempo de ejecución, se deben comprobar los resultados para verificar que las acciones que se pretendían realizar se han llevado a cabo y que no se han producido errores.

Nota: Para obtener información acerca de los mensajes de error o los mensajes de aviso visualizados por el asistente Generar código de tiempo de ejecución, consulte la sección Mensajes de error que muestra el asistente Generar código de tiempo de ejecución.

Ésta es una lista de comprobación de los resultados que se deben verificar:

  1. Compruebe si hay algún mensaje de error o aviso:

    • GENERACIÓN SATISFACTORIA (POSIBLEMENTE CON AVISOS):
      Si el asistente Generar código de tiempo de ejecución no ha encontrado ningún problema significativo durante la generación de código, cuando ésta se completa el asistente abre la ventana Generación de código de tiempo de ejecución completada. En esta ventana:
      1. Pulse Detalles. El asistente visualiza un panel que contiene una lista de los archivos que el asistente ha generado.
      2. Verifique que se listan el archivo o archivos de salida que esperaba que se generasen.
      3. Compruebe además la misma lista para ver si existen mensajes de aviso.
        Nota: Para obtener más información acerca de algún mensaje de aviso en particular, consulte la información proporcionada con el número de aviso en la sección Mensajes de error que muestra el asistente Generar código de tiempo de ejecución.
      4. Pulse Aceptar para cerrar la ventana.

    • ERROR DE GENERACIÓN:
      Si el asistente Generar código de tiempo de ejecución ha encontrado un problema significativo durante la generación de código, el asistente abre la ventana Error de generación. En esta ventana:
      1. Pulse Detalles. El asistente visualiza una lista que contiene uno o varios mensajes de error que describen el problema o problemas específicos que el asistente ha encontrado.
        Nota: Para obtener más información acerca de un error determinado, consulte la información proporcionada con el número de error en la sección Mensajes de error que muestra el asistente Generar código de tiempo de ejecución.
      2. Pulse Aceptar para cerrar la ventana.

  2. Verifique que se han generado el archivo o archivos de salida:
    1. Renueve la carpeta de salida (consulte la sección Paso B1. Decidir un destino para los archivos de salida).
    2. Verifique que se han generado el archivo o archivos de salida listados en el panel Detalles.
Nota: Si un elemento <input> de una macro HATS generada incluye una tecla AYUDA, el elemento también incluirá la posición de fila y columna del cursor cuando se pulse la tecla AYUDA.

Términos de uso | Comentarios

Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)