Comprobación de un nodo definido por el usuario

Cuando haya creado e instalado los recursos necesarios, puede probar el nodo definido por el usuario:

Antes de empezar

Realice las siguientes tareas:

  1. Habilite el entorno de desarrollo de plug-ins de Eclipse. Esta tarea se describe en Habilitación de las posibilidades de ejecución de PDE. Para obtener más información sobre el PDE y la perspectiva Desarrollo de plug-ins, consulte la documentación PDE Guide.
  2. Pulse Ejecutar > Ejecutar como > Entorno de trabajo de ejecución para iniciar una nueva copia del entorno de trabajo que incluya sus nuevos nodos.
  3. Abra el Editor de flujos de mensajes. Los nuevos nodos aparecen en la paleta de nodos.
  4. Cree un flujo de mensajes que incluya su nodo. Lea Añadir un nodo de flujo de mensajes para obtener ayuda sobre cómo realizar esta tarea.
  5. Despliegue el flujo de mensajes en un intermediario. Esta tarea se describe en Despliegue de una aplicación de flujo de mensajes.
  6. Envíe un mensaje de prueba a través del flujo y busque los resultados que espera (por ejemplo, un mensaje colocado en una cola de destino). Tal vez tenga que escribir una aplicación para enviar el mensaje de prueba al flujo de mensajes.
  7. Utilice las herramientas de diagnóstico que se proporcionan para determinar si el nodo funciona o no, o qué es lo que ha fallado:
    1. Consulte Resolución de problemas con extensiones definidas por el usuario para ver una descripción de algunos problemas comunes y sus soluciones.
    2. Consulte el registro de sucesos. Encontrará información detallada en Editor del registro de sucesos.
    3. Escriba entradas en el registro de sucesos desde su nodo. Consulte Utilización del registro de sucesos desde una extensión definida por el usuario para obtener más información.
    4. Active el rastreo de usuario a nivel de depuración. Consulte Utilización del rastreo para obtener información detallada de cómo realizar esta tarea.

      Los siguientes mensajes de depuración los genera un rastreo de usuario para ayudarle a entender la ejecución de los nodos y analizadores definidos por el usuario:

      • BIP2233 y BIP2234: un par de mensajes de rastreo, antes y después de que se invoque una función de implementación de extensión definida por el usuario. Estos mensajes informan de los parámetros de entrada y el valor devuelto.

        En estos mensajes, una "función de implementación" se puede interpretar como una función de implementación en C o un método de implementación Java.

      • BIP3904: un mensaje de rastreo antes de invocar el método Java evaluate() de un nodo definido por el usuario.
      • BIP3905: un mensaje de rastreo antes de invocar la función de implementación en C cniEvaluate() (miembro iFpEvaluate de CNI_VFT) de un nodo definido por el usuario.
      • BIP4142: un mensaje de depuración que se detecta cuando se invoca una función de utilidad de nodo definido por el usuario, donde la función de utilidad altera el estado de un elemento de sintaxis. Se incluyen todas las funciones de programa de utilidad que se inician con cniSetElement*, donde * representa todos los nodos con esa raíz.
      • BIP4144 y BIP4145: un par de mensajes de rastreo de ciertas funciones de implementación que, cuando las invoca una extensión definida por el usuario, pueden modificar el estado interno de un objeto de intermediario de mensajes. Los objetos de intermediario posibles incluyen elemento de sintaxis, nodo y analizador.

        En estos mensajes, una "función de implementación" se puede interpretar como una función de implementación en C o un método de implementación Java.

      • BIP4146: un mensaje de depuración que se incluye en el rastreo cuando se invoca una función de utilidad de analizador definido por el usuario, donde la función de utilidad altera el estado de un elemento de sintaxis. Se incluyen todas las funciones de programa de utilidad que se inician con cpiSetElement*, donde * representa todos los nodos con esa raíz.
      • BIP4147: un mensaje de error de rastreo que aparece cuando una extensión definida por el usuario pasa un objeto de entrada no válido a una función de API de utilidad de extensión definida por el usuario.
      • BIP4148: un mensaje de error de rastreo que aparece cuando una extensión definida por el usuario provoca daños en un objeto de intermediario.
      • BIP4149: un mensaje de error que se incluye en el rastreo cuando una extensión definida por el usuario pasa un puntero de datos de entrada no válido a una función de API de utilidad de extensión definida por el usuario.
      • BIP4150: un mensaje de error que se incluye en el rastreo cuando una extensión definida por el usuario pasa datos de entrada no válidos a una función de API de utilidad de extensión definida por el usuario.
      • BIP4151: un mensaje de depuración que se incluye en el rastreo cuando cniGetAttribute2 o cniGetAttributeName2 establece el código de retorno en un valor inesperado. Los valores esperados son CCI_SUCCESS, CCI_ATTRIBUTE_UNKNOWN y CCI_BUFFER_TOO_SMALL. Cualquier otro valor es un valor inesperado.
      • BIP4152: un mensaje de depuración que se incluye en el rastreo en las siguientes situaciones:
        1. cniGetAttribute2 o cniGetAttributeName2 establece el código de retorno en CCI_BUFFER_TOO_SMALL.
        2. Se llama de nuevo a cniGetAttribute2 o cniGetAttributeName2 con el tamaño correcto de almacenamiento intermedio, pero el código de retorno se establece en CCI_BUFFER_TOO_SMALL.
    5. Añada un nodo Trace al flujo de mensajes y compruebe la salida que se genera.
    6. Utilice el depurador de flujos de mensajes para depurar el flujo de mensajes que contiene su nodo. Empiece por la Prueba y depuración de aplicaciones de flujo de mensajes.

Cuando el comportamiento del nodo esté completo y correcto, añada el nuevo nodo a la paleta normal de nodos del Editor de flujos de mensajes (consulte Empaquetado de un proyecto de entorno de trabajo de nodo definido por el usuario). Hasta que haga esto, los nuevos nodos están disponibles solamente en la sesión de entorno de trabajo de prueba.

Conceptos relacionados
Nodos de entrada definidos por el usuario
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario
Tareas relacionadas
Desarrollo de extensiones definidas por el usuario
Añadir un nodo de flujo de mensajes
Prueba y depuración de aplicaciones de flujo de mensajes
Resolución de problemas con extensiones definidas por el usuario
Empaquetado de un proyecto de entorno de trabajo de nodo definido por el usuario
Referencia relacionada
Editor del registro de sucesos
Nodo Trace
Extensiones definidas por el usuario
API de nodo definido por el usuario en lenguaje C
API de analizador definido por el usuario en lenguaje C
Información relacionada
API de extensiones Java definidas por el usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:56:09

as04505_