Resolución de problemas al desplegar flujos de mensajes o conjuntos de mensajes

  1. Para depurar problemas al desplegar, consulte los archivos de anotaciones:
    • El registro de sucesos del dominio de intermediarios
    • Las anotaciones de error locales (el registro de sucesos o las anotaciones del sistema de Windows)
    • Las anotaciones de WebSphere MQ

    Estas anotaciones pueden estar en sistemas aparte y deben utilizarse conjuntamente con la salida del área de trabajo para asegurarse de que el despliegue ha sido satisfactorio.

    Utilice el mandato mqsilist para comprobar que el despliegue ha sido satisfactorio o consulte el registro de sucesos de Windows o el registro de sucesos del dominio de intermediarios.

  2. Utilice esta lista de comprobación cuando tenga problemas de despliegue:
    • Asegúrese de que el gestor de colas remoto esté en ejecución.
    • Asegúrese de que los canales estén en ejecución.
    • Visualice el estado del canal para ver si ha aumentado el número de mensajes del sistema enviados.
    • Compruebe el canal desde el extremo remoto.
    • Compruebe el nombre del gestor de colas.
    • Determine si el canal es un canal de clúster.

Este tema contiene consejos para solucionar algunos problemas comunes que pueden surgir al desplegar flujos de mensajes o conjuntos de mensajes.
Prepararse para desplegar:
Durante el despliegue:
Cancelación de un despliegue:
Después del despliegue:

Los flujos de mensajes migrados no están disponibles para añadir a un archivo archivador de intermediario

Aparece un error cuando añade un diccionario en un archivo archivador de intermediario

No puede arrastrar y soltar un archivo archivador de intermediario en un intermediario

No puede desplegar un flujo de mensajes que utiliza un flujo de mensajes de plug-in

No se ha generado el archivo de flujo de mensajes compilado (.cmf)

El flujo de mensajes se despliega en el sistema de prueba, pero en ningún otro sitio

El despliegue indica que el intermediario no existe

El Gestor de configuración está intentando desplegar en un intermediario que no existe

El Gestor de configuración informa que se ha quedado sin memoria

Aparece un error de nombre de correlación cuando se despliega en un intermediario de la Versión 2.1

Aparecen mensajes de error al desplegar en z/OS

No se produce la serialización esperada de la entrada para una cola compartida que sirve a varias instancias de un flujo de mensajes en z/OS

Los nodos MQe no funcionan como se espera después de desplegar en un intermediario de la Versión 6.0

Aparecen mensajes de error al desplegar

A continuación se listan los mensajes de error que se pueden generar durante un despliegue, junto con su explicación:

Mensaje BIP1106 con código de razón de WebSphere MQ 2030
  • Escenario: El mensaje de error BIP1106 se emite con el código de razón 2030 cuando se despliega un conjunto de mensajes de gran tamaño.
  • Explicación: El tamaño del mensaje sobrepasa la longitud máxima de mensaje de la cola de transmisión en el gestor de colas del intermediario.
  • Solución: Aumente la longitud máxima de mensaje para la cola de transmisión utilizando el mandato de WebSphere MQ alter qlocal ; la longitud máxima de mensaje es en bytes:
    alter ql(nombre_cola_transmisión) maxmsgl(104857600) 
    Consulte la publicación WebSphere MQ System Administration Guide para obtener más información sobre este mandato.
Mensaje BIP1106 con error de WebSphere MQ AMQ7463
  • Escenario: El mensaje de error BIP1106 se emite con el código de razón 2102 cuando se despliega un conjunto de mensajes de gran tamaño en un intermediario que comparte el gestor de colas con el Gestor de configuración. También aparece el error de WebSphere MQ AMQ7463 con el texto: Las anotaciones del gestor de colas <gestor de colas> están llenas.
  • Solución:
    1. Detenga el Gestor de configuración utilizando el mandato mqsistop.
    2. Detenga el intermediario utilizando el mandato mqsistop.
    3. Detenga el gestor de colas utilizando el mandato WebSphere MQ amqmdain: amqmdain end <gestor de colas>
    4. Inicie los servicios de WebSphere MQ desde el menú Inicio pulsando Inicio > Programas > IBM WebSphere MQ > WebSphere MQ Services.
    5. Pulse el botón derecho del ratón en el gestor de colas, pulse Propiedades y, a continuación, pulse el separador Anotaciones.
    6. Aumente el número de archivos primarios y secundarios, de forma que el tamaño total sea superior al mensaje de despliegue.
    7. Reinicie el Gestor de configuración utilizando el mandato mqsistart.
    8. Reinicie el intermediario utilizando el mandato mqsistart.
    9. Reinicie el gestor de colas utilizando el mandato WebSphere MQ amqmdain: amqmdain start <gestor de colas>
Mensaje BIP1538E
  • Escenario: El mensaje de error BIP1538E se emite con el código de razón 2218 cuando se despliega un conjunto de mensajes de gran tamaño.
  • Explicación: El tamaño del mensaje sobrepasa el tamaño máximo de mensaje en el canal.
  • Solución: Aumente el parámetro maxmsgl de canal en ambas parejas de canales, en ambos extremos, de la manera siguiente:
    1. En el gestor de colas del Gestor de configuración, emita el mandato de WebSphere MQ alter channel . Por ejemplo:
      alter chl(CM_to_BRK) chltype(sdr) MAXMSGL(104857600) 
      alter chl(BRK_to_CM) chltype(rcvr) MAXMSGL(104857600) 
    2. En el gestor de colas de intermediario, emita el mandato de WebSphere MQ alter channel. Por ejemplo:
       alter chl(BRK_to_CM) chltype(sdr) MAXMSGL(104857600) 
       alter chl(CM_to_BRK) chltype(rcvr) MAXMSGL(104857600)
    3. Detenga y reinicie cada uno de los canales para que estos cambios surtan efecto.
Mensaje BIP1536
  • Escenario: Ha definido un Gestor de configuración para que se ejecute con un ID de usuario y ha definido un intermediario para que se ejecute en un sistema distinto con un ID de usuario distinto. El despliegue es satisfactorio, pero aparece el mensaje de error BIP1536 cuando despliega flujos de mensajes y conjuntos de mensajes en el intermediario.
  • Explicación: El Gestor de configuración no puede inscribirse para suscripciones internas con el intermediario porque éste está ejecutándose bajo un ID y el Gestor de configuración está ejecutándose bajo otro ID. El intermediario y el Gestor de configuración transmiten mensajes internos en ambos sentidos, mediante publicación/suscripción. Estos mensajes se desplazan a través de WebSphere MQ, lo cual requiere ciertas autorizaciones.
  • Solución:
    • Asegúrese de que el ID de usuario del intermediario es miembro de los grupos mqm y mqbrkrs.
    • Defina el ID de usuario del intermediario en el sistema en el que se ejecuta el Gestor de configuración.
    • Defina el ID de usuario del Gestor de configuración en el sistema en el que se ejecuta el intermediario.
    • Asegúrese de que todos los ID estén en minúsculas de forma que sean compatibles entre sistemas.
Mensaje BIP1536 con mensaje BIP7017
  • Escenario: Aparecen los mensajes de error BIP1536 y BIP7017.
  • Explicación: El Gestor de configuración tiene un problema al registrar sus suscripciones internas en temas relativos al cambio de estado del intermediario, que intenta hacer cada vez que usted despliega una configuración completa. La causa del problema la da el mensaje BIP7017, que indica que está ejecutando un Servidor de nombres de usuarios configurado, pero que el intermediario en el que está desplegando no tiene el ID de usuario del servicio del Gestor de configuración en su memoria caché de usuario.
  • Solución: Realice las siguientes comprobaciones. Cuando identifica y corrige el problema, las suscripciones se registrarán correctamente la siguiente vez que despliegue:
    • Asegúrese de que el Servidor de nombres de usuarios se haya iniciado.
    • Asegúrese de que se hayan iniciado los canales de WebSphere MQ entre el Servidor de nombres de usuarios y el intermediario.
    • Asegúrese de que el ID de usuario esté presente en el dominio del Servidor de nombres de usuarios.
Mensaje BIP1835
  • Escenario: Aparece el mensaje de error BIP1835.
  • Explicación: El conjunto de mensajes que está desplegando produce un diccionario de conjunto de mensajes que sobrepasa el límite interno de 4MB. Esto podría deberse a que tiene muchas definiciones de mensaje grandes definidas en el mismo conjunto de mensajes.

    El tamaño de un conjunto de mensajes exportado no es una buena indicación del tamaño del diccionario del conjunto de mensajes que se genera en el momento del despliegue, porque el conjunto de mensajes exportado se almacena como XML. Esto puede ser muy detallado, pero el diccionario tiene un formato interno mucho más compacto.

  • Solución: Divida las definiciones de mensaje en varios conjuntos de mensajes más pequeños.
Mensaje BIP2045
  • Escenario: Aparece el mensaje de error BIP2045.
  • Explicación: Este mensaje indica que se ha intentado asignar un intermediario a un segundo Gestor de configuración (o reinicializado).

    Cada intermediario se identifica con un UUID (identificador universalmente exclusivo), que se asigna cuando el Kit de herramientas de Message Brokers o el Proxy del Gestor de configuración crea una definición para el intermediario. Cuando se produce el despliegue, se realiza una comprobación de UUID para evitar el despliegue accidental de cambios en los intermediarios que no están bajo el control del Gestor de configuración. Si ha recibido el error BIP2045, el mensaje de despliegue se dirigió a un intermediario con un UUID, pero el mensaje lo ha procesado un intermediario que estaba esperando un UUID distinto.

  • Solución: Si es posible, vuelva a emitir la solicitud de despliegue utilizando el Gestor de configuración que administra este intermediario.

    Si esto no es posible, utilice el método BrokerProxy.setUUID() de la API del Proxy del Gestor de configuración para establecer el UUID de la definición del intermediario del Gestor de configuración de forma que sea el UUID que el intermediario está esperando. Esta API también se puede llamar utilizando el ejemplo Prácticas con API del Proxy del Gestor de configuración.

    Al llamar este método, el Gestor de configuración puede desplegar en el intermediario, aunque los recursos que se hubieran desplegado anteriormente en el intermediario no los supervisa el Gestor de configuración (a menos que ya se estuvieran supervisando).

    Si todavía no puede efectuar el despliegue, siga estos pasos:
    1. Suprima el componente de intermediario, sus tablas de configuración y su gestor de colas.
    2. Elimine la definición de intermediario del dominio utilizando el Kit de herramientas de Message Brokers o el Proxy del Gestor de configuración.
    3. Despliegue de nuevo la topología.
    4. Vuelva a crear el componente de intermediario y añada una referencia al mismo utilizando el Kit de herramientas de Message Brokers o el Proxy del Gestor de configuración.
    5. Despliegue de nuevo los recursos en el intermediario.

    Para evitar que se reproduzca este problema cuando suprime o vuelve a crear intermediarios, elimine siempre la definición de intermediario del dominio y despliegue la topología satisfactoriamente antes de detener y suprimir el intermediario que se está ejecutando.

Mensaje BIP2066
  • Escenario: Aparece el mensaje de error BIP2066.
  • Explicación: La petición de despliegue no fue reconocida por el grupo de ejecución antes de que finalizara el tiempo de espera de intermediario ConfigurationTimeout más ConfigurationDelayTimeout (por omisión, 60 segundos).
  • Solución: Cambie estos tiempos de espera utilizando los indicadores -g y -k de los mandatos mqsicreatebroker y mqsichangebroker.
Mensaje BIP2242
  • Escenario: Aparece el mensaje de error BIP2242.
  • Explicación: La petición de despliegue (cambio de configuración) no se ha aceptado antes de que caducara el tiempo de espera de intermediario ConfigurationTimeout (valor por omisión 300 segundos). El tiempo de espera debe ser lo suficientemente largo para que el flujo de mensajes complete el proceso del mensaje actual y, a continuación, acepte la petición de despliegue.
  • Solución: Consulte Mandatos para obtener más detalles sobre cómo establecer estos tiempos de espera utilizando los indicadores -g y -k de los mandatos mqsicreatebroker y mqsichangebroker.
Error de validador de serie de caracteres codificada/delimitada (TDS)
  • Escenario: Intenta desplegar un conjunto de mensajes con un formato físico TDS que tiene un error.
  • Explicación: El siguiente extracto de unas anotaciones de error ilustra un error de validador de TDS. En este caso, la causa del problema es que el elemento Town no tiene definido un código.
    TDS Extractor Trace File
    ========================
    
    Beginning Extract..
    
    Extracting Identification Info
    Extracting Project Info
    Extracting Messages
    Extracting Elements
    Extracting Compound Types
    Extracting Type Members
    Extracting Type Members
    Extracting Type Members
    Extracting Type Members
    Extracting Type Members
    Beginning Indexing..
    
    Creating Member IDs to Tags Index Table.
    
    Beginning Validation..
    
    Validating Project
    Validating Types
    ERROR: TDSValidator::ValidateTypeMemberSimpleElement:
      Simple elements in a type with Data Element Separation attribute = Tagged 
      Delimited must have the following attribute set:
      Element Level - Tag
    (Element ID: Town)
    (Type ID: AddressType)
    Return Code: -80
    
    Validating Messages
    
    Trace Info
    ===========
    EXCEPTION: TDSValidator::Validate:
      TDS Validation failed.
        1 errors
        0 warnings
    Return Code: -1
  • Solución: Utilice la información de las anotaciones de error para rectificar el problema.

Se emite el mensaje de error BIP2432E al desplegar de un Gestor de configuración Versión 6.0 a un intermediario de la Versión 2.1

Al cancelar un despliegue, mqsilist muestra un flujo de mensajes en un grupo de ejecución, pero las herramientas no lo muestran

No se le notifica el resultado de un despliegue

No recibe la confirmación de que el despliegue ha sido satisfactorio

No puede ver ningún conjunto de mensajes o flujo de mensajes desplegado.

Un intermediario suprimido sigue apareciendo en el navegador del dominio

El nodo XMLTransformation no funciona después del despliegue

Hay dos escenarios que explican por qué el nodo XMLTransformation no funciona después del despliegue:

Aparecen mensajes de error indicando que no se han encontrado las hojas de estilo

Ha obtenido resultados de transformación inesperados.

  • Escenario: Ha obtenido resultados de transformación inesperados.
  • Explicación: En los flujos de mensajes complejos, puede producirse incompatibilidad entre hojas de estilo y archivos XML, después de un despliegue. Hay dos motivos probables:
    • Sólo se ha desplegado y actualizado parte de las hojas de estilo o archivos XML cooperantes (puede deberse a un error en el sistema de archivos).
    • Varios nodos XMLT ejecutándose dentro del mismo grupo de ejecución deberían utilizar hojas de estilo compatibles, pero están utilizando versiones distintas para procesar el mismo mensaje de entrada.
  • Solución: Si sólo se han desplegado y actualizado parte de las hojas de estilo o archivos XML cooperantes, resuelva cualquier incompatibilidad volviendo a desplegar las versiones compatibles. Para evitar que varios nodos XMLT utilicen versiones distintas de la hoja de estilo, detenga los flujos de mensajes relevantes en el grupo de ejecución de destino antes de realizar el despliegue y, a continuación, reinicie los flujos.
Conceptos relacionados
Visión general del despliegue
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 11/11/2005
au16540_