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:
Inicie el asistente Nuevas propiedades de generación:
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).
Seleccione .
Se abrirá el asistente Nuevas propiedades de generación.
Nota: De forma alternativa,
para iniciar el asistente, puede seguir estos pasos:
En el menú principal del entorno de trabajo,
seleccione .
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.
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.
Pulse Siguiente. Se abre la página Propiedades de generación
- Selección de tiempo de ejecución.
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.
Pulse Finalizar.
El asistente Nuevas propiedades de generación hace lo siguiente:
- Crea
un archivo de propiedades de generación predeterminado para la macro HATS y da al archivo
el nombre especificado por el usuario.
- Almacena el
archivo en
.
- 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:
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.
Modifique las propiedades de generación que quiera modificar (consultar
Propiedades de generación para el entorno de ejecución HATS).
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:
Inicie el asistente Generar código de tiempo de ejecución:
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.
Seleccione .
Se abrirá el asistente Generar código de tiempo de ejecución.
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.
Para la generación local, pulse Finalizar y continúe en el paso 5.
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.
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 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
Si
lo desea, compruebe las estructuras del archivo generado del siguiente modo:
- Renueve
la carpeta del proyecto del espacio de trabajo. Se visualizará el archivo hma.
- Abra el archivo para comprobar que el contenido es correcto.
El asistente Generar código de tiempo de ejecución almacena la macro en
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.
Ésta es una lista de comprobación de los resultados que se deben verificar:
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:
- Pulse Detalles. El asistente visualiza un panel que contiene una lista
de los archivos que el asistente ha generado.
- Verifique que se listan el archivo o archivos de salida que esperaba que se generasen.
- Compruebe además la misma lista para ver si existen mensajes de aviso.
- 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:
- 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.
- Pulse Aceptar para cerrar la ventana.
- Verifique que se han generado el archivo o archivos de salida:
- Renueve la carpeta de salida (consulte la sección Paso B1. Decidir un destino para los archivos de salida).
- 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.