Este tema contiene los apartados siguientes:
Utilice el nodo DataDelete para interactuar con una base de datos de un origen de datos ODBC especificado. El nodo DataDelete es un formato especializado del nodo Database y la interacción se limita a suprimir una o más filas de una tabla de la base de datos. Puede definir lo que se debe suprimir especificando sentencias de correlación que utilicen de algún modo los datos del mensaje de entrada para identificar la acción necesaria.
Puede establecer una propiedad para controlar si la actualización 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 DataDelete se representa en el área de trabajo mediante el icono siguiente:
Imagínese una situación en la que está llevando a cabo una promoción limitada. Las mercancías sólo están disponibles durante el período de la promoción y cada cliente sólo puede tener un artículo. Cuando se acaban las existencias de las mercancías de venta, desea eliminar los detalles correspondientes de la base de datos de existencias. Cuando se recibe un mensaje que contiene un pedido del último artículo, se desencadena el nodo DataDelete para dicho artículo de la base de datos.
Se puede configurar al transferir una instancia del nodo DataDelete 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 DataDelete 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, pulse en 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 DataDelete con ningún otro nodo que utilice correlaciones (por ejemplo, un nodo DataInsert). 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 DataDelete 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 DataDelete 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 | DataDelete | 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 DataDelete 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 DataInsert
Avisos |
Marcas registradas |
Descargas |
Biblioteca |
Soporte |
Información de retorno (feedback)
![]() ![]() |
ac04680_ |