Rational Developer for System z, Versión 7.6.1

Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL

En este tema se describen dos opciones de inicialización que hay disponibles al generar un servicio Web en un proyecto de servicio único utilizando el método ascendente y la conversión XML compilada.

Cuando se habilita cualquiera de estas dos opciones de inicialización, las cláusulas VALUE de la estructura de lenguaje de petición que ha especificado para el servicio Web nuevo tendrán efecto mediante el código de inicialización que se ejecuta antes de que el nuevo servicio Web invoque la aplicación COBOL existente (aplicación de proveedor de servicios o aplicación de peticionario de servicios).

Una de estas opciones habilita la inicialización para elementos de datos en la estructura de lenguaje de petición que ha incluido en la estructura de datos de entrada del servicio Web. La otra opción permite la inicialización de elementos de datos en la estructura del lenguaje de petición que ha excluido de la estructura de datos de entrada del servicio Web.

Esta opción está disponible en el asistente Crear interfaz de servicio nuevo (ascendente) (consulte la sección Establecer las preferencias de los conversores XML COBOL) y en el procesador por lotes de línea de mandatos (consulte las propiedades INIT_EMPTY_ITEMS_IN_INTERFACE y INIT_OMITTED_ITEMS_IN_INTERFACE en CodegenProperty).

Esta opción sólo está disponible cuando utiliza la opción de conversión compilada.

Descripción

La estructura de lenguaje de petición COBOL que especifica para el servicio Web nuevo puede contener cláusulas VALUE que definan los valores iniciales para los elementos de datos de la estructura de lenguajede peticiónd (para obtener más información sobre la estructura de lenguaje de petición, consulte la sección Página Estructuras de lenguaje para la interfaz del asistente y la sección InputMessage para la interfaz de línea de mandatos de procesador por lotes).

No obstante, en el código fuente que se genera para el servicio Web nuevo, estas cláusulas VALUE no se incluyen en la sección LINKAGE que define la estructura de datos de entrada que el servicio Web nuevo pasa a la aplicación de datos COBOL existente (aplicaciones proveedoras o peticionarios de servicios). El motivo es que el compilador de COBOL no tiene en cuenta las cláusulas VALUE en la sección LINKAGE.

Así, para permitir al usuario que estas cláuslas VALUE no incluidas tengan efecto, las dos opciones que se describen en este tema de ayuda hacen que el generador de código fuente de Enterprise Service Tools añada el código fuente de inicialización al controlador de servicio Web nuevo. Este código fuente de inicialización inicializa los elementos de datos en la estructura de datos de entrada que se pasa a la aplicación COBOL existente con los mismos valores iniciales que tendría si se hubieran procesado las cláuslas VALUE.

Nota: Esta opción precisa que el literal VALUE esté definido en una línea (y no en líneas continuadas).

Para obtener información sobre cómo especificar estas opciones, consulte la sección relevante de la ayuda en línea, ya sea para el asistente Crear interfaz de servicio nueva (ascendente) (Establecer las preferencias de los conversores XML COBOL) o para el procesador por lotes de línea de mandatos (CodegenProperty).

La diferencia entre las dos opciones es la siguiente:
  • La opción INIT_EMPTY_ITEMS_IN_INTERFACE habilita la inicialización de elementos de datos de la estructura de lenguaje de petición que ha incluido en la estructura de datos de entrada de servicio Web.
    • Incluso cuando esta opción está habilitada, no afecta a un elemento de datos COBOL en particular a menos que el elemento XML correspondiente en la definición de esquema XML de petición esté vacío.
      • Un elemento está vacío si toda la información que contiene es únicamente el nombre del elemento de datos. Ejemplos de estos elementos vacíos:
        <element name="NombreUsuario"></element>
        <element name="Departamento"/>
      • Por ejemplo:
        • Supongamos lo siguiente:
          • En la estructura de datos COBOL original, el elemento de datos Departamento se inicializa en 044 por medio de una cláusula VALUE.
          • La opción INIT_EMPTY_ITEMS_IN_INTERFACE está habilitada.
          • Se recibe una petición en la que el elemento XML correspondiente al elemento de datos Departamento de COBOL está vacío.
        • El resultado es que Enterprise Service Tools inicializa el elemento de datos correspondiente (Departamento) en la estructura de datos de entrada que se pasa a la aplicación COBOL existente en el mismo valor (044) que tendría si se hubiera procesado la cláusula VALUE.
    • De lo contrario, (es decir, si la opción no está habilitada o si la opción está habilitada pero el elemento XML de la definición de esquema XML de petición no está vacío), si el elemento XML no especifica un valor para el elemento de datos, Enterprise Service Tools establece el elemento de datos correspondiente en la estructura de datos de entrada que se pasa a la aplicación COBOL existente en:
      • Vacío, si el elemento de datos es alfabético o alfanumérico.
      • 0 si el elemento de datos es un elemento de datos numérico.

  • La opción INIT_OMITTED_ITEMS_IN_INTERFACE habilita la inicialización para elementos de datos de la estructura de lenguaje de petición que ha excluido de la estructura de datos de entrada del servicio Web.
    Nota: Si un elemento de datos excluido no se ha inicializado utilizando esta opción, su contenido no está definido.

Para obtener más información sobre los elementos de datos incluidos y excluidos, consulte la sección Página Estructuras de lenguaje en la interfaz del asistente o la sección InputMessage en la interfaz de línea de mandatos del procesador por lotes.


Términos de uso | Comentarios

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