Adapters Guide
Page
Adapters Guide
First Edition September
Contents
TECADNW4.NLM
OpenView Adapter
Appendix C. Class Definition
Vi IBM Tivoli Enterprise Console Adapters Guide
Who Should Read This Guide
Preface
What This Guide Contains
IBM Tivoli Enterprise Console Library
Publications
Prerequisite Publications
Related Publications
Providing Feedback about Publications
Accessing Publications Online
Contacting Customer Support
Conventions Used in this Guide
Bold
Operating System-dependent Variables and Paths
Monospace
Adapter Overview
Understanding Adapters
How Events Get Sent to the Event Server
How Events Get to the Event Server From an Endpoint
IBM Tivoli Enterprise Console Adapters Guide
How Events Get to the Event Server From a Managed Node
Internationalization Support for Events
How Events Get to the Event Server From a Non-TME Adapter
Event Attributes
Event Information
Administrator
Attribute Name Contents Acl
Adapterhost
Causedate
Chair
Attribute Name Contents Serverpath
12121212
Severity
Datereception Eventhandle Serverhandle
Adapter Files
Cache File
File Location
Configuration File
File Format
Example
AdapterCdsFile=path
AdapterErrorFile=path
BufEvtMaxSize
BufEvtPath
FilterMode
FilterCache
NOUTF8CONVERSION
ServerPort
ServerLocation
Adapter Type Format
EventServer
TestMode
Event Filtering
Set FilterMode to
Adapter Example
Event Buffer Filtering
Baroc File
Class Authenticationfailure ISA Event Defines
Set BufferEvents to YES
END
Format File
Rule File
Select
Class Definition Statement File
Fetch IPNAME$SOURCEADDR MAP
Error
Error File
Utils
Parser
Initial Files
Adapter Startup Errors
Troubleshooting Adapters
All Adapters
Managed Node Adapters
Non-TME Adapters
QSYS.LIB/QUSRSYS.LIB/CFGALERT.FILE/ALRCFG.MBR
AS/400 Alert Adapter
QTMETECA02
AdapterCdsFile
Endtecadp
Filter
Value is QTMETECA02/QYAAFTR
Fetch Statement Example
Select Statement Example
$ACTIONCODE
$ADAPTERCORREL
Configuring the AS/400 Alert Filters Default Alert Filter
Starting the Adapter
Integrating with an Existing Alert Filter
FORCE*NO SEQ*FIFO
Arguments
Authorization
Qsysopr *USE Public *EXCLUDE
Stopping the Adapter
Comments
Context
Cntrld
Immed
Examples
Endtecadp Evtadpmycfg OPTION*CNTRLD DELAY60
Endtecadp Evtadpalertadp
Events Listing
Event Class Default Event Severity
Event Class Structure
AS400TECALERTADAPTER
SNA4xxxPerformance
Alert Type Default Severity
Troubleshooting the AS/400 Adapter
TCP/IP Considerations
Logging Events in Test Mode
Starting an AS/400 Adapter after an IPL
Adding an Autostart Job to Qsyswrk
Multiple AS/400 Alert Adapters
Changing the AS/400 Startup Program
Qsecofr
Configuration File
Postemsg
QSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCFG.MBR
AS/400 Message Adapter
QSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCDS.MBR The CDS file
QSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGBRC.MBR
QSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCDS.MBR
ProcessExistingMsgs
MAP Statement Example
Select 1$MSGID=PNV
Defer
$ALERTOPTION
Unattend
$DATACCSIDCONVERTSTATUS
$MSGFILELIBRARY
$MSGFILENAME
$MSGLIBRARYUSED
$MSGSEVERITY
$SENDTIME
$SENDPROGRAMNAME
$SENDUSERPROFILE
$SUBSOURCE
Starting the Adapter
Arguments EVTADPname
Flags
Stopping the Adapter
Option
Evtadp
Endtecadp Evtadpsysopr
Endtecadp Evtadpmyapp OPTION*CNTRLD DELAY60
Subsource
Event Class Default Severity
Hostname
Troubleshooting the AS/400 Adapter
Addaje Sbsdqsyswrk Jobtecamsgq JOBDQGPL/STARTADP
Multiple AS/400 Message Queues
Using FTP to Execute AS/400 Commands
Done Return Chgvar VAR&CPYR VALUE&CPYR Endpgm
IBM Tivoli Enterprise Console Adapters Guide
NetWare Log File Adapter Reference Information
NetWare Log File Adapter
Source
Prefiltering NetWare Events
EventId
Severity
PreFilter
PollInterval
PreFilterMode
Nwmsgversion
Attribute Source Subsource Default Value
Nwmsgid
Alertseverity
Alertclass
Alertlocus
Alertlocus NetWare Definition
Alertclass NetWare Definition
Following NetWare events are defined in the Baroc file
TECADNW4.NLM
Flags
Tecadnw4.nlm
Description
Examples
Troubleshooting the NetWare Log File Adapter
IBM Tivoli Enterprise Console Adapters Guide
OpenView Driver
OpenView Adapter
Reception of OpenView Messages
Determining the OpenView NNM Version
Event Correlation With NNM
Incoming Messages Format
Determining the OVsnmpEventOpen Filter Value
Testing Event Correlation With NNM
Testing Tools
Event Correlation Example
Adapter Files
HPOVFilter=filter
OpenView Event Example
WellBehavedDaemon
Object Identifier File
Starting and Stopping the Adapter
LRF File
Adapterhost
Origin
Forwardingagent
OVIFDeleted OVIFDescrChg
OpenView Traps
OpenView Traps Snmp Traps
Node Marginal
50790400
Troubleshooting the OpenView Adapter
IBM Tivoli Enterprise Console Adapters Guide
Tecuninstal.cmd
OS/2 Adapter
UnmatchLog
Event Class
Source OS2 Subsource OS2
Numeric Value Literal Value
Troubleshooting the OS/2 Adapter
Snmp Adapter
Server Configuration
Snmp Driver
Reception of Snmp Messages
AdapterSpecificFile=path
Snmp Event Example
Name object identifier
Warm Start
Cold Start
CBT
Event Class Event Severity
Snmp Traps Generic Traps
Rules Listing
Enterprise-specific Traps
Baroc File Changes
Creating a New Snmp Trap Event
Tecadsnmp.baroc Tecadsnmp.cds Tecadsnmp.oid
Begin Imports
Agent-independent Data
OBJECT-TYPE From RFC-1212 TRAP-TYPE From RFC1215
Description
Status optional
$SPECIFIC=1
Class Definition Statement File Changes
Object Identifier File Changes
Troubleshooting the Snmp Adapter
Tecclass
END Tecclass
Cconfigurationfile
Controlling Event Traffic at the Gateway
IBM Tivoli Enterprise Console Gateways
Example
120 ÷ 2 =
Worksheets and Calculations
Event Send Adjusted EventSendThreshold BufferFlushRate
Unix
Microsoft Windows
GatewayAckInterval
Tec/gatewaycache@EventServer#tmr-central
GatewayQueueSize
GatewayTMEAckEnabled
GatewaySendInterval
MaxGWCacheSizeMegs
IBM Tivoli Enterprise Console Adapters Guide
Unix Log File Adapter
Event Server Configuration
Init.tecadlogfile -s start stop AdapterID
Running Multiple Unix Log File Adapters
Tecadlogfile.cfg
Logdefault.rls
Init.tecadlogfile
Logfilegencds
Hostname hostname
Nfsok Harmless
OservGracefulExit
Nisok Harmless
Nfsok Nisok
Default Rules
LogfileAmd LogfileCron LogfileOserv LogfileDateSet
Troubleshooting the Unix Log File Adapter
IBM Tivoli Enterprise Console Adapters Guide
Windows Event Log Adapter
Tecadwin.baroc
Default
HostnameIsAdapterHost
English
NumEventsToCatchUp
Wineventlogs
SpaceReplacement
Prefiltering Windows Log Events
EventType
ApplicationEventsProcessed
Registry Variables
ApplicationEventsProcessedTimeStamp
DirectoryEventsProcessed
DNSEventsProcessed
DirectoryEventsProcessedTimeStamp
DNSEventsProcessedTimeStamp
FileReplicationEventsProcessed
Low Memory Registry Variables
Select Create Administrators from the Administrators icon
Adapter Administrator Roles for Windows
Type in System in the Set Login Names dialog
Event Class Severity
Source NT Subsource Hostname
Ntsnmp
Tecadwin Command
Authorization none Arguments
Tecadwin.exe -d-c ConfigFile -L none EventLog
Tecadwin
Troubleshooting the Windows Event Log Adapter
IBM Tivoli Enterprise Console Adapters Guide
127
Windows NT Event Log Adapter
Tecadnt.err Error file
HKEYLOCALMACHINE\SYSTEM\
CurrentControlSet\Services\ TECNTAdapter\
Prefiltering Windows NT Log Events
Format File
Non-English Format Files
ApplicationEventsProcessedTimeStamp
Adapter Administrator Roles for Windows NT
Net start TECNTAdapter
Event Class Default Severity
Tecadnt Command
Tecadnt
Tecadnt.exe -d-c ConfigFile -L none EventLog