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 11. Example poll business object for a sequential data queue

Example poll business object for a sequential data queue

Figure 12. 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 13. 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 14. Sample poll business object for a keyed data queue

Sample poll business object for a keyed data queue

Copyright IBM Corp. 1997, 2004