This topic contains the following sections:
Use the DataDelete node to interact with a database in the specified ODBC data source. The DataDelete node is a specialized form of the Database node, and the interaction is restricted to deleting one or more rows from a table within the database. You define what is deleted by defining mapping statements that use the data from the input message in some way to identify the action required.
You can set a property to control whether the update to the database is committed immediately, or deferred until the message flow completes, at which time the update is committed or rolled back according to the overall completion status of the message flow.
The DataDelete node is represented in the workbench by the following icon:
Consider a situation in which you are running a limited promotion. The goods are available only for the period of the promotion, and each customer can only have one item. When stocks of the sale goods run out, you want to remove their details from the stock database. When a message containing an order for the last item comes in, the DataDelete node is triggered to remove all the details for that item from the database.
When you have put an instance of the DataDelete node into a message flow, you can configure it. Right-click the node in the editor view and click Properties. The node's basic properties are displayed.
All mandatory properties for which you must enter a value (those that do not have a default value defined) are marked with an asterisk on the properties dialog.
Configure the DataDelete node as follows:
On z/OS systems, the broker uses the broker started task ID, or the user ID and password that were specified on the mqsisetdbparms command JCL, BIPSDBP in the customization data set <hlq>.SBIPPROC.
If you click Browse next to this entry field, a dialog is displayed listing all available mapping routines that are accessible by this node. Select the routine that you want and click OK. The routine name is set in Statement.
To work with the mapping routine associated with this node, right-click the node and click Open Mappings. If the mapping routine does not exist, it is created for you with the default name in the default file. If the file already exists, you can also open file <flow_name>_<node_name>.mfmap in the Navigator view.
A mapping routine is specific to the type of node with which it is associated; you cannot use a mapping routine that you have developed for a DataDelete node with any other node that uses mappings (for example, a DataInsert node). If you create a mapping routine, you cannot call it from any other mapping routine, although you can call it from an ESQL routine.
When you select the box, the node handles all positive return codes from the database as errors and generates exceptions in the same way as it does for the negative, or more serious, errors.
If you do not select the box, the node treats warnings as normal return codes, and does not raise any exceptions. The most significant warning raised is not found, which can be handled as a normal return code safely in most circumstances.
If you clear the box, you must handle the error in the message flow to ensure the integrity of the broker and the database: the error is ignored if you do not handle it through your own processing, because you have chosen not to invoke the default error handling by the broker. For example, you could connect the failure terminal to an error processing subroutine.
Click Cancel to close the dialog and discard all the changes that you have made to the properties.
The terminals of the DataDelete node are described in the following table.
Terminal | Description |
---|---|
In | The input terminal that accepts a message for processing by the node. |
Failure | The output terminal to which the input message is propagated if a failure is detected during the computation. If you have selected Treat warnings as errors, the node propagates the message to this terminal even if the processing completes successfully. |
Out | The output terminal that outputs the message following the execution of the database statement. |
The following tables describe the node properties; the column headed M indicates whether the property is mandatory (marked with an asterisk on the properties dialog if you must enter a value when no default is defined), the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the bar file to deploy it).
The DataDelete node Basic properties are described in the following table.
Property | M | C | Default | Description |
---|---|---|---|---|
Data Source | No | Yes | The ODBC data source name of the database in which reside the tables to which you refer in the mappings associated with this node (identified by the Statement property). | |
Statement | Yes | No | DataDelete | The name of the mapping routine that contains the statements that are to be executed against the database or the message tree. The routine is unique to this type of node. |
Transaction | Yes | No | Automatic | The transaction mode for the node. This can be Automatic or Commit. |
Treat Warnings as Errors | Yes | No | Cleared | Treat database SQL warnings as errors. If you select the check box, this action is performed. |
Throw Exception on Database Error | Yes | No | Selected | Database errors cause the broker to throw an exception. If you select the check box, this action is performed. |
The Description properties of the DataDelete node are described in the following table.
Property | M | C | Default | Description |
---|---|---|---|---|
Short Description | No | No | A brief description of the node. | |
Long Description | No | No | Text that describes the purpose of the node in the message flow. |
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
ac04680_ |