Event-driven integration

So far you've been running your AssemblyLines as batch processes, manually starting them each time we want data to flow. We can also run AssemblyLines from the command line by invoking theTivoli Directory Integrator Server, like this¹:

   ibmdisrv -c examples/Tutorial/Tutorial1.xml -r CSVtoXML

Tivoli Directory Integrator provides a number of features for making your AssemblyLines event-aware, allowing the solutions to handle and respond to a wide variety of real-time triggers.

Examples of these triggers are:

• protocol requests coming over an IP port, like REST calls, SNMP and web services;

• new messages appearing on a queue;

• emails arriving in an Inbox;

• changes to data, for example in files, databases, directories, and Notes databases;

• schedule or timer-based AssemblyLine operations.

This is not a complete list, and we will find both inspiration and guidance in other Tivoli Directory Integrator literature, in the community websites and the newsgroups.

Handling these events in the solution can be done in a number of ways:

Connectors in Iterator Mode

Some Connectors allow you to configure timeout parameters for Iterator Mode. One example is the FileSystem Connector, which can be set up to read through a file to the end and then wait for new information to appear - so-called 'tail read'.

Other Connectors, like those for RDBMS Change detection and LDAP Changelog, work in a similar way. These Connectors allow you to build AssemblyLines that run continuously, waiting for new changes to appear in the connected system.

There is also a Timer Connector that runs in Iterator Mode and can be configured to drive your AssemblyLine at timed intervals according to a scheduling parameter. We will be testing this one shortly.

Tivoli Directory Integrator includes a Web Administration console as part of the standard installation. This browser-based application called the Administration and Monitoring Console (AMC) lets you monitor the health of the AssemblyLines, hot-load Configs to running Servers, start and stop ALs, and configure failure/response behavior to keep your integration solutions highly available. It can also be used to set up schedules for when your AssemblyLines should run. However, the Web Admin tool is beyond the scope of this Guide.

Connectors in Server Mode

A few specialized Connectors, like the HTTP Server Connector and the LDAP Server Connector, allow you to build solutions that process incoming requests from external clients, perform requested actions and reply with appropriate responses. We will be using the HTTP Server Connector in the next exercise.

Notifications and properties

Tivoli Directory Integrator has components that can subscribe to Tivoli Directory Integrator notification events, just as there are components (and script calls) for sending these events – even between distinct Tivoli Directory Integrator Servers running on different platforms.

This guide will take you on a closer look at AssemblyLine scheduling and at Connector Server mode.

• Scheduling AssemblyLines
  

• Service request AssemblyLines
  In this last exercise we will be building a web server AssemblyLine to provide a very simple user interface for launching your 'CSV2XML_LookupMode' AL; In other words, an HTTP service for initiating data transfers.

¹ The TDI Server provides a usage message when invoked with no commandline arguments: ibmdisrv