Configuring meta objects for polling

The iSeries adapter uses meta-objects for all the data queues that receive complete data queue message for changes to either the database or to the data files. You need to configure the meta-objects for all the data queues that receive complete data queue messages.

The meta-object name always starts with MO_iSeries. Each meta-object holds information about the data queues. You need to add a dummy verb to all the meta-objects.

The attributes (hostname, username, and password) within the meta objects have a static default value. These default attributes cannot be changed dynamically once the connector is started, since these values are cached in the connector agent. To access the same data queue on a different machine, you must either change the default value and restart the iSeries adapter instance or configure another meta-object for the new machine information.

The verb in the Business object is set to appropriate string, while the DataQueueName attribute is set to the IFS File path of the data queue. The BusObjName attribute contains the name of the corresponding Business object (which contains the verb mentioned in the metaobject).The details read from the queue are filled in this Business object. The attributes of the metaobject are shown in the example below (Figure 11). The corresponding SamplePollBO is shown in Figure 12.

Figure 10. Example poll business object for a sequential data queue
Example poll business object for a sequential data queue
Figure 11. Corresponding SamplePollBO
Corresponding SamplePollBO

For keyed data queues, a key attribute called "key" will be added to the meta object as shown in Figure 13. The poll call will use the key information to get the corresponding message from the keyed data queue.

Figure 12. Example poll business object for keyed data queue
Example poll business object for keyed data queue

The corresponding example poll business object for keyed data queue is shown in Figure 14.

Figure 13. Sample poll business object for a keyed data queue
Sample poll business object for a keyed data queue

Copyright IBM Corporation 2003, 2005. All Rights Reserved.