Rational Developer para System z, Versión 7.6

Propiedades de generación común de los tres tipos de flujo

Este tema describe las propiedades de generación que tienen en común los tres tipos de flujo (Nonterminal, FEPI y Link3270 Bridge).

Este tema contiene los subtemas siguientes:

Información general

Cuando se selecciona un nodo de flujo de un flujo en el árbol jerárquico del panel izquierdo del área del editor del editor de propiedades de generación (el nodo de flujo es el nodo de nivel superior en el árbol jerárquico), el editor de propiedades de generación visualiza, en el lado derecho del área del editor, las propiedades de generación del nodo de flujo seleccionado. Las propiedades de generación incluyen:

Las propiedades de generación comunes son propiedades de generación que están presentes en cada uno de los tres tipos de flujo. La primera propiedad de generación común es el Tipo de flujo, que se utiliza para establecer el tipo de flujo del flujo a Nonterminal, FEPI o Link3270 Bridge.

Las propiedades de generación adicionales son las propiedades adicionales que sólo ocurren en el tipo de flujo seleccionado. El tipo de flujo FEPI y el Link3270 Bridge tienen propiedades de generación adicionales. El tipo de flujo Nonterminal sólo tiene propiedades de generación comunes

Las propiedades del servicio Web son propiedades de generación adicionales que puede estar presentes en cada uno de los tres tipos de flujo. El editor muestra estas propiedades sólo cuando la lista Generar archivos de servicio Web de las propiedades de generación comunes se establece en Servicios Web para CICS.

La Tabla 1 muestra cuáles de estos tres grupos de propiedades de generación se utilizan con cada tipo de flujo:

Tabla 1. Visión general de las propiedades de generación de los tipos de flujo
Tipo de flujo Nonterminal: Tipo de flujo FEPI: Tipo de flujo Link3270 Bridge:
  • Propiedades de generación comunes
  • Propiedades de generación de servicio Web

Flujo principal o flujo invocado

Se puede utilizar el editor de propiedades de generación para modificar tanto un flujo principal como un flujo invocado (consulte la sección Un flujo). El editor de propiedades de generación no distingue entre los dos.

Recuerde: El asistente Generar código de tiempo de ejecución necesita que un flujo invocado tenga un tipo de flujo FEPI o Link3270 Bridge (consulte la sección Acerca de los tipos de flujo).

Propiedades de generación comunes

Para obtener más información sobre las propiedades de generación comunes, consulte la publicación CICS Service Flow Runtime User's Guide (Guía del usuario para el Tiempo de ejecución de flujo de servicios CICS) (consulte la sección Entornos de ejecución soportados para cada tipo de proyecto).

Tabla 2. Propiedades de generación comunes de todos los tipos de flujo
NOMBRE: DESCRIPCIÓN: RANGO DE VALORES: VALOR PREDETERMINADO:
Tipo de flujo El tipo primario de nodos contenidos en el flujo. Dependiendo del tipo seleccionado, es posible que aparezcan propiedades adicionales que se apliquen a todos los nodos de dicho tipo en el editor.
  • Non Terminal: nodos no de terminal Invoke o una combinación de nodos no de terminal Invoke y nodos de operación de pantalla Invoke
  • FEPI: nodos basados en pantalla
  • Link3270: nodos basados en pantalla con o sin correlaciones BMS asociadas
Non terminal
Nombre de petición Este es el nombre que desea que utilice el Tiempo de ejecución de flujo de servicios CICS para identificar el flujo de servicios. Este nombre se utiliza para iniciar el flujo de servicio por nombre en tiempo de ejecución.

Este nombre también se define en CICS como el tipo de proceso del flujo.

Ninguno. Este campo es obligatorio. Ninguno. Este campo es obligatorio.
Nombre de programa Este es el nombre que desea otorgar al archivo COBOL principal que se genera para contener el código fuente del flujo de servicios. Valor de serie: 1-8 caracteres Se obtiene a partir del nombre de flujo (consulte la Tabla 3)
ID de transacción Este es el ID de transacción que desea que se utilice para el nuevo flujo de servicios en CICS. Valor de serie: 1-4 caracteres Primeros 4 caracteres del Nombre de programa
Modalidad de ejecución Modalidad de proceso para la transacción conducida por el flujo
  • ASYNC: modalidad de proceso en la que el proceso y sus actividades se ejecutan como unidades de trabajo independientes
  • LINK: modalidad de proceso en la que un flujo de servicio síncrono se ejecuta como una sola unidad de trabajo. Esta modalidad mejora el rendimiento, ya que utiliza menos tareas durante el proceso de las peticiones. Sin embargo, una anomalía en cualquier adaptador de servidor provoca la retrotracción de toda la unidad de trabajo.
  • SYNC: modalidad de proceso donde el proceso se ejecuta en la misma unidad de trabajo que la tarea de enlace de puente WebSphere MQ-CICS
  • SYNC ROLLBACK: modalidad de proceso que utiliza el proceso síncrono pero que se interrumpe si se produce cualquier anomalía en la actividad en el proceso
SYNC
Comentario Texto que describe el código de tiempo de ejecución que será generado N/D "GENERATE NAVIGATOR MODULE " + el nombre de nodo
Persistente Seleccione esta opción para hacer que la petición y los datos de sesión permanezcan si falla la sesión. N/D No seleccionado
Generar estructuras de datos internos Seleccione esta opción para generar las estructuras de datos directamente en los programas fuente COBOL generados. Esta opción produce un conjunto limitado de módulos (JCL y CBL) necesarios para el despliegue en el host. N/D No seleccionado
Generar archivos de servicios Web Opciones para generar conversores y archivos de soporte para un despliegue no de SOAP (como CTG o MQ) o para un despliegue de servicios Web para CICS
  • Ninguno
  • Servicios Web para CICS: permite generar conversores y soportar archivos o un despliegue de servicios Web para CICS.
Ninguno
Página de códigos del host Utilizado para los siguientes propósitos:
  • Página de códigos del host para el proceso de conversión XML de tiempo de ejecución.
  • Página de códigos de host para subir los archivos al host.
Seleccionar de la lista de páginas de códigos Idioma actual
En la tabla siguiente se describe cómo se obtiene el nombre de programa predeterminado a partir del nombre de flujo:
Tabla 3. Cómo se obtiene el nombre de programa predeterminado
Nombre de flujo: Nombre de programa predeterminado:
Longitud > 8 caracteres Primeros 8 caracteres del nombre de flujo
Longitud < 8 caracteres Nombre de flujo + 'P'
Longitud = 8 caracteres El último carácter no es 'P' Los primeros siete caracteres + 'P'
El último carácter es 'P' Los primeros siete caracteres + 'G'

Propiedades de generación de servicio Web

Las propiedades de generación de servicio Web pueden estar presentes en cada uno de los tres tipos de flujo (Nonterminal, FEPI y Link3270 Bridge) y por lo tanto son propiedades de generación comunes.

El editor de propiedades de generación muestra estas propiedades sólo cuando se selecciona la opción Servicios Web para CICS en la lista Generar archivos de servicio Web (consulte la sección Consideraciones a tener en cuenta al crear un servicio Web ).

  • Exponer todas las cabeceras CICS SFR en interfaz (AVANZADO)
    Esta selección controla dos característica del servicio Web generado:
    Más específicamente:
    • Si no selecciona este recuadro de selección, el servicio Web generado utiliza lo siguiente:
      • Conversión XML de tiempo de ejecución interpretativa.
      • Encabezados de tiempo de ejecución de flujo de servicios CICS mínimos (contienen sólo el nombre de petición).

      Esta opción es más simple y es la recomendada. En los valores de tiempo de ejecución, sólo tiene que especificar el nombre de petición y los datos de usuario.

    • Si selecciona este recuadro de selección, el servicio Web generado utiliza lo siguiente:
      • Conversión XML de tiempo de ejecución compilado.
      • Encabezados de tiempo de ejecución de flujo de servicios CICS completos.

      También se genera un archivo de código fuente COBOL que contiene subprogramas destinados a realizar la conversión de XML a COBOL (consulte la sección Archivo de conversión entre XML y COBOL).

      Esta opción está sólo disponible para permitir la retrocompatibilidad y no se recomienda para cualquier otra situación. En los valores de tiempo de ejecución, debe especificar valores de tiempo de ejecución adicionales.

      Nota: Puede seleccionar el nivel de compilador COBOL del código fuente contenido en el archivo de conversión XML-COBOL generado. Para seleccionar el nivel de compilador COBOL:
      1. En el menú principal del entorno de trabajo, seleccione Ventana > Preferencias. Se abrirá la ventana Preferencias.

      2. En la ventana Preferencias, en el panel izquierdo, seleccione Enterprise Service Tools > Conversores XML COBOL.

      3. En la lista Nivel de compilador, seleccione el nivel de compilador COBOL que desea utilizar.

  • URI de punto final
    Especifique la ubicación que desea que utilicen las aplicaciones habilitadas para SOAP para invocar el servicio Web. La Figura 1 muestra un ejemplo de una ubicación para un URI de punto final:
    Figura 1. Ejemplo de URI de punto final
    http://system.company.com:8181/servicedir/sfp005
    En el URI de ejemplo de la Figura 1:
    • http especifica el método para acceder al recurso.
    • //system.company.com es el nombre o la dirección IP del servidor en el que el servicio Web se va a ejecutar.
    • 8181 es el puerto que el conducto CICS para el servicio Web va a utilizar.
    • /servicedir es el nombre del directorio que el conducto CICS utiliza como directorio de trabajo para los servicios Web activos.
    • /sfp005 es un directorio de /servicedir que el conducto CICS va a utilizar para almacenar información acerca del servicio Web cuando esté activo.
    El asistente Generar código de tiempo de ejecución utiliza la ubicación que especifique aquí en el campo URI de punto final para establecer la dirección SOAP del servicio Web en el archivo WSDL generado (consulte la Figura 2).
    Figura 2. Establecimiento de la dirección SOAP
    <service name="DFHMADPLService">
       <port binding="tns:DFHMADPLHTTPSoapBinding" name="DFHMADPLPort">
          <!-- Esta soap:address indica la ubicación
               del servicio Web a través de HTTP. -->
          <soap:address location="http://system.company.com:8181/servicedir/sfp005"/>
          ...
          ...(lines omitted)
       </port>
    </service>

    Para especificar una ubicación para el campo URI de punto final puede:

    • Seleccione una ubicación en la lista:

      Si ha creado y activado una conexión para un servidor de definición de recursos CICS (consulte la sección Paso B4. (Opcional) Crear una conexión con un servidor de definiciones de recursos CICS) y si una consulta desde la conexión a la región CICS remota es satisfactoria, este campo es una lista de directorios del sistema z/OS remoto en la que puede seleccionar una ubicación.

      Seleccione una ubicación en la lista o escriba una entrada.

    • Escriba una ubicación:

      De lo contrario, este campo es un campo de entrada.

      Escriba una ubicación válida en el campo de entrada.

  • URI local

    CICS utiliza la parte del URI URI para resolver los recursos utilizados por el servicio Web. Este valor se deriva del URI de punto final y no se puede cambiar en el editor de propiedades de generación.

  • Nombre de archivo WSBind

    El asistente Generar código de tiempo de ejecución utiliza el nombre que se ha especificado aquí (por ejemplo, SFP03) para el archivo WSBind que crea (por ejemplo, SFP03.wsbind) en la subcarpeta de generación.

    El archivo WSBind contiene información que se utiliza para definir el servicio Web para CICS (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).

  • Nombre de archivo WSDL

    El archivo de definición de servicio Web los utilizan los que llaman al servicio Web. Este archivo no es un requisito de CICS pero el recurso de generación de código de tiempo de ejecución puede desplegar este archivo en el host, como un método de proporcionar almacenamiento conocido para el mismo. CICS puede utilizar este archivo para la validación de servicios Web.

  • Vía de acceso de archivo HFS WSDL

    El significado de HFS es "sistema de archivo jerárquico", como en UNIX®. Aquí debe escribir la vía de acceso completa del directorio en z/OSUNIX System Services en el que CICS debe buscar el archivo WSDL generado por el asistente Generar código de tiempo de ejecución (por ejemplo, /u/user25/cicsts32/sfp01 ) (consulte la sección Paso B7. La página Selección de ubicaciones de destino del asistente Generar código de tiempo de ejecución).

  • Versión de WSDL

    Esta opción sólo está disponible cuando el entorno de ejecución de destino es el tiempo de ejecución de flujo de servicios CICS para CICS Transaction Server para z/OS V3.2 o posterior.

    Esta opción controla qué versión de WSDL se utiliza como base de los archivos y otros artefactos que el asistente Generar código de tiempo de ejecución crea para el entorno de tiempo de ejecución de servicios Web para CICS:
    WSDL 1.1
    Los archivos y otros artefactos se generan utilizando WSDL 1.1.
    WSDL 2.0
    Los archivos y otros artefactos se generan utilizando WSDL 2.0.
    Restricción: Enterprise Service Tools sólo da soporte a WSDL 2.0 si está soportado por el Auxiliar de servicios Web de CICS en CICS Transaction Server para z/OS V3.2 o posterior. Los usuarios están sujetos a las limitaciones del soporte de WSDL 2.0 del Auxiliar de servicios Web.
  • Versión de SOAP

    Esta opción sólo está disponible cuando el entorno de ejecución de destino es el tiempo de ejecución de flujo de servicios CICS para CICS Transaction Server para z/OS V3.2 o posterior.

    Esta opción controla qué versión de SOAP se utiliza como base de los enlaces de datos en los archivos y otros artefactos que el asistente Generar código de tiempo de ejecución crea para el entorno de tiempo de ejecución de servicios Web para CICS:
    SOAP 1.1
    Los enlaces de datos se generan utilizando SOAP 1.1.
    SOAP 1.2
    Los enlaces de datos se generan utilizando SOAP 1.2.
    Todos
    Los enlaces de datos se generan en SOAP 1.1 y SOAP 1.2
    Restricción: Enterprise Service Tools sólo da soporte a SOAP 1.2 si está soportado por el Auxiliar de servicios Web de CICS en CICS Transaction Server para z/OS V3.2 o posterior. Los usuarios están sujetos a las limitaciones del soporte de SOAP 1.2 del Auxiliar de servicios Web.


Términos de uso | Comentarios

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