556 Integrating IBM Tivoli Workload Scheduler with Tivoli Products
10.3 Process overview
Figure 10-1 illustrates the high-level design of the process for integrating TBSM
with TWS Distributed.
Figure 10-1 High-level design
The IBM Tivoli Workload Scheduler event.log is dependent on the proper setup
of the configuration file BmEvents.conf. Refer to “Customizing the batchman
events configuration file” on page 664 for complete update instructions. At a
minimum, an event.log file must be defined and event messages must be
configured to log to this file.
Database
Server
Master
Domain
Manager
milan (AIX)
Common
Listener
event.log
adapter
batchman
SQL
Common
Listener
phoenix (win32)
event rule information
WORKLOAD SCHEDULER
BUSINESS SYSTEMS MANAGER
MQe
tokyo (win32)
Database
Server
Master
Domain
Manager
milan (AIX)milan (AIX)milan (AIX)
Common
Listener
event.log
adapter
batchman
SQL
Common
Listener
phoenix (win32)phoenix (win32)
event rule information
WORKLOAD SCHEDULER
BUSINESS SYSTEMS MANAGER
MQe
tokyo (win32)tokyo (win32)
Chapter 10. Integrating Tivoli Business Systems Manager 557
The TBSM adapter daemon maintains a connection with the TBSM Common
Listener. This adapter daemon is a Java application responsible for packaging
the data and sending it to the remote TBSM Common Listener.
The TBSM event rule information is stored on the TBSM SQL server in the
Adapter database. The event rule information consists of three tables in the
database that are named Adapter..EventRecognizer, Adapter..EventParser, and
Adapter..ObjectAttributes.
10.3.1 Adapter internals
Figure 10-2 on page 558 depicts the steps that are needed to implement a TBSM
adapter according to the cycle time. The steps are:
1. Event Collection
2. Event Tokenizer
3. Event Recognition
4. Event Parsing
5. Event Formatting and Forwarding
Tip: If the BmEvents.conf file is not found in the TWSHome directory, it may
be copied from the TWSHome/OV directory to the TWSHome directory. A
restart of batchman is required to pick up changes made to the
BmEvents.conf file.
Note: The syntax for notating tables in Microsoft SQL server is
Database..Tablename. We use this convention when referring to specific
tables in the Tivoli Business Systems Manager database.
558 Integrating IBM Tivoli Workload Scheduler with Tivoli Products
Figure 10-2 Adapter cycle event processing flow
The DriverPlugIn executable calls the event collector to collect the set of events
that have been generated since the last cycle and the event collector returns
them to the DriverPlugIn executable. DriverPlugIn then hands each of these
events to the event tokenizer.
Because not all events are simple space-delimited message strings, the event
tokenizer takes the events from the DriverPlugIn and normalizes the events of
different types, making the event source name the first item of an array. For
example,Tivoli Workload Scheduler messages are passed as TWS. This array is
passed to the event recognizer.
The event recognizer determines the message ID for a given message. The
event recognizer contains a recognition algorithm which computes an ID for a
Note: The cycle time is configured in the DriverPlugIns.conf file, on the
second line. By default, it reads:
CycleTime=120
This setting means that the cycle is initiated every 120 seconds. Take care
when changing this parameter.
Collector
Event source
Formatter-
Forwarder
Tokenizer
RecognizerParser
Tivoli
Business
Systems
Manager
Collector
Event source
Formatter-
Forwarder
Tokenizer
RecognizerParser
Tivoli
Business
Systems
Manager
Chapter 10. Integrating Tivoli Business Systems Manager 559
given message based on external rules to determine the message’s format and
interpretation. This is used by the recognizer to access a database table to
gather the recognition rules for the given source.
The Event Recognition Rule Table (an example is shown Table 10-1) shows the
possible message IDs and the criteria a message must meet to be given the
related message ID for each message source. In other words, if an event
satisfies the criteria, it is associated with the related message ID. If the message
does not satisfy any of the listed criteria, the recognizer returns UNKNOWN as a
message ID. UNKNOWN is a reserved word and should not be used as a
message ID. However, it can be a means of filtering out undesired events.
Table 10-1 Example Recognition Rule table
Figure 10-3 on page 560 diagrams the flow of the output and the input of each
module.
EvtSource EvtCat/Mesage ID RecCriteria
TWS TWS:101 ( _$_1 == 101 )
_TWS TWS:102 ( _$_1 == 102 )
... ... ...
Tip: Event sources that have an entry of TWS are events that are recognized.
If the event source has an entry of _TWS, the event is defined but is not
currently recognized. The table Adapter..EventParser should be changed with
care to activate or deactivate recognition of specific event types.
560 Integrating IBM Tivoli Workload Scheduler with Tivoli Products
Figure 10-3 Adapter flow diagram
Job $(name3) …TBSMTEXT
1TBSMPRIORITY
completedTBSMSTATUS
1TBSMALERTSTATE
res res …TBSMRESOURCE
class class …TBSMCLASSNAME
……
token6name6
token3name3
token1name1
Formatter-
Forwarder
Tivoli
Business
Systems
Manager
Collector
event
event
event
Tokenizer
token3
token2
token1
<source>
conf
RecognizerParser
Event source
token3
token2
token1
<msg id>
conf
Delimited list
Job $(name3) …TBSMTEXT
1TBSMPRIORITY
completedTBSMSTATUS
1TBSMALERTSTATE
res res …TBSMRESOURCE
class class …TBSMCLASSNAME
……
token6name6
token3name3
token1name1
Job $(name3) …TBSMTEXT
1TBSMPRIORITY
completedTBSMSTATUS
1TBSMALERTSTATE
res res …TBSMRESOURCE
class class …TBSMCLASSNAME
……
token6name6
token3name3
token1name1
Formatter-
Forwarder
Tivoli
Business
Systems
Manager
Collector
event
event
event
event
event
event
Tokenizer
token3
token2
token1
<source>
token3
token2
token1
<source>
conf
RecognizerParser
Event source
token3
token2
token1
<msg id>
token3
token2
token1
<msg id>
conf
Delimited list
Get Integrating IBM Tivoli Workload Scheduler with Tivoli Products now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
