# Notas de release, problemas conocidos, limitaciones y métodos alternativos que afectan a proyectos de servicio único

## Soporte de mensajes de varios segmentos en proyectos de servicio único de Pasarela SOAP IMS

Los proyectos de servicio único de Pasarela SOAP de IMSTM de Enterprise Service Tools incluyen el soporte de programas de paso de mensajes de varios segmentos (MPP). Podrá desplegar los artefactos generados en Rational Developer for System z Versión 7.5 cuando todos los requisitos previos siguientes estén disponibles:

- Pasarela SOAP IMS V10.2
- IMS V10R1 IMS Connect
- PTF para IMS V10R1 IMS Connect APAR PK69366
- PTFs para Enterprise COBOL for z/OSR APAR PK65058

## La conversión XML compilada de COBOL de IBM Rational Developer for System z ha mejorado la comprobación de errores que puede emitir los números de mensaje actualizados de IGZ0280S a IGZ0298S y los números de mensaje nuevos de IGZ0299S a IGZ0303S

Problema: La conversión de XML compilado de Enterprise Service Tools de IBM Rational Developer for System z para tiempos de ejecución CICS, IMS y de proceso por lotes en los casos de ejemplo ascendentes y de encuentro en el medio puede terminar con un código de retorno de 280 a 303. El mensaje de Language Environment devuelto por el conversor está desactualizado, o bien el texto "No se ha podido obtener el mensaje de excepción" se muestra en las anotaciones del sistema en o la consola

Solución: La conversión XML compilada de COBOL de Rational Developer for System z ha mejorado la comprobación de errores que puede emitir los números de mensaje actualizados de IGZ0280S a IGZ0298S y los números de mensaje nuevos de IGZ0299S a IGZ0303S. Aplicar el PTF para APAR PK65058.

## Soporte de correlación adicional en servicios Web para casos de ejemplo CICS

Los servicios web para casos de ejemplo CICS tienen soporte para un nivel de correlación adicional y un nivel de tiempo de ejecución (2.2). Para utilizar los artefactos generados en este nivel, necesita CICS TS 3.2 con el APAR PK69738 aplicado.

## Información sobre la derivación de PL/I a tipos XML

En el tema "Tipos XML derivados de PL/I" en la Tabla 6, el tipo PL/I a XML es erróneo y debe omitirse.

## El libro de copia provoca que el asistente de Enterprise Service Tools se cuelgue

Problema: El asistente de Enterprise Service Tools se cuelga cuando no se resuelven los libros de copia necesarios. Esto ocurre cuando el Idioma de mensajes de error en la página de preferencias del importador COBOL se establece en un valor que no sea en_US.

Solución: Cambie el idioma de los mensajes de error seleccionando: Ventana > Preferencias > Importador > COBOL > Más opciones de COBOL.

## Importación de archivos fuente en el caso de ejemplo intermedio

Problema: en el caso de ejemplo de desarrollo de encuentro en el medio, en el asistente Importar archivos fuente, la importación con la opción Sistema de archivos no está soportada.

Método alternativo: Copie todos los archivos necesarios en un proyecto general e impórtelos seleccionando Espacio de trabajo en el asistente Importar archivos fuente.

## Conflicto en el caso de ejemplo ascendente con archivos WSDL/XSD antiguos y archivos WSDL y XSD nuevos

Problema: En el caso de ejemplo de desarrollo ascendente, al utilizar una versión más antigua de archivos WSDL y archivos XSD generados con conversores recién generados pueden producirse errores en tiempo de ejecución. Por ejemplo, pueden aparecer los siguientes mensajes de error de tiempo de ejecución:

    IGZ0282S No se ha podido realizar la
    conversión de XML a estructura de datos en el programa PGMNAME porque el conversor no ha reconocido ningún nombre de
    elemento en el documento XML.

Solución: Los WSDL/XSD generados con un conversor siempre deben estar emparejados con los conversores.

## Correlación de tipo de datos de esquema XML para tipo COBOL COMP-3 (DECIMAL EMPAQUETADO)

Problema: en el tema de ayuda en línea "Tipos XML derivados de COBOL", la fila de COMP-3 (DECIMAL EMPAQUETADO) debe decir lo siguiente:

Tabla 1. Derivación de tipo COBOL a XML
Tipo COBOL | Propiedades COBOL UsageValue + COBOL ModelType | Tipo XSD correspondiente
--- | --- | ---
packed-decimal, comp-3 -> packedDecimal | packedDecimal | Si se especifica la coma decimal:
    <xsd:simpleType>
    <xsd:restriction base="xsd:decimal">
       <xsd:minInclusive value="xx.x"/>
       <xsd:maxInclusive value="yy.y"/>
    </xsd:restriction>
    </xsd:simpleType>
Si no se especifica la coma decimal:
    <xsd:simpleType>
       <xsd:restriction base="xsd:short">
         <xsd:minInclusive value="xxx"/>
         <xsd:maxInclusive value="yyy"/>
       </xsd:restriction>
    </xsd:simpleType>

## Los casos de ejemplo ascendente y de encuentro en el medio con importación de archivo WSDL (z/OS Unix) remoto que incluye, importa o redefine un esquema no está soportado

Problema: En un proyecto de Enterprise Service Tools, si ejecuta el caso de ejemplo (descendente) Crear nueva implementación de servicio, con el archivo WSDL (importado originalmente de una ubicación remota) que incluye, importa o redefine un esquema, el caso de ejemplo fallaría con un error.

Método alternativo: Copie todos los archivos necesarios en la estación de trabajo o en un proyecto general del espacio de trabajo e importe el archivo WSDL local al "Proyecto de servicios Web para CICS" utilizando RMB -> Importar -> Archivos fuente y pruebe con el caso de ejemplo descendente.

## Las rutinas de conversión COBOL generadas por los asistentes de servicio único solo se ejecutan en z/OS

Aunque el compilador COBOL de estación de trabajo admite las sentencias XML PARSE tanto en tiempo de compilación como en tiempo de ejecución, los programas COBOL generados por los asistentes de servicio único solo se pueden ejecutar en el entorno z/OS

## Profundidad de anidación de elementos XML

Problema:El conversor de XML a estructura de lenguaje devuelve el mensaje de excepción siguiente:

    IGZ0291S La conversión de XML a estructura de datos no se ha podido realizar
    en el programa nombre-programa porque se ha sobrepasado la profundidad de anidación
    máxima del elemento XML. El error se produjo en el elemento
    nombre-elemento con el contenido de caracteres contenido-caracteres.

Método alternativo: El conversor de XML a estructura de lenguaje no ha podido manejar la profundidad de anidación de un elemento XML determinado. Aunque no existe ningún margen establecido para la anidación de niveles más allá del de la estructura COBOL original, es posible sobrepasar un límite. Si existe un elemento en un documento XML de petición que no se encuentra en el esquema, dicho elemento provocará esta condición si el nivel de anidación es muy profundo.

## Elementos FILLER de las estructuras de datos COBOL

Problema: Los grupos sin nombre y sus elementos elementales no se pueden seleccionar en la página de selección de estructuras de datos o en el editor de la sesión de correlación, porque el elemento padre se ha filtrado junto con sus elementos elementales.

Método alternativo: Edite la estructura de datos COBOL y dé nombres a los grupos y/o elementos de datos elementales que requieran conversión. Al dar un nombre a un grupo COBOL, sus elementos elementales no de relleno pasan a estar disponibles para selección.

## Conflicto de la opción de compilador OPT

Problema: La opción de compilador OPT de la sentencia PROCESS generada en los programas de controlador y conversor entrará en conflicto con la opción TEST si la especifica como opción de compilación en el JCL.

Método alternativo: Si desea depurar los programas de conversor XML generados, quite la marca del recuadro de selección "Optimización" en el grupo "Especificar preferencias relacionadas con el compilador" de la página "Opciones de generación" del asistente Servicios Web.

## Acción automática Emparejar Correlación de los grupos COBOL que contienen elementos OCCURS DEPENDING ON

Problema: Si un elemento de datos COBOL es, o contiene, un elemento ODO, no puede realizar una acción "Emparejar Correlación" con una estructura XML compatible, a menos que correlacione manualmente el objeto ODO antes de intentar la acción Emparejar Correlación.

Método alternativo: Antes de intentar la acción Emparejar Correlación, debe correlacionar manualmente el objeto ODO de acuerdo con las reglas de correlación. (En el documento XML, el elemento correlacionado con el elemento del objeto ODO de COBOL debe aparecer antes del elemento XML correlacionado con el correspondiente sujeto ODO de COBOL).

## Sensibilidad a mayúsculas/minúsculas de ciertos campos de entrada de texto en los asistentes de habilitación XML

Problema: Las entradas de nombre de carpeta y archivo son sensibles a las mayúsculas/minúsculas en Eclipse en Windows.

Método alternativo: Asegúrese de que especifica de manera coherente los nombres de carpeta y archivo. Por ejemplo, si el nombre de carpeta muestra MiCarpeta en el entorno de trabajo, deberá teclear MiCarpeta en un campo de entrada que solicite el nombre de la carpeta. Si escribe, por ejemplo, micarpeta, las herramientas pueden indicar que se trata de un nombre de carpeta no válido o inexistente.

## Los punteros no válidos provocan un bucle infinito

Problema: Al proporcionar punteros no nulos no válidos a los controladores o conversores XML se provoca un bucle infinito.

Método alternativo: Los conversores XML intentan detectar y notificar los punteros nulos pasados por el llamador. En el caso de los punteros no nulos no válidos, es probable que los conversores XML encuentren y devuelvan una excepción de protección (SOC4).

## Soporte para miembros de datos DBCS con SOAP para CICS y servicios Web para CICS

En los proyectos de servicio único de Enterprise Service Tools, el soporte de elementos de datos DBCS exige que los documentos XML de petición y respuesta estén codificados en UTF-16 o UTF-8. Si el entorno de tiempo de ejecución destino del servicio Web es SOAP para CICS, configure la característica para intercambiar XML en UTF-8 o UTF-16 con el controlador del conversor XML. El entorno de tiempo de ejecución de servicios Web para CICS intercambiará XML en UTF-8 con un cliente de forma predeterminada mientras el controlador del conversor XML intercambia XML con CICS en UTF-16; cuando se necesita UNICODE, UTF-16 es actualmente la opción más eficaz para los conversores XML. Para cualquiera de los dos entornos de tiempo de ejecución, podría ser necesario configurar el soporte z/OS para UNICODE con una imagen de conversión que soporte la conversión entre UNICODE y la página de códigos de host DBCS.

## El elemento de menú Generar > Archivo XML no respeta las restricciones del esquema XSD

Problema: El elemento de menú Generar -> Archivo XML no respeta las restricciones de un esquema XSD. Al utilizar la acción Generar archivo XML en un XSD creado por Enterprise Service Tools pueden generarse archivos XML no válidos.

Método alternativo: Edite el archivo XML generado de modo que el contenido de los códigos esté en conformidad con las restricciones especificadas en el esquema XSD.

## Procesador por lotes de XML y servicios Web: Las entradas no válidas en el XML de configuración pueden provocar excepciones de puntero nulo durante el proceso por lotes

Problema: Las entradas no válidas en los archivos XML de opciones (Container.xml, PlatformProperties.xml, ServicesSpecification.xml) pueden causar excepciones de puntero nulo durante la ejecución del procesador por lotes.

Método alternativo: Ajústese al formato para especificar correctamente las entradas en los archivos XML de opciones.

## Procesador por lotes de XML y servicios Web: Especificar el directorio para la ubicación del archivo de idioma de entrada

La ubicación de los archivos de entrada COBOL se puede especificar en el atributo importDirectory como una vía de acceso absoluta, empezando por la especificación de la unidad (por ejemplo, C:\mypath\test).

Si, por el contrario, se desea utilizar una vía de acceso relativa (por ejemplo, para que los archivos de configuración y el código fuente COBOL puedan reubicarse sin tener que cambiar las ubicaciones de archivo en los archivos de configuración xsebatch), pruebe lo siguiente:

Tabla 2.
Directorio: | Descripción:
--- | ---
`C:\workspace\account_details` | Proyecto principal
`C:\workspace\account_details\cobol_src` | Subdirectorio con archivos fuente COBOL a importar
`C:\workspace\account_details\xsebatch_config` | Subdirectorio con archivos de configuración XML para xsebatch

Puede utilizar el siguiente elemento InputOutputMessage para un archivo fuente COBOL denominado DFH0ACTD.cbl en el directorio cobol_src:

    <InputOutputMessage importFile="../cobol_src/DFH0ACTD.cbl"></InputOutputMessage>

Otra posibilidad es colocar los archivos fuente COBOL en el mismo directorio desde el que se invoca xsebatch

## Procesador por lotes de XML y servicios Web: especificar nombres de datos con mayúsculas y minúsculas

Aunque los nombres de datos de COBOL no sean sensibles a las mayúsculas/minúsculas, deberá especificarlos exactamente como se escriben en los archivos XML de especificación. Por ejemplo, si en el origen de datos COBOL, el nombre de datos es MY-Data, en el xml de especificación de servicio, el atributo nativeTypeName debe establecerse en nativeTypeid="MY-Data". Si no se especifica exactamente tal como está escrito, el no se encontrará nombre de datos y se utilizará por defecto el primer nombre de datos de nivel 01 disponible.

## Restricción sobre las constantes figurativas LOW-VALUES y HIGH-VALUES

Las constantes figurativas LOW-VALUE(S) y HIGH-VALUE(S) pueden estar presentes en las estructuras de datos COBOL empleadas en los asistentes de servicio único, pero estos asistentes ignoran el significado semántico, que no se transporta a los artefactos generados por estos asistentes de servicio único de Enterprise Service Tools.

## Caracteres GB18030 en un nombre de proyecto de servicio único de Enterprise Service Tools

Problema: Si se utilizan caracteres de la página de códigos GB18030 en un nombre de proyecto de servicio único de Enterprise Service Tools, se producen errores al ejecutar un asistente de servicio único de Enterprise Service Tools en los archivos del proyecto.

Método alternativo: No utilice caracteres GB18030 en los nombres de los proyectos de servicio único de Enterprise Service Tools.

## Los archivos temporales no siempre se borran

Problema: Después de de ejecutar un asistente de servicio único de Enterprise Service Tools, observará que a veces los archivos temporales (por ejemplo, ~DF45B.tmp) se quedan en la carpeta del proyecto de servicio único de Enterprise Service Tools.

Método alternativo: Si ve que hay archivos con nombres similares en el proyecto de servicio único de Enterprise Service Tools después de ejecutar un asistente de servicio único de Enterprise Service Tools, puede suprimir los archivos sin problemas

## El proyecto temporal no siempre se borra

Problema: El proceso de migración de los archivos de correlación antiguos exige que los archivos fuente correlacionados a los que se haga referencia estén en la misma carpeta que el archivo de correlación. Si este requisito no se cumple, la herramienta de migración de correlación fallará con el siguiente mensaje de error: "El recurso [nombre-archivo].mapping no es local".

Método alternativo: Si ve que hay proyectos con nombres similares en el espacio de trabajo después de ejecutar el asistente de servicio único de Enterprise Service Tools, puede suprimir esos proyectos sin peligro.

## Al migrar archivos de correlación de la versión 6.0 (archivos .cmx), los archivos fuente a los que haga referencia el archivo .cmx deben estar en la misma carpeta

Problema: El proceso de migración de los archivos de correlación antiguos exige que los archivos fuente correlacionados a los que se haga referencia estén en la misma carpeta que el archivo de correlación. Si este requisito no se cumple, la herramienta de migración de correlación fallará con el siguiente mensaje de error: "El recurso [nombre-archivo].mapping no es local".

Método alternativo: Traslade los archivos fuente a los que se haga referencia a la misma carpeta que el archivo de correlación que se está migrando.

## Si se navega hasta una ubicación remota en el asistente de servicios Web, el entorno de trabajo se bloquea

Problema: La operación de navegar hasta una ubicación remota de una carpeta destino (carpeta de conversor, WSDL o WSBIND) en las páginas del asistente de servicios Web puede tardar mucho tiempo o bloquear el entorno de trabajo cuando el nombre de la conexión sea largo (como ctfmvs08.rtp.raleigh.ibm.com)

Método alternativo: Cambie el nombre de la conexión por otro más corto, como ctfmvs08.

## Los nombres de elementos globales en los esquemas XML generados no son coherentes entre tipos de conversión XML interpretativos y compilados

Problema: Los nombres del elemento raíz de mensaje de servicio Web en los esquemas XML generados por la generación predeterminada de la conversión XML interpretativa y compilada no coinciden. Es posible que tenga que cambiar el valor predeterminado de generación de la conversión XML compilada para que coincida con las mayúsculas/minúsculas de la conversión interpretativa, como se describe más abajo en el método alternativo. Ello le permitirá cambiar más adelante el tipo de conversión de interpretativa a compilada si es necesario, sin que haga falta volver a publicar el archivo WSDL y sin cambiar el código en los clientes del servicio Web.

Método alternativo: Al generar los artefactos para la conversión XML compilada, puede utilizar el asistente para cambiar el nombre del elemento raíz para que coincida con la conversión XML interpretativa. Esta nueva opción, denominada "Nombre de elemento raíz", se encuentra en la página Opciones de generación, en la pestaña Opciones de WSDL y XSD, en el grupo propiedades de esquemas XML de petición y respuesta.

Por ejemplo, el grupo COBOL llamado A-B-C hará que los artefactos de la conversión interpretativa tengan el nombre de elemento raíz de mensaje "a_b_c". Los artefactos predeterminados de la conversión compilada tendrán el nombre de elemento raíz "ABC". Como ya se ha descrito antes, puede cambiar "ABC" en el asistente por "a_b_c" para que coincida con el WSDL generado para la conversión interpretativa.

## No se permiten caracteres DBCS en el nombre de los archivos de conversor XML generados

Problema: Los caracteres DBCS no están permitidos en los nombres de los miembros de Conjuntos de datos particionados en z/OS.

Método alternativo: Omita los caracteres DBCS al especificar el nombre de los archivos de conversor XML. Además, compruebe que los nombres predeterminados de los archivos sugeridos por el asistente no contienen caracteres DBCS.

Tema principal: Enterprise Service Tools - Notas de release