Antes de empezar
Para realizar esta tarea, ha de haber
completado las siguientes tareas:
Para poder depurar el
flujo de mensajes, debe conectar el depurador de flujos de mensajes al motor de flujos de mensajes (grupo de ejecución) donde se ha desplegado el flujo de mensajes e iniciar una sesión de depuración. Si lo desea, puede conectar el depurador de flujos de mensajes a varios motores de flujos de mensajes
que estén funcionando en los mismos sistemas principales o en otros distintos y, a continuación, depurar los flujos de mensajes simultáneamente.
No puede depurar flujos que se hayan desplegado en un grupo de ejecución de 64 bits; el depurador de flujos sólo da soporte a grupos de ejecución de 32 bits.
Para conectarse al motor de flujos de mensajes:
- Vaya a la Perspectiva de Administración de
intermediarios. Anote el nombre
del flujo de mensajes que se visualiza en el panel
Dominios.
- Abra el flujo de mensajes que desea depurar en el Editor de flujos de mensajes
efectuando una doble pulsación en su nombre en el panel Navegador de Administración de intermediarios.
- Añada un punto de interrupción a una conexión que lleve fuera del
nodo de entrada del
flujo de mensajes. La adición de este punto de entrada asegura que el
flujo de mensajes no se ejecute hasta el final antes de
que el usuario pueda empezar a
depurarlo.
El punto de interrupción aparece como un
. (Para obtener información sobre
la adición de un punto de interrupción, consulte el apartado Trabajo con puntos de interrupción en el depurador).
- Vaya a la Perspectiva de Depuración.
- Pulse la flecha desplegable en el icono Depurar
en la barra de herramientas y seleccione
Depurar para invocar el asistente Depurar
(crear, gestionar y ejecutar configuraciones). Consejo: Está creando una configuración de inicio de depuración. Si ya ha creado una, puede volver a iniciarla pulsando directamente en el icono
Depurar

.
Esta acción genera un error si se cumple cualquiera de las siguientes condiciones:
- No ha creado una configuración de inicio de depuración.
- El intermediario y el grupo de ejecución al que se había conectado
previamente ya no se están ejecutando.
- Se han reiniciado el intermediario y el grupo de ejecución y, por
tanto, tienen un nuevo ID de proceso (vea más abajo).
- En la lista de configuraciones, seleccione Depuración de Message Broker y pulse en el botón Nuevo. En la ventana aparecerá un conjunto de paneles con separadores, que empieza por Conectar.
Consejo: El botón Depurar permanece en gris hasta que se completan los campos del panel
Conectar. Después, puede elegir completar los campos de los demás paneles o ir directamente
a pulsar Depurar.
Los paneles del asistente son los siguientes:- Conectar: use este panel para
establecer una conexión con el motor de flujos de mensajes
mediante Rational Agent Controller. Debe completar todos los campos de este panel para poder pulsar en el botón
Depurar e iniciar una sesión de depuración.
- Número de puerto de Agent Controller
- Entre el número de puerto que desea utilizar.
- Proyecto de flujo
- Seleccione el proyecto de flujo.
- HostName
- Seleccione el sistema principal en el que está ejecutándose el
motor de flujos de mensajes. Si
el sistema principal
no aparece listado, entre el nombre del sistema principal o la dirección
IP del sistema principal en el campo Nombre
del sistema principal
(si el campo Nombre del sistema principal no está
disponible, primero pulse el botón
Restablecer y, a continuación, efectúe sus cambios).
- Motor de flujos de mensajes
- Seleccione el intermediario y el motor de flujos de mensajes que
desee depurar. En
el recuadro de lista que se abre cuando se pulsa el botón
Examinar, cada motor de flujos de mensajes está
listado como su número de proceso, seguido del nombre del intermediario y
el nombre del grupo de ejecución separado por dos puntos, por ejemplo:
IDproceso Nombre motor
--------- ---------------
5984 WMBV6BR:default
Si el motor de flujos de mensajes no aparece en el recuadro de lista, pulse en Renovar para
actualizar el recuadro de lista con los nombres de todos los motores
de flujos de mensajes que estén desplegados y
disponibles en el sistema principal. (Si el motor de flujos de mensajes no aparece en el recuadro de lista, intente reiniciar RAC en el sistema principal). Aparece una opción que le permite conectarse a cualquier grupo de ejecución que esté ejecutándose en el sistema principal de destino. Esto incluye grupos de ejecución que no tienen ningún flujo de mensajes desplegado.
Consejo: El número de proceso es el
PID de Windows, tal como aparece en el
Administrador de tareas de la página
Procesos. Se le informó del PID en el registro de sucesos cuando efectuó el despliegue, como se explica en el apartado
Despliegue de una topología de publicación/suscripción.
Ahora puede pulsar enDepurar para ir al paso siguiente o completar los otros paneles como se indica a continuación.
- Valores de depuración de Java: use este panel cuando desee depurar un nodo definido por el usuario Java o un nodo JavaCompute. El puerto de Java es el número de puerto especificado para la JVM del intermediario. Si no especifica ningún puerto, se inhabilitará la depuración de Java.
Consejo: - Establecimiento del puerto de depuración JVM de intermediario
- Para depurar un nodo JavaCompute, o un nodo definido por el usuario
que contenga código Java, el JVM de intermediario se debe
configurar con un número de puerto de depuración. Para establecer este valor, emita el mandato siguiente (en una sola línea):
mqsichangeproperties <nombre-intermediario> -e <nombre-grupo-ejecución>
-o ComIbmJVMManager -n jvmDebugPort -v <número-puerto>
Cuando este mandato haya terminado de ejecutarse, debe reiniciar el intermediario.
- Origen: use este panel para indicar al depurador dónde buscar los archivos de origen de flujo, la correlación, ESQL o Java durante la depuración. La vía de acceso de búsqueda puede ser un nombre de proyecto de Eclipse, una carpeta externa o un archivo comprimido. Puede especificar varias ubicaciones, pero el depurador busca siempre primero en el proyecto de flujos de mensajes que se haya especificado en el panel Conectar.
- Común: este panel no lo utiliza
directamente el depurador de flujos, sin embargo, si establece opciones en
él, entrarán en vigor. En Workbench User Guide encontrará información detallada.
- Pulse en el botón Depurar. En la vista
Depuración, se visualizan los nombres del sistema principal y el motor de flujos de mensajes seleccionados.
- Cuando el siguiente mensaje entra en el flujo de mensajes y
llega al punto de interrupción, el flujo de
mensajes hace una pausa, el icono de punto de interrupción cambia por
y se puede iniciar la depuración.
- En la vista Depuración, efectúe una doble pulsación en el flujo de mensajes que desea depurar. El flujo de mensajes se abre en el Editor de flujos de mensajes
y se pueden añadir más puntos de interrupción, se puede empezar a ejecutar pasos en el flujo, etc.
Consejo: Desde una sola entorno de trabajo, el depurador puede conectar con más
de un grupo de ejecución y depurar varios flujos de mensajes en distintos grupos de ejecución (y, por lo tanto,
múltiples mensajes) simultáneamente. Sin embargo, un flujo desplegado en un grupo de ejecución tan solo puede ser depurado por un usuario cada vez, por lo que si conecta su depurador a éste, ningún otro usuario podrá conectar un depurador al mismo tiempo.

El depurador de flujos de mensajes que se proporciona con la versión 6.0 puede depurar intermediarios
de ejecución de versiones anteriores. Seleccione la versión del intermediario que desea depurar marcando la opción correspondiente en el panel Selección de motor del asistente de Depuración, como se indica
arriba.
Para obtener más detalles de qué versión de Rational Agent Controller
(RAC) debe instalar en cada una de las plataformas de intermediario, consulteInstalación de Rational Agent Controller.
Ahora que ya ha llevado a cabo esta tarea,
puede continuar con una de las siguientes tareas:
