Este tema contiene los apartados siguientes:
Utilice el nodo DataInsert para interactuar con una base de datos del origen de datos ODBC especificado. El nodo DataInsert es un formato especializado del nodo Database y la interacción se limita a insertar una o más filas en una tabla de la base de datos. Puede definir lo que se debe insertar especificando sentencias de correlación que utilicen de algún modo los datos del mensaje de entrada para definir la acción necesaria.
Puede establecer una propiedad para controlar si la actualización de la base de datos se debe confirmar inmediatamente, o bien, si se debe diferir hasta que finalice el flujo de mensajes, cuando la actualización se confirma o se restituye según el estado de finalización global del flujo de mensajes.
El nodo DataInsert se representa en el área de trabajo mediante el icono siguiente:
Imagínese una situación en la que la empresa ha desarrollado un nuevo producto. Desde el departamento técnico le han enviado los detalles sobre el producto y debe extraer detalles del mensaje y añadirlos como una nueva fila en la base de datos de existencias.
Se puede configurar al transferir una instancia del nodo DataInsert a un flujo de mensajes. Pulse el botón derecho del ratón en la vista del editor y, a continuación, pulse en Propiedades. Se muestran las propiedades básicas del nodo.
Todas las propiedades obligatorias para las que debe entrar un valor (las que no tienen un valor por omisión definido) se muestran marcadas con un asterisco en el diálogo de propiedades.
Configure el nodo DataInsert tal como se indica a continuación:
En sistemas z/OS, el intermediario utiliza el ID de tarea iniciada del intermediario.
Si pulsa el botón en Examinar, situado junto a este campo de entrada, se muestra un diálogo en el que se listan todas las rutinas de correlación disponibles a las que puede acceder este nodo. Seleccione la rutina que desea y, a continuación, pulse en Aceptar. El nombre de la rutina se establece en Sentencia.
Para trabajar con la rutina de correlación asociada al nodo, pulse el botón derecho del ratón en el nodo y, a continuación, seleccione Abrir correlaciones. Si la rutina de correlación no existe, se crea automáticamente con el nombre por omisión en el archivo por omisión. Si el archivo ya existe, también puede abrir el archivo <nombre_flujo>_<nombre_nodo>.mfmap en la vista del navegador.
Una rutina de correlación es específica del tipo de nodo al que está asociada; no puede utilizar una rutina de correlación que ha desarrollado para un nodo DataInsert con ningún otro nodo que utilice correlaciones (por ejemplo, un nodo DataDelete). Si crea una rutina de correlación, no la puede invocar desde ninguna otra rutina de correlación, aunque puede invocarla desde una rutina ESQL.
Cuando selecciona el recuadro, el nodo maneja todos los códigos de retorno positivos de la base de datos como errores y genera excepciones utilizando el mismo procedimiento que para los 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. El aviso emitido más importante es not found, que se puede manejar, de modo seguro, como un código de retorno normal en la mayor parte de los casos.
Si deselecciona el recuadro, debe manejar el error en el flujo de mensajes a fin de garantizar la integridad del intermediario y de la base de datos: el error se ignora si no se maneja a través de procesos propios, puesto que se ha elegido que el intermediario no invoque el manejo de errores por omisión. Por ejemplo, puede conectar el terminal de anomalías a una subrutina de proceso de errores.
Pulse el botón en Cancelar para cerrar el diálogo y descartar todos los cambios que ha realizado en las propiedades.
Los terminales del nodo DataInsert se describen en la tabla siguiente:
Terminal | Descripción |
---|---|
Terminal de entrada | Terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Terminal de anomalías | Terminal de salida al que se propaga el mensaje de entrada si se detecta una anomalía durante el cálculo. Si ha seleccionado Tratar los avisos como errores, el nodo propaga el mensaje a este terminal, aunque el proceso se complete satisfactoriamente. |
Terminal de salida | Terminal de salida desde el que sale el mensaje después de la ejecución de la sentencia de base de datos. |
En las tablas siguientes se describen las propiedades del nodo; la columna que tiene el encabezamiento M indica si se trata de una propiedad obligatoria (marcada con un asterisco en el diálogo de propiedades si se debe especificar un valor cuando no se ha definido ningún valor por omisión), la columna que tiene el encabezamiento C indica que se trata de una propiedad configurable (se puede cambiar el valor cuando se añade el flujo de mensajes al archivo bar para su difusión).
Las propiedades básicas del nodo DataInsert se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Origen de datos | No | Sí | Nombre de origen de datos ODBC de la base de datos en la que residen las tablas a las que se hace referencia en las correlaciones asociadas a este nodo (identificado en la propiedad Sentencia). | |
Sentencia | Sí | No | DataInsert | Nombre de la rutina de correlación que contiene las sentencias que se van a ejecutar con respecto a la base de datos y el árbol de mensajes. La rutina es exclusiva de este tipo de nodo. |
Transacción | Sí | No | Automática | Modalidad de transacción para el nodo. Puede ser Automática o Confirmar. |
Tratar los avisos como errores | Sí | No | Deseleccionada | Tratar los avisos SQL de base de datos como errores. Si selecciona el recuadro de selección, se realiza esta acción. |
*Generar excepción en error de la base de datos | Sí | No | Seleccionada | Los errores de base de datos hacen que el intermediario emita una excepción. Si selecciona el recuadro de selección, se realiza esta acción. |
Las propiedades de descripción del nodo DataInsert se describen en la tabla siguiente:
Propiedad | M | C | Valor por omisión | Descripción |
---|---|---|---|---|
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Conceptos relacionados
Flujos de mensajes
Flujos de mensajes, correlaciones y ESQL
Tareas relacionadas
Configuración de DB2
Cómo decidir los nodos que utilizar
Configuración de flujos de mensajes coordinados
Manejo de errores en flujos de mensajes
Desarrollo de correlaciones
Edición de propiedades configurables
Referencia relacionada
Mandato mqsichangebroker
Mandato mqsicreatebroker
Mandato mqsisetdbparms
Nodo Database
Nodo DataDelete
Avisos |
Marcas registradas |
Descargas |
Biblioteca |
Soporte |
Información de retorno (feedback)
![]() ![]() |
ac04690_ |