Nodo Datos

Este nombre identifica la base de datos apropiada tal como se la conoce en el sistema en el que se va a ejecutar el flujo de mensajes. El nodo de integración se conecta a esta base de datos con la información de ID de usuario y contraseña que ha especificado en el mandato mqsisetdbparms .

Si el ESQL que está asociado a este nodo incluye una sentencia PASSTHRU o una función SELECT y una referencia a base de datos, debe especificar un valor para la propiedad Origen de datos.

El archivo ESQL, que de forma predeterminada tiene el nombre <message_flow_name>.esql, contiene ESQL para cada nodo del flujo de mensajes que lo requiere. Cada parte del código relacionada con un nodo específico se denomina módulo. Cuando codifica sentencias ESQL que interactúan con tablas, se da por hecho que esas tablas existen dentro de esta base de datos. Si no existen, el nodo de integración genera un error de base de datos durante la ejecución.

Codifique sentencias ESQL para personalizar el comportamiento del nodo Datos en un archivo ESQL asociado al flujo de mensajes en el que ha incluido esta instancia del nodo Datos . Si no existe un archivo ESQL para este flujo de mensajes, efectúe una doble pulsación en el nodo Datos o pulse con el botón derecho del ratón en el nodo y pulse Abrir ESQL para crear y abrir un nuevo archivo ESQL en la vista del editor ESQL.

Si existe un archivo ESQL, pulse Examinar junto a la propiedad Declaración para visualizar el recuadro de diálogo Selección de módulo, que lista los módulos de nodo Datos disponibles que están definidos en los archivos ESQL a los que puede acceder este flujo de mensajes (los archivos ESQL se pueden definir en otros proyectos dependientes, dependientes). Seleccione el módulo apropiado y pulse Aceptar. Si no hay disponibles módulos apropiados, la lista está vacía.

Si el módulo que ha especificado no existe, se crea automáticamente y el editor lo muestra. Si el archivo y el módulo existen, el editor resalta el módulo adecuado. Si se crea un esqueleto de módulo para este nodo en un archivo ESQL nuevo o ya existente, consta del ESQL siguiente. En este ejemplo se muestra el nombre de módulo predeterminado:

CREATE DATABASE MODULE <flow_name>_Database
       CREATE FUNCTION Main() RETURNS BOOLEAN
       BEGIN
               RETURN TRUE; 
       END;
END MODULE;

Si crea su propio módulo ESQL, debe crear este esqueleto exactamente tal como se muestra. Puede actualizar el nombre predeterminado, pero asegúrese de que el nombre que especifique coincida con el nombre de la propiedad de nodo Sentencia correspondiente.

Para personalizar este nodo, añada su propio ESQL después de la sentencia BEGIN y antes de RETURN TRUE. Puede utilizar todas las sentencias ESQL incluyendo SET, WHILE, DECLARE y IF en este módulo, pero (a diferencia del nodo Cálculo ) el nodo Datos propaga, sin cambios, el mensaje que recibe en su terminal de entrada a su terminal de salida. Por lo tanto, al igual que el nodo Filtro , sólo tiene un mensaje al que hacer referencia en un nodo de Datos .

• Automática (el valor predeterminado). El flujo de mensajes, del que forma parte el nodo Datos , se confirma si es satisfactorio; es decir, las acciones que se definen en el módulo ESQL se realizan y el mensaje continúa a través del flujo de mensajes. Si el flujo de mensajes da error, la acción se restituye. Si selecciona Automático, la capacidad de confirmar o retrotraer la acción del nodo Datos en la base de datos depende del éxito o la anomalía de todo el flujo de mensajes.
• Confirmar. Para confirmar todas las acciones no confirmadas realizadas en este flujo de mensajes en la base de datos conectada a este nodo, independientemente del éxito o error del flujo de mensajes como un todo, seleccione Confirmar. Los cambios en la base de datos se confirman incluso si el flujo de mensajes propiamente dicho no se ejecuta correctamente.

Cuando selecciona el recuadro, el nodo gestiona todos los códigos de retorno positivos de la base de datos como errores y genera excepciones igual que si se tratase de errores negativos o más graves. Si no selecciona el recuadro, el nodo trata los avisos como códigos de retorno normales y no emite ninguna excepción. La advertencia más importante planteada es:not found, que se puede manejar de forma segura como un código de retorno típico en la mayoría de las circunstancias.

Si deselecciona el recuadro, incluya ESQL para comprobar si hay errores de base de datos que puedan devolverse después de cada llamada de base de datos que efectúe (para obtener esta información, puede utilizar SQLCODE y SQLSTATE). Si se ha producido un error, deberá gestionarlo en el flujo de mensajes para asegurarse de la integridad del nodo de integración y de la base de datos; el error se ignora si no lo gestiona a través de su propio proceso, debido a que ha decidido no utilizar el manejo de errores predeterminado mediante el nodo de integración. Por ejemplo, puede incluir la sentencia ESQL THROW para generar una excepción en este nodo, o puede utilizar el nodo Throw para generar su propia excepción en un punto posterior.