Manuals / IBM / Computer Equipment / Network Router

IBM manual IBM Tivoli Enterprise Console Adapters Guide

Models: Enterprise Console

1 194

Download 194 pages 8.78 Kb

Page 192

180IBM Tivoli Enterprise Console: Adapters Guide

Image 192

IBM manual IBM Tivoli Enterprise Console Adapters Guide

Contents

Adapters Guide IBM Tivoli Enterprise ConsoleVersion GC32-0668-01Page Adapters Guide IBM Tivoli Enterprise ConsoleVersion GC32-0668-01First Edition September Contents PrefaceChapter 2. AS/400 Alert Adapter Chapter 1. Understanding Adaptersiv IBM Tivoli Enterprise Console Adapters Guide Appendix C. Class Definition vi IBM Tivoli Enterprise Console Adapters Guide Preface Who Should Read This GuideWhat This Guide Contains Publications IBM Tivoli Enterprise Console LibraryPrerequisite Publications Related PublicationsAccessing Publications Online Providing Feedback about PublicationsContacting Customer Support Conventions Used in this GuideOperating System-dependent Variables and Paths boldItalics MonospaceChapter 1. Understanding Adapters Adapter OverviewHow Events Get Sent to the Event Server How Events Get to the Event Server From an EndpointThe TME adapters currently supported for an endpoint are the following Internationalization Support for Events How Events Get to the Event Server From a Managed NodeHow Events Get to the Event Server From a Non-TME Adapter Event Information Event AttributesAttribute Name Stores information describing the rule engines that an event has serverpath listofstringsAdapter Files v datereception v eventhandle v serverhandleCache File Configuration File File LocationFile Format ExampleAdapterErrorFile=path AdapterCdsFile=pathBufEvtMaxSize BufEvtPathFilterCache FilterModegetporttimeoutseconds getporttimeoutusecgetporttotaltimeoutseconds getporttotaltimeoutusecServerLocation ServerPortEvent Filtering TestMode1. Set FilterMode to IN Event Buffer Filtering 1. Set FilterMode to INBAROC File Example2. Set BufferEvents to YES Rule File Format FileExample ExampleClass Definition Statement File ExampleError File modulename errorlevel outputfileERROR UTILSInitial Files KERNELSELECT FETCHTroubleshooting Adapters Adapter Startup ErrorsAll Adapters Managed Node AdaptersNon-TME Adapters 22 IBM Tivoli Enterprise Console Adapters GuideChapter 2. AS/400 Alert Adapter Adapter FilesQSYS.LIB/QUSRSYS.LIB/CFGALERT.FILE/ALRCFG.MBR QSYS.LIB/QUSRSYS.LIB/CFGALERT.FILE/ALRCDS.MBR The CDS fileConfiguration File ENDTECADPAdapterCdsFile BufEvtPathSELECT Statement Example FETCH Statement ExampleClass Definition Statement File KeywordsConfiguring the AS/400 Alert Filters Default Alert Filter PERMANENT, TEMPORARY, or IMPENDING PROBLEM $HOSTNAME$ADAPTERHOSTSNANODE $ALERTCDPTIntegrating with an Existing Alert Filter Starting the AdapterCRTDTAQ DTAQlibrary/name TYPE*STD MAXLEN592 FORCE*NO SEQ*FIFO Authorization STRTECADPSYNOPSIS DESCRIPTIONStopping the Adapter ENDTECADP ContextComments AuthorizationExamples ENDTECADP EVTADPALERTADPENDTECADP EVTADPMYCFG OPTION*CNTRLD DELAY60 Events Listing Event Class StructureDefault Event Event ClassDefault Event Event ClassSeverity Troubleshooting the AS/400 Adapter Default SeverityAlert Type Logging Events in Test Mode TCP/IP ConsiderationsStarting an AS/400 Adapter after an IPL Adding an Autostart Job to QSYSWRKChanging the AS/400 Startup Program Multiple AS/400 Alert AdaptersQSECOFR Configuration File To create the configuration file, perform the following stepsPOSTEMSG ContextExamples 38 IBM Tivoli Enterprise Console Adapters GuideChapter 3. AS/400 Message Adapter Adapter FilesQSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCFG.MBR QSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCDS.MBR The CDS fileConfiguration File AdapterCdsFileJobDescription 40 IBM Tivoli Enterprise Console Adapters GuideMAP Statement Example Class Definition Statement FileSELECT Statement Example FETCH Statement Example$ADAPTERHOST $ALERTOPTIONDEFER IMMED$MSGFILENAME $MSGFILELIBRARY$MSGLIBRARYUSED $MSGSEVERITY$SENDPROGRAMNAME $SENDTIME$SENDUSERPROFILE $SUBORIGINStarting the Adapter Flags AuthorizationSTRTECADP CommentsStopping the Adapter Chapter 3. AS/400 Message AdapterAuthorization ENDTECADPContext CommentsExamples ENDTECADP EVTADPSYSOPRENDTECADP EVTADPMYAPP OPTION*CNTRLD DELAY60 Events Listing Event Class Structuresubsource hostnameTroubleshooting the AS/400 Adapter Logging Events in Test ModeTCP/IP Considerations WRKJOB JOBnameStarting an AS/400 Adapter after an IPL Adding an Autostart Job to QSYSWRKChanging the AS/400 Startup Program Using FTP to Execute AS/400 Commands Multiple AS/400 Message QueuesConfiguration File DONE RETURN CHGVAR VAR&CPYR VALUE&CPYR ENDPGM54 IBM Tivoli Enterprise Console Adapters Guide Chapter 4. NetWare Log File Adapter NetWare Log File Adapter Reference InformationError File Adapter FilesPrefiltering NetWare Events Configuration FileSource EventIdFormat File PollIntervalPreFilter PreFilterModeEvents Listing Event Class Structurenwmsgversion nwmsgidalertlocus alertclassThe following NetWare events are defined in the BAROC file 60 IBM Tivoli Enterprise Console Adapters GuideTECADNW4.NLM tecadnw4.nlm FlagsDescription ExamplesTroubleshooting the NetWare Log File Adapter 64 IBM Tivoli Enterprise Console Adapters Guide Chapter 5. OpenView Adapter OpenView DriverReception of OpenView Messages Determining the OpenView NNM VersionIncoming Messages Format Event Correlation With NNMenterprise agent-addrDetermining the OVsnmpEventOpen Filter Value Chapter 5. OpenView AdapterTesting Tools Testing Event Correlation With NNMEvent Correlation Example This trace file is located in $OVLOG/ecs/ecs-instance#/ecsin.evt#Adapter Files OpenView Event Example Class Definition Statement FileHPOVFilter=filter WellBehavedDaemonObject Identifier File Keywords$COMMUNITY $ENTERPRISELRF File Starting and Stopping the AdapterError File name object identifierEvents Listing Event Class Structuresource subsourceDefault Severity Event ClassOpenView Traps SNMP Traps OpenView Traps50462720 Warnings Node MarginalTroubleshooting the OpenView Adapter 50790402Segment Marginal 5079040378 IBM Tivoli Enterprise Console Adapters Guide Chapter 6. OS/2 Adapter Configuration Fileinstall.exe The adapter installation assist executable fileFormat File Starting the AdapterUnmatchLog Stopping the Adapter Events ListingEvent Class Structure source OS2 subsource OS2Troubleshooting the OS/2 Adapter Server Configuration Chapter 7. SNMP AdapterSNMP Driver Reception of SNMP MessagesSNMP Event Example Configuration FileClass Definition Statement File KeywordsError File Object Identifier FileStarting and Stopping the Adapter $AGENTADDRCold Start Warm StartStopping the Adapter Events Listingadapterhost Host on which the adapter runsforwardingagent Proxy agent that forwarded the event to the adapterRules Listing SNMP Traps Generic TrapsEnterprise-specific Traps Creating a New SNMP Trap Event BAROC File Changesv tecadsnmp.baroc v tecadsnmp.cds v tecadsnmp.oid Agent-independent Data SYNTAX INTEGER 0..4294967295 ACCESS not-accessible90 IBM Tivoli Enterprise Console Adapters Guide Page Class Definition Statement File Changes Troubleshooting the SNMP Adapter Object Identifier File Changesc configurationfile 94 IBM Tivoli Enterprise Console Adapters GuideChapter 8. IBM Tivoli Enterprise Console Gateways Controlling Event Traffic at the GatewayExample 3. Calculate the value for the EventSendThreshold keyword Worksheets and Calculations Configuration FileUNIX Microsoft Windowstec/gatewaycache@EventServer#tmr-central UNIX /etc/Tivoli/tec/cache@EventServer#regionWindows $DBDIR/cache.dat@EventServer#region on managed nodes $TIVOLIHOME/tec/$ACTYPE.cache@ EventServer#region on endpointsGatewayTMEAckEnabled GatewayQueueSizeGatewaySendInterval MaxGWCacheSizeMegsThe default value is @EventServer Event Server Configuration Chapter 9. UNIX Log File AdapterStarting the Adapter Running Multiple UNIX Log File Adapters Stopping the Adapterinit.tecadlogfile -s start stop AdapterID Configuration File logdefault.rlsAdapter Files tecadlogfile.cfgError File Format FileClass Definition Statement File Events ListingDefault Severity Event ClassDefault Severity Event Class106 IBM Tivoli Enterprise Console Adapters Guide Default Severity Event ClassDefault Rules PrinterPaperOut PrinterTonerLow PrinterOffline PrinterOutputFullPrinterPaperJam PrinterDoorOpen PrinterPaperOut PrinterTonerLow PrinterOffline PrinterOutputFullTroubleshooting the UNIX Log File Adapter RepeatedLoginFailure RepeatedLoginFailureFrom RootLoginSuccessFromLogfileAmd LogfileCron LogfileOserv LogfileDateSet 110 IBM Tivoli Enterprise Console Adapters Guide Chapter 10. Windows Event Log Adapter Adapter Filestecinstlwin.cmd tecadwins.exeConfiguration File DEFAULTtecadwin.baroc HostnameIsAdapterHostNumEventsToCatchUp PreFilterLog=lognameEventId=value EventType=valueSource=valueSpaceReplacement PreFilterModeWINEVENTLOGS PreFilterLog=ApplicationSource=re’TEC.*’Prefiltering Windows Log Events EventIdJan 15 150619 1998 0 Error N/A ServiceControlManager 7024 \ The UPS service terminated with service-specific errorFormat File SourceRegistry Variables ApplicationEventsProcessedApplicationEventsProcessedTimeStamp DirectoryEventsProcessedDirectoryEventsProcessedTimeStamp DNSEventsProcessedDNSEventsProcessedTimeStamp FileReplicationEventsProcessedLow Memory Registry Variables TECInstallPathSecurityEventsProcessedTimeStamp SystemEventsProcessedAdapter Administrator Roles for Windows 1. Select Create Administrators from the Administrators icon3. Type in SYSTEM in the Set Login Names dialog Starting the AdapterEvent Class Structure source NTsubsource hostnameNTPrinterWasSet tecadwin Command tecadwin SYNOPSISDESCRIPTION EXAMPLESTroubleshooting the Windows Event Log Adapter 126 IBM Tivoli Enterprise Console Adapters Guide Chapter 11. Windows NT Event Log Adapter Adapter FilesConfiguration File The error fileDEFAULT tecadnt.errHKEYLOCALMACHINE\SYSTEM\ CurrentControlSet\Services\ TECNTAdapter\ NumEventsToCatchUpPreFilterLog=lognameEventId=valueEventType=valueSource=value Chapter 11. Windows NT Event Log AdapterPrefiltering Windows NT Log Events SpaceReplacementPreFilterMode 130 IBM Tivoli Enterprise Console Adapters GuideFormat File EventIdSource EventTypeNon-English Format Files Registry VariablesApplicationEventsProcessed 132 IBM Tivoli Enterprise Console Adapters GuideTECInstallPath ApplicationEventsProcessedTimeStampPollingInterval SecurityEventsProcessedAdapter Administrator Roles for Windows NT 1. Select Create Administrators from the Administrators icon3. Type in SYSTEM in the Set Login Names dialog Low Memory Registry VariablesStarting the Adapter Stopping the AdapterEvents Listing Event Class StructureDefault Severity Event Class136 IBM Tivoli Enterprise Console Adapters Guide tecadnt Command tecadnt tecadnt.exe -d -c ConfigFile -L none EventLogAuthorization none Arguments c ConfigFileTroubleshooting the Windows NT Event Log Adapter 140 IBM Tivoli Enterprise Console Adapters Guide Appendix A. Files Shipped with Adapters 142 IBM Tivoli Enterprise Console Adapters Guide Appendix A. Files Shipped with Adapters 144 IBM Tivoli Enterprise Console Adapters Guide Appendix B. Format File Reference Format File LocationFormat Specifications v %lengthsLog File Example v %lengthsv %lengths+ v %tsu ’su su ’su succeeded for succeeded foron on Windows NT Example MappingsDEFAULT keyword string constantPRINTF statement LABEL keywordAdditional Mapping Considerations The following list describes how values were assigned Activating Changes Made with a Format File Generating a New Class Definition Statement File for a TME AdapterNetWare log file UNIX log fileWindows event log Windows NT event logNetWare log file UNIX log fileAppendix C. Class Definition Statement File Reference File FormatOperators Class Definition Statement File Details SELECTFETCH Note AS/400 adapters do not support KEY parts in CDS files FETCH Statement 1 ATTR=,$TYPE,VALUE=,41$TYPE=4 MAPDEFAULT Statement MAP StatementExample nexpressionObject Identifier to Name Translation name objectidentifierClass Definition Statement File Syntax Diagrams SELECTkeydecl = KEY ’’ kop ’,’ vopval ’’ aop = ’=’ PREFIX SUFFIX EXISTS Page 164 IBM Tivoli Enterprise Console Adapters Guide Notices IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A Trademarks Notices168 IBM Tivoli Enterprise Console Adapters Guide Glossary Obsolete term forPage Index Special characters 5, 610, 24 CDS file keywords continued Page files continued Page Page TCP/IP continued Page 180 IBM Tivoli Enterprise Console Adapters Guide Page Program Number 5698-TEC Printed in U.S.A GC32-0668-01