Migración de conjunto de mensajes

Cuando migre un flujo de mensajes que utilice conjuntos de mensajes, revise los cambios en el comportamiento de WebSphere Message Broker versión 7.0.

Revise esta información sobre los cambios en el conjunto de mensajes y los posible efectos si está realizando la migración desde la versión 6.0; no es necesario migrar ningún conjunto de mensajes desde la versión 6.1.

No es necesario que ejecute los mandatos de migración; WebSphere Message Broker Toolkit versión 7.0 puede leer un proyecto de conjunto de mensajes de la versión 6.0 y convertirlo automáticamente en formato de la versión 7.0 cuando lo modifique y lo guarde por primera vez.

Para obtener ayuda sobre los cambios en el comportamiento de los analizadores y para obtener información general sobre la migración, consulte los apartados siguientes:

Cambios de comportamiento en el analizador XMLNSC

Se implementan los cambios siguientes en versión 7.0:

  • En la versión 6.0, los atributos de un elemento XML se muestran en el árbol de mensajes que el analizador XMLNSC crea en el orden en que se muestran en el elemento del documento XML.

    En la versión 7.0, el analizador XMLNSC siempre muestra los atributos de espacio de nombres delante de otros atributos cuando crea el árbol de mensaje. Sin embargo, los atributos XML están desordenados de forma intrínseca, y por lo canto, no graban la lógica de flujo de mensajes que presupone la posición de atributo.

  • En la versión 6.0, el analizador XMLNSC acepta EBCDIC NETL como un carácter de salto de línea XML en z/OS únicamente.

    En la versión 7.0, NEL se acepta en todas las plataformas.

  • En versión 6.0, el analizador XMLNSC omite el valor de la propiedad Validar de un nodo.

    En la versión 7.0, el analizador XMLNSC respeta el valor de la propiedad Validar. Si ha establecido esta propiedad en Contenido o en Contenido y valor, el analizador valida el mensaje con relación al conjunto de mensajes definidos por la propiedad Conjunto de mensajes.

    Por consiguiente, si ha establecido involuntariamente la propiedad Validar de la versión 6.0 en Contenido o Contenido y valor, el flujo de mensajes emite una excepción después de la migración a la versión 7.0.

    Para corregir esta situación, establezca la propiedad Validar en Ninguna.

  • En la versión 6.0, el analizador XMLNSC utiliza el formato de ESQL predeterminado "YYYY-MM-DD hh:mm:ss" cuando graba un campo de tipo TIMESTAMP o GMTTIMESTAMP. Este formato no sigue la especificación del Esquema XML 1.0.

    En la versión 7.0, el analizador XMLNSC utiliza el formato "YYYY-MM-DD'T'hh:mm:ss.sss", que sigue la especificación del Esquema XML 1.0. Si necesita que se grabe otro formato, debe convertir TIMESTAMP o GMTTIMESTAMP en un CHARACTER. (Si el analizador XMLNSC ha analizado originalmente el elemento y tenía un indicador de huso horario, el indicador de huso horario también se graba en el campo del mensaje de salida.)

  • En la versión 6.0, el analizador XMLNSC utiliza las series de ESQL predeterminadas de ESQL "TRUE" y "FALSE" cuando graba un campo de tipo BOOLEAN. Este uso no es compatible con la especificación Esquema XML 1.0.

    En la versión 7.0, el analizador XMLNSC graba "true" y "false", que es compatible con la especificación Esquema XML 1.0. Si necesita escribir series distintas de "true y "false", convierta el campo BOOLEAN en CHARACTER.

  • En la versión 6.0, el analizador XMLNSC no valida documentos XML con respecto a un Esquema XML generado a partir de un conjunto de mensajes.

    En la versión 7.0, el analizador XMLNSC ofrece esta función. Cuando se añade un conjunto de mensajes a un archivo BAR (archivo de archivador intermediario), si la propiedad Dominio de mensajes de cada archivo de definición de mensaje se configura XMLNSC, se genera un Esquema XML para cada archivo de definición de mensajes del conjunto de mensajes, para el uso potencial por parte del analizador XMLNSC. Este Esquema XML sólo lo comprueba el analizador XMLNSC cuando se despliega el archivo BAR.

    Sin embargo, las comprobaciones son más estrictas que las que lleva a cabo el editor del archivo de definición de mensajes, y el despliegue podría fallar. Si el despliegue falla, debe corregir el archivo de definición de mensajes para que sea compatible con las reglas del Esquema XML. Si el conjunto de mensajes contiene uno de los archivos de definición de mensajes Sobre SOAP suministrado por IBM® vuelva a realizar la importación utilizando el asistente de Nuevo archivo de definición de mensajes desde un mensaje suministrado por IBM.

Cambios de comportamiento en el analizador MRM

Se implementan los cambios siguientes en versión 7.0:

  • En versión 6.0, el formato físico TDS del analizador MRM de tipo Separaciones de elementos de datos, Longitud fija codificada, Delimitado codificado y Longitud codificada delimitada grababan cualquier atributo xsi:type que encontraban en el árbol de mensaje, utilizando un nombre de código "type".

    En la versión 7.0, el formato físico TDS presupone que todos los atributos xsi:type son específicos de XML y no los escribe.

  • En versión 6.0, el formato físico TDS de MRM de tipo Separaciones de elementos de datos, Longitud fija, Longitud fija AL3 tratab an un elemento con una longitud de TDS de cero como la longitud fija durante el análisis, pero como de longitud variable durante la escritura. Por consiguiente, todos los datos del árbol de mensaje para un elemento de este tipo se graba en la corriente de bits sin que se emita ninguna excepción.

    En la versión 7.0, el elemento se trata como si tuviera una longitud fija durante el análisis y la escritura. Por lo tanto, todos los datos del árbol de mensajes de este tipo de elemento hacen que se genere el mensaje BIP5436E a menos que haya establecido la propiedad de TDS Truncar en salida, en cuyo caso no se escribe nada.

  • En versión 6.0, se generaba el mensaje BIP5374E cuando se detectaba que faltaba un elemento de repetición obligatorio (minOccurs > 1) durante la validación de un mensaje MRM.
    En la versión 7.0, se detectan dos condiciones diferentes durante la validación:
    • Un elemento obligatorio que se repite pero que no tiene ninguna instancia en el árbol de mensajes. En este caso, se genera el mensaje BIP5378E, que proporciona detalles de los elementos que existían antes y después de la ubicación prevista del elemento que falta. Debido a este cambio, tal vez tenga que cambiar o mejorar los procesos de error automatizados que se lleven a cabo.
    • Un elemento obligatorio que se repite y que tiene el número incorrecto de instancias en el árbol de mensajes. En este caso, se genera el mensaje BIP5374E igual que antes, con los detalles de las instancias existentes y previstas de los elementos.

Información general sobre la migración

Se implementan los cambios siguientes en versión 7.0:

  • Un solo conjunto de mensajes puede contener modelos para los dominios MRM oIDOC y también para otros dominios como, por ejemplo, XMLNSC. En la versión 6.0, siempre se genera un archivo .dictionary para que lo utilice el analizador MRM cuando el conjunto de mensajes se añade a un archivo BAR.

    En la versión 7.0, solamente se genera el archivo .dictionary si ha especificado MRM o IDOC como dominio del mensaje predeterminado o si ha añadido MRM o IDOC en Dominios de mensajes soportados del archivo de conjunto de mensajes. Si ya no se genera ningún archivo .dictionary, añada MRM o IDOC en Dominios de mensajes soportados.

  • El analizador XML está en desuso y podría retirarse en un release futuro. Los flujos de mensajes existentes que utilizan el analizador XML siguen funcionando en la versión 7.0. Utilice el dominio XMLNSC para la mayoría de nuevos flujos de mensajes que necesiten analizar o escribir documentos XML. Para obtener más información, consulte Qué analizador XML debe utilizar.
  • El dominio IDOC y el analizador están en desuso y podrían retirarse en un release futuro. Los flujos de mensajes existentes que utilizan el analizador IDOC siguen funcionando en la versión 7.0. Utilice el formato físico TDS del dominio MRM para nuevos flujos de mensajes que tengan que analizarse o escribir IDOc ALE de SAP en formato de texto que proceden del enlace de WebSphere MQ para R3.
  • La ubicación y el etiquetaje de algunas propiedades MRM TDS se han actualizado; no hay ningún cambio de comportamiento asociado a estos cambios.
    • La propiedad Delimitador de elemento de repetición se ha movido a un recuadro etiquetado como "Apariciones", para conservar juntas todas las propiedades de repetición.
    • Las propiedades Coma decimal virtual y Precisión se mueven debajo del grupo de propiedades "Signo", para alinearlas con las propiedades CWF.
    • La propiedad Referencia de longitud no se ha utilizado para grupos locales, referencias de grupos y elementos complejos, y se elimina de las hojas de propiedad.
    • Ahora la hoja de propiedad del grupo local contiene dos recuadros etiquetados como "Identificación de campo", para distinguir la propiedad Patrón de datos del resto, porque el Patrón de datos no se aplica al propio grupo, sino a su inclusión en el grupo padre.
    • Ahora las propiedades de representación booleanas se visualizan con el prefijo "Texto" para distinguirlas de las nuevas propiedades booleanas binarias.
    • La propiedad Tipo físico con el valor de enumeración Carácter se cambia por el de Texto.
    • La propiedad Tipo físico con el valor de enumeración Estándar de mensajería alternativo se cambia por el de Específico de TLOG.
    • La propiedad Ajustar serie de longitud fija se cambia por la de Recortar en entrada y se ha desplazado a un nuevo recuadro etiquetado como "Series de longitud fija".
    • La propiedad Derivar longitud predeterminada del tipo lógico se ha movido a un nuevo recuadro etiquetado como "Valores generales".
  • La ubicación y el etiquetaje de algunas propiedades MRM CWF se han actualizado; no hay ningún cambio de comportamiento asociado a estos cambios.
    • La propiedad Formato se ha desplazado hasta la última sección "Representación física" para alinearla con las propiedades TDS.
    • La hoja de propiedades del elemento ahora tiene una sección etiquetada como "Representación numérica" que contiene el grupo de propiedades Signo y Coma decimal virtual para alinear estas propiedades con las propiedades TDS.
    • La propiedad Cuenta de longitud se cambia por la de Longitud para alinear esta propiedad con las propiedades TDS.
    • La propiedad Justificación de la serie se cambia por la de Justificación para alinear esta propiedad con las propiedades TDS.
    • La propiedad Signo EBCDIC personalizado se cambia por la de Signo EBCDIC personalizado superpuesto para alinear esta propiedad con las propiedades TDS.
    • Los valores de enumeración de la propiedad Orientación del signo Inicial y Final se cambian por los de Inicial superpuesto y Final superpuesto para alinear estas propiedades con las propiedades TDS.
    • Ahora las propiedades de orden de bytes del conjunto de mensajes se visualizan con el prefijo "Valor predeterminado" para alinear estas propiedades con las propiedades TDS.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última actualización
        
        Última actualización : 2012-08-03 10:58:19


Tema de tareaTema de tarea | Versión 7.0.0.5 | ah20250_