Rational Developer for System z, Versión 7.6.1

Archivos creados por el asistente Generar código de tiempo de ejecución

En este tema se describen los archivos creados por el asistente Generar código de tiempo de ejecución.

Nota: Para obtener una descripción del Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0 y el Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0, consulte Tiempo de ejecución de flujo de servicios CICS Niveles 1.0 y 2.0.
Este tema contiene la información siguiente:

Información general

Nota: El asistente no siempre genera todos los tipos de archivos de salida que aparecen en las tablas de los subtemas siguientes. La generación de un tipo de archivo de salida concreto depende del entorno de ejecución de destino que seleccione en el asistente Propiedades de generación nuevas, de las propiedades de generación que establezca con el editor de propiedades de generación y de las opciones que seleccione en el asistente Generar código de tiempo de ejecución.
Los archivos generados por el asistente se pueden clasificar en cinco grupos, que se muestran en Tabla 1)::
Tabla 1. Archivos generados por el asistente Generar código de tiempo de ejecución
Tipos de archivos generados: Descripción: Enlace al subtema a continuación:
Archivos fuente y libros de copia de COBOL
  • Archivos fuente para el programa:
  • Conversores XML (opcionales)
Archivos fuente y libros de copia de COBOL
Archivos JCL
  • Archivo JCL para compilar el código fuente
  • Archivo JCL para crear definiciones de recurso
Archivos JCL
Archivos de servicio Web
  • Archivo WSBind
  • Archivo WSDL
Archivos de servicio Web
Archivo de conversión entre XML y COBOL Archivo que contiene subprogramas de conversión para datos de entrada y de salida.
  • Subprograma para la conversión de datos de entrada de esquema XML a COBOL.
  • Subprograma para la conversión de datos de salida de COBOL a esquema XML.
Archivo de conversión entre XML y COBOL
Archivo de propiedades de flujo de servicios
  • Archivos de propiedades de flujo de servicios
Archivos de propiedades de flujo de servicio

Archivos fuente y libros de copia de COBOL

La Tabla 2 muestra los archivos fuente COBOL y los libros de copia que se generan:
Nota: Para un nodo Invoke de WebSphere MQ, se generan menos archivos de código fuente cuando el entorno de ejecución de destino establecido en el archivo de propiedades de generación es Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0 (consulte Tiempo de ejecución de flujo de servicios CICS Niveles 1.0 y 2.0).
Tabla 2. Archivos fuente y libros de copia de COBOL
Entornos de ejecución de destino y archivo para los que se genera este archivo: Cómo utilizar este archivo: Destino z/OS: Nombres de archivo: Extensiones de archivo:
Programa principal para el flujo
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Compile este programa en una biblioteca asignada a DFHRPL en el sistema CICS.
Nota: Puede establecer opciones en el asistente Generar código de tiempo de ejecución para que éste cree automáticamente un JCL de compilación y lo someta a z/OS (consulte las secciones Paso B6. La página Selección de archivo del asistente Generar código de tiempo de ejecución y Paso B8. La página de opciones de instalación y compilación del asistente Generar código de tiempo de ejecución).
Conjunto de datos particionado que contiene código fuente COBOL. Programa en el editor de propiedades de generación .cbl
Libros de copia de mensajes
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Nota: Si selecciona la opción Generar estructuras de datos internas en el editor de propiedades de generación, estos libros de copia se incorporan al programa en lugar de en archivos separados.
Cuando el compilador compila un archivo COBOL, también compila automáticamente los archivos de libro de copia incluidos en el archivo COBOL. Conjunto de datos particionado que contiene libros de copia COBOL Generado a partir de nombres de mensaje .cpy

Archivos JCL

Recuerde: Si no ha personalizado las plantillas de JCL, tendrá que actualizar todos los archivos JCL creados por el asistente Generar código de tiempo de ejecución para que utilicen los valores reales, en vez de los términos de ejemplo (consultar Paso B2. (Recomendado) Personalizar las plantillas JCL).
La Tabla 3 muestra los archivos JCL que se generan:
Nota: Para un nodo de invocación WebSphere MQ, se generan menos archivos JCL cuando el conjunto de entorno de ejecución de destino en el archivo de propiedades de generación es el Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0 (consulte el tema Tipo de invocación de WebSphere MQ, diferencias en el trato de diferentes entornos de tiempo de ejecución de destino).
Tabla 3. Archivos JCL
Entornos de ejecución de destino y archivo para los que se genera este archivo: Cómo utilizar este archivo: Destino z/OS: Nombres de archivo: Extensiones de archivo:
JCL de compilación utilizado para compilar el código fuente COBOL generado.Este archivo sólo se genera si se ha seleccionado la opción Crear JCL de compilación en el asistente Generar código de tiempo de ejecución.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Someta esta archivo a z/OS para compilar el código fuente generado.
Nota: Puede establecer una opción en el asistente Generar código de tiempo de ejecución para que éste someta automáticamente este JCL de compilación a z/OS (consulte la sección Paso B8. La página de opciones de instalación y compilación del asistente Generar código de tiempo de ejecución).
Conjunto de datos particionado que contiene JCL Igual que los nombres de programa que compilan .jcl
JCL de compilación destinado a compilar los conversores XML de servicios Web y a crear recursos CICS para esos programas.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Nota: Las definiciones de recursos CICS están comentadas de forma predeterminada. Debe restaurarlas si necesita esa función.
Someta esta archivo a z/OS para compilar el código fuente generado.
Nota: Puede establecer una opción en el asistente Generar código de tiempo de ejecución para que éste someta automáticamente este JCL de compilación a z/OS (consulte la sección Paso B8. La página de opciones de instalación y compilación del asistente Generar código de tiempo de ejecución).
Conjunto de datos particionado que contiene JCL Igual que el nombres del programa .jcl
JCL de actualización de archivo de propiedades utilizado para actualizar el archivo de propiedades de del Tiempo de ejecución de flujo de servicios CICS.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
Este archivo se genera siempre si la versión del entorno de ejecución es Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0.
Someta este JCL a z/OS para actualizar el archivo de propiedades del Tiempo de ejecución de flujo de servicios CICS con información sobre el programa generado. Conjunto de datos particionado que contiene JCL @ + 7 primeras letras del nombre de petición especificado en el editor de propiedades de generación .jcl
Trabajo de Definición de recurso CICS utilizado para crear definiciones de recursos para los programas generados. Este archivo sólo se genera si se ha seleccionado la opción Crear JCL de definiciones de recurso en el asistente Generar código de tiempo de ejecución.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Someta esta archivo a z/OS para crear las definiciones de recurso del programa generado.
Nota: Puede establecer una opción en el asistente Generar código de tiempo de ejecución para que éste someta automáticamente este JCL de definición de recurso a z/OS (consulte la sección Paso B8. La página de opciones de instalación y compilación del asistente Generar código de tiempo de ejecución).
Conjunto de datos particionado que contiene JCL # + 7 primeras letras del nombre de petición especificado en el editor de propiedades de generación .jcl

Archivos de servicio Web

Nota: Puede utilizar el comprobador de servicios Web para probar el servicio Web. Pulse el archivo .wsdl generado con el botón derecho del ratón y seleccione Servicios Web > Probar con el explorador de servicios Web.
La Tabla 4 muestra los archivos de servicios Web que se generan:
Tabla 4. Archivos de servicio Web
Entornos de ejecución de destino y archivo para los que se genera este archivo: Cómo utilizar este archivo: Destino z/OS: Nombres de archivo: Extensiones de archivo:
Archivo de definición de servicios Web utilizado por los clientes de servicios Web.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
  • CICS sólo utiliza este archivo cuando tiene configurada la opción en CICS para que realice la validación de tiempo de ejecución de mensajes SOAP.
  • Por lo general, esta validación de tiempo de ejecución sólo es necesaria cuando está depurando un programa.
Cualquier vía de acceso válida en z/OS UNIX® System Services Especificados en el editor de propiedades de generación .wsdl
Archivo WSBind utilizado por CICS para definir el recurso WEBSERVICE como resultado del mandato PIPELINE SCAN.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Durante la ejecución, CICS utiliza información del archivo de enlace de servicio Web para realizar la correlación entre las estructuras de datos de aplicación y los mensajes SOAP. Vía de acceso de z/OS UNIX System Services utilizada por CICS PIPELINE Especificados en el editor de propiedades de generación .wsbind

Archivo de conversión entre XML y COBOL

De forma predeterminada, cuando el asistente Generar código de tiempo de ejecución genera código fuente COBOL para un servicio Web, el código fuente generado utiliza la característica de conversión interpretativa CICS de Servicios Web para CICS (consulte el tema Conversión XML de entorno de ejecución: compilada o interactiva).

Sin embargo, en dos casos el asistente Generar código de tiempo de ejecución genera código fuente que utiliza la característica de conversión compilada de Servicios Web para CICS. Uno de estos casos es cuando se selecciona una página de códigos en árabe en el editor de propiedades de generación, y el otro es cuando se indica específicamente al asistente en el editor de propiedades de generación que debe generarse código fuente que utilice la conversión compilada.

en ambos casos, el asistente genera un archivo fuente COBOL adicional que contiene dos subprogramas para realizar las conversiones reales.
  • Un subprograma para convertir los datos de entrada del formato de un esquema XSD al formato de una estructura de datos COBOL; y
  • Un subprograma para convertir los datos de salida del formato de una estructura de datos COBOL al formato de un esquema XSD.

Para que el asistente Generar código de tiempo de ejecución genere código fuente para conversión compilada y el archivo fuente COBOL adicional que contiene los subprogramas de conversión, siga estos pasos en el editor de propiedades de generación:

  1. En las propiedades de generación comunes, en la lista Generar archivos de servicios Web, seleccione Servicios Web para CICS.
  2. Realice una de las siguientes acciones:
    • En la lista Página de códigos de host de las propiedades comunes de generación, seleccione una de las siguientes páginas de códigos:
      • 420 Arabic Speaking
      • 424 Hebrew (New Code)
    • O bien, en el grupo de propiedades de generación de servicios Web, seleccione la opción Exponer todas las cabeceras CICS SFR en interfaz (AVANZADO) (consulte la sección Exponer TODAS las cabeceras CICS SFR en interfaz (AVANZADO).
Nota: La habilitación de esta opción de conversión compilada no resulta afectada por el valor del recuadro de selección Generar estructuras de datos internas de las propiedades comunes de generación.
Nota: Puede seleccionar el nivel de compilador COBOL del código fuente generado (consulte la sección Exponer TODAS las cabeceras CICS SFR en interfaz (AVANZADO)).

Tabla 5 describe el archivo fuente COBOL generado que contiene los dos subprogramas de conversión entre XML y COBOL.

Tabla 5. Archivo que contiene los subprogramas de conversión entre XML y COBOL
Entornos de ejecución de destino y archivo para los que se genera este archivo: Cómo utilizar este archivo: Destino z/OS: Nombre de archivo: Extensiones de archivo:
Archivo que contiene los dos subprogramas de conversión de formato de datos entre XML y COBOL.
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 1.0
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
Compile el archivo en una biblioteca asignada a DFHRPL en el sistema CICS. Conjunto de datos particionado que contiene miembros de código fuente COBOL Prefijo de nombre de programa conversor1 + letras iniciales del nombre del archivo de flujo + D .cbl
Notas de la tabla:
  1. El prefijo de nombre de programa conversor se establece en la ventana Preferencias. El valor predeterminado es XCNV. Para modificar este valor:
    1. En el menú principal del entorno de trabajo, pulse Ventana > Preferencias.
    2. En la ventana Preferencias:
      1. En el panel izquierdo, seleccione Enterprise Service Tools > Conversores XML COBOL.
      2. En la pestaña Opciones básicas del campo de entrada Prefijo de nombre de programa conversor, escriba el prefijo de nombre de programa conversor que desee utilizar.

Archivos de propiedades de flujo de servicio

El archivo de propiedades de flujo de servicio contiene el programa generado y lo utiliza el Tiempo de ejecución de flujo de servicios CICS. Tabla 6 muestra este archivo:
Tabla 6. Archivos de propiedades de flujo de servicio
Entornos de ejecución de destino y archivo para los que se genera este archivo: Cómo utilizar este archivo: Destino z/OS: Nombres de archivo: Extensiones de archivo:
Archivo de propiedades de flujo de servicio (consulte el subtema a continuación: Archivos de propiedades de flujo de servicio).
Entornos de ejecución:
  • Tiempo de ejecución de flujo de servicios CICS: Nivel 2.0
El archivo de propiedades de flujo de servicio contiene propiedades del programa generado y lo utiliza el Tiempo de ejecución de flujo de servicios CICS para configurar CICS. Consulte la sección Directorio de recogida de flujo de servicios. El nombre del flujo. .sfp
Importante: El archivo de propiedades de flujo de servicios debe copiarse en el directorio del sistema z/OS remoto que actúa como directorio de recogida del flujo de servicios (consulte Directorio de recogida de flujo de servicios).

Este archivo es nuevo en Rational Developer for System z Versión 7.1 y sustituye el archivo JCL de actualización de archivo de propiedades.

El nombre y extensión de este archivo se determinan de la siguiente manera:
  • El nombre del archivo es el nombre del flujo solicitado.
  • La extensión es .sfp.
Este archivo está generado en la página de códigos de la estación de trabajo. Cuando el archivo se copia a un sistema z/OS remoto:
  • Si el archivo se copia a un sistema z/OS remoto por parte del asistente Generar código de tiempo de ejecución, el archivo se convierte a la página de códigos del sistema z/OS.
  • Si copia el archivo en un sistema z/OS remoto por parte de un programa de transferencia de archivos externo como FTP, debería utilizar formato de texto(no formato binario) para copiar el archivo.

Si la longitud de este archivo sobrepasa los 32600 caracteres, el asistente Generar código de tiempo de ejecución finalizará con un error y mostrará un mensaje de error.

Directorio de recogida de flujo de servicios

El directorio de recogida (pickup) de flujo de servicios del sistema z/OS remoto es el directorio en el que debe copiar los archivos de propiedades de flujo de servicios (.sfp).

Sólo existe un directorio de recogida de flujo de servicios por cada región CICS.

El administrador del sistema determina la ubicación del directorio de recogida de flujo de servicios.

Importante: La publicación CICS Service Flow Runtime User's Guide hace referencia a este directorio como como "directorio de despliegue de zFS" (consulte la sección Entornos de ejecución soportados para cada tipo de proyecto).


Términos de uso | Comentarios

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