Comprobación de un nodo definido por el usuario

Debe desplegar los archivos de que consta su proyecto de nodo definido por el usuario en el entorno de trabajo antes de que el nodo definido por el usuario esté listo para ser utilizado. Puede hacerlo en un entorno de prueba utilizando la perspectiva de desarrollo de plugins en entorno de trabajoInicio del cambio, consulte Habilitación de las posibilidades de ejecución de PDEFin del cambio. Utilice la opción Ejecutar > Ejecutar como > Entorno de trabajo de ejecución para iniciar una copia nueva del entorno de trabajo que incluya los nodos adicionales. Para obtener más información acerca de esta perspectiva, consulte PDE Guide.

Puede ver los nodos nuevos de la paleta cuando abra el editor de flujos de mensajes. Para comprobar el nodo nuevo, añádalo a un flujo de mensajes (consulte Añadir un nodo de flujo de mensajes) y despliéguelo como lo hace de manera habitual. Cuando esté conforme con la definición del nodo, añada el nodo nuevo a la paleta de nodos normal del editor de flujo de mensajes (consulte la sección Distribución de una extensión definida por el usuario). Hasta que lo haga, los nodos nuevos sólo estarán disponibles en la sesión de entorno de trabajo de prueba.

Inicio del cambioCuando tiene una sesión de entorno de trabajo que incluye el nuevo nodo, puede desplegar un flujo de mensajes de prueba que contenga el nuevo nodo a un intermediario. Para poder desplegarlo, en primer lugar debe crear, compilar e instalar el nodo del plugin. Consulte Instalación de una extensión definida por el usuario en un dominio de intermediarios para obtener más información.Fin del cambio

Cuando haya configurado y desplegado un flujo de mensajes que contiene el nodo definido por el usuario y envíe un mensaje de prueba al mismo, hay varias herramientas de diagnóstico disponibles que le permitendeterminar si el nodo funciona y, si no funciona, qué es lo que ha ocasionado el error.
  1. Inicio del cambioUtilice las anotaciones de sucesos. Consulte Utilización del registro de sucesos desde una extensión definida por el usuario para obtener más información.Fin del cambio
  2. Consulte el registro de sucesos (consulte Editor del registro de sucesos para obtener información).
  3. Añada un nodo Trace al flujo de mensajes y compruebe la salida del mismo (consulte Nodo Trace para obtener información acerca de los nodos Trace).
  4. Utilice el depurador de flujos para depurar el flujo que contiene el nodo (consulte Prueba y depuración de aplicaciones de flujo de mensajes para obtener información).
Los siguientes mensajes de depuración ayudan 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" puede interpretarse como una función de implementación en C o un método de implementación de Java.

  • BIP3904: un mensaje de rastreo antes de llamar al 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 utiliza en el rastreo 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. Esto incluye todas las funciones de utilidad que empiezan 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 posibles de intermediario de mensajes incluyen elementos de sintaxis, nodos y analizadores.

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

  • BIP4146: un mensaje de depuración que se utiliza 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. Esto incluye todas las funciones de utilidad que empiezan con cpiSetElement*, donde * representa todos los nodos con esa raíz.

    Para obtener más información sobre la API de nodo definida por el usuario en lenguaje C, consulte API de analizador definido por el usuario en lenguaje C y API de nodo definido por el usuario en lenguaje C.

  • 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 de rastreo que aparece 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 de rastreo que aparece en la situación siguiente:
    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.
Consulte Resolución de problemas con extensiones definidas por el usuario para obtener una lista completa de las funciones de implementación.

Conecte el rastreo de usuario a nivel de depuración para ver estas entradas de rastreo. Si desea más información, consulte Utilización del rastreo.

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
Distribución de una extensión definida por el usuario
Referencia relacionada
Editor del registro de sucesos
Nodo Trace
Extensiones definidas por el usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as04505_