IBM Enterprise Console manual AS/400 Message Adapter, Adapter Files

Chapter 3. AS/400 Message Adapter

The AS/400 message adapter forwards events from an AS/400 system to the event server. It can be registered with the startup configuration of the AS/400 system so that the adapter is started with all the other applications when the AS/400 system is started. See “Starting an AS/400 Adapter after an IPL” on page 52 for instructions on starting the adapter automatically with the AS/400 system.

The AS/400 message adapter is a program that does the following:

vReads messages from a message queue on an AS/400 system

vExtracts information from the message

vCreates IBM Tivoli Enterprise Console classes, using a class definition statement (CDS) file

vFilters IBM Tivoli Enterprise Console events that are not important, using a configuration file

vSends IBM Tivoli Enterprise Console events to an event server (using TCP/IP sockets) that runs user-created rules against these events

AS/400 message events can be gathered from any non-program message queue, including the system operator message queue QSYSOPR. Multiple AS/400 message adapters can be running at the same time. One AS/400 message adapter can monitor the system operator message queue while another is monitoring an application message queue.

A few of the benefits of the AS/400 message adapter are as follows:

vConsolidates the system operator message console, QSYSOPR, for all the AS/400 systems in your enterprise

vMonitors applications that use message queues

vFilters out messages that are not important and only notifies the Tivoli operators when something critical happens

vAutomatically acts on events using customer-defined rules and tasks (using the event server)

vCentrally configures adapter files that can be sent to remote AS/400 systems

Adapter Files

The AS/400 adapter package consists of the following files:

/QSYS.LIB/QUSRSYS.LIB/CFG_MSG.FILE/MSGCFG.MBR

The configuration file.

/QSYS.LIB/QUSRSYS.LIB/CFG_MSG.FILE/MSGCDS.MBR The CDS file.

/QSYS.LIB/QUSRSYS.LIB/CFG_MSG.FILE/MSGBRC.MBR

The BAROC file. This file is located on the event server with the name of as400msg.baroc. It is automatically compiled into the active rule base when the event server is installed.

Make a backup copy of the CFG_MSG file if you intend to modify the contents of any of the members.

© Copyright IBM Corp. 2002 39