Manuals / IBM / Computer Equipment / Network Router

IBM Enterprise Console manual Starting the Adapter

Models: Enterprise Console

1 194

Download 194 pages 8.78 Kb

Page 57

Starting the Adapter

The AS/400 message adapter includes the STRTECADP command that enables you to start an adapter. The command is described on the following pages.

Chapter 3. AS/400 Message Adapter 45

Image 57

IBM Enterprise Console manual Starting the Adapter

Contents

IBM Tivoli Enterprise Console Adapters GuideVersion GC32-0668-01Page IBM Tivoli Enterprise Console Adapters GuideVersion GC32-0668-01First Edition September Preface ContentsChapter 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 IBM Tivoli Enterprise Console Library PublicationsPrerequisite Publications Related PublicationsProviding Feedback about Publications Accessing Publications OnlineContacting Customer Support Conventions Used in this Guidebold Operating System-dependent Variables and PathsItalics MonospaceAdapter Overview Chapter 1. Understanding AdaptersHow 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 Attributes Event InformationAttribute Name serverpath listofstrings Stores information describing the rule engines that an event hasv datereception v eventhandle v serverhandle Adapter FilesCache File File Location Configuration FileFile Format ExampleAdapterCdsFile=path AdapterErrorFile=pathBufEvtMaxSize BufEvtPathFilterMode FilterCachegetporttimeoutusec getporttimeoutsecondsgetporttotaltimeoutseconds getporttotaltimeoutusecServerPort ServerLocationEvent Filtering TestMode1. Set FilterMode to IN 1. Set FilterMode to IN Event Buffer FilteringBAROC File Example2. Set BufferEvents to YES Format File Rule FileExample ExampleExample Class Definition Statement Filemodulename errorlevel outputfile Error FileERROR UTILSKERNEL Initial FilesSELECT FETCHAdapter Startup Errors Troubleshooting AdaptersAll Adapters Managed Node Adapters22 IBM Tivoli Enterprise Console Adapters Guide Non-TME AdaptersAdapter Files Chapter 2. AS/400 Alert AdapterQSYS.LIB/QUSRSYS.LIB/CFGALERT.FILE/ALRCFG.MBR QSYS.LIB/QUSRSYS.LIB/CFGALERT.FILE/ALRCDS.MBR The CDS fileENDTECADP Configuration FileAdapterCdsFile BufEvtPathFETCH Statement Example SELECT Statement ExampleClass Definition Statement File KeywordsPERMANENT, TEMPORARY, or IMPENDING PROBLEM $HOSTNAME Configuring the AS/400 Alert Filters Default Alert Filter$ADAPTERHOSTSNANODE $ALERTCDPTIntegrating with an Existing Alert Filter Starting the AdapterCRTDTAQ DTAQlibrary/name TYPE*STD MAXLEN592 FORCE*NO SEQ*FIFO STRTECADP AuthorizationSYNOPSIS DESCRIPTIONStopping the Adapter Context ENDTECADPComments AuthorizationExamples ENDTECADP EVTADPMYCFG OPTION*CNTRLD DELAY60ENDTECADP EVTADPALERTADP Event Class Structure Events ListingDefault Event Event ClassDefault Event Event ClassSeverity Troubleshooting the AS/400 Adapter Default SeverityAlert Type TCP/IP Considerations Logging Events in Test ModeStarting an AS/400 Adapter after an IPL Adding an Autostart Job to QSYSWRKChanging the AS/400 Startup Program Multiple AS/400 Alert AdaptersQSECOFR To create the configuration file, perform the following steps Configuration FileContext POSTEMSGExamples 38 IBM Tivoli Enterprise Console Adapters GuideAdapter Files Chapter 3. AS/400 Message AdapterQSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCFG.MBR QSYS.LIB/QUSRSYS.LIB/CFGMSG.FILE/MSGCDS.MBR The CDS fileAdapterCdsFile Configuration FileJobDescription 40 IBM Tivoli Enterprise Console Adapters GuideClass Definition Statement File MAP Statement ExampleSELECT Statement Example FETCH Statement Example$ALERTOPTION $ADAPTERHOSTDEFER IMMED$MSGFILELIBRARY $MSGFILENAME$MSGLIBRARYUSED $MSGSEVERITY$SENDTIME $SENDPROGRAMNAME$SENDUSERPROFILE $SUBORIGINStarting the Adapter Authorization FlagsSTRTECADP CommentsChapter 3. AS/400 Message Adapter Stopping the AdapterENDTECADP EVTADPname *ALL OPTION*CNTRLD *IMMED DELAYseconds AuthorizationDELAYseconds ENDTECADPENDTECADP EVTADPMYAPP OPTION*CNTRLD DELAY60 ExamplesENDTECADP EVTADPSYSOPR Event Class Structure Events Listingsubsource hostnameLogging Events in Test Mode Troubleshooting the AS/400 AdapterTCP/IP Considerations WRKJOB JOBnameStarting an AS/400 Adapter after an IPL Adding an Autostart Job to QSYSWRKChanging the AS/400 Startup Program Multiple AS/400 Message Queues Using FTP to Execute AS/400 CommandsConfiguration File DONE RETURN CHGVAR VAR&CPYR VALUE&CPYR ENDPGM54 IBM Tivoli Enterprise Console Adapters Guide NetWare Log File Adapter Reference Information Chapter 4. NetWare Log File AdapterError File Adapter FilesConfiguration File Prefiltering NetWare EventsSource EventIdPollInterval Format FilePreFilter PreFilterModeEvent Class Structure Events Listingnwmsgversion nwmsgidalertclass alertlocus60 IBM Tivoli Enterprise Console Adapters Guide The following NetWare events are defined in the BAROC fileTECADNW4.NLM Flags tecadnw4.nlmDescription ExamplesTroubleshooting the NetWare Log File Adapter 64 IBM Tivoli Enterprise Console Adapters Guide OpenView Driver Chapter 5. OpenView AdapterReception of OpenView Messages Determining the OpenView NNM VersionEvent Correlation With NNM Incoming Messages Formatenterprise agent-addrChapter 5. OpenView Adapter Determining the OVsnmpEventOpen Filter ValueTesting Event Correlation With NNM Testing ToolsThis trace file is located in $OVLOG/ecs/ecs-instance#/ecsin.evt# Event Correlation ExampleAdapter Files Class Definition Statement File OpenView Event ExampleHPOVFilter=filter WellBehavedDaemonKeywords Object Identifier File$COMMUNITY $ENTERPRISEStarting and Stopping the Adapter LRF FileError File name object identifierEvent Class Structure Events Listingsource subsourceEvent Class Default SeverityOpenView Traps OpenView Traps SNMP Traps50462720 Warnings Node Marginal50790402 Troubleshooting the OpenView AdapterSegment Marginal 5079040378 IBM Tivoli Enterprise Console Adapters Guide Configuration File Chapter 6. OS/2 Adapterinstall.exe The adapter installation assist executable fileFormat File Starting the AdapterUnmatchLog Events Listing Stopping the AdapterEvent Class Structure source OS2 subsource OS2Troubleshooting the OS/2 Adapter Chapter 7. SNMP Adapter Server ConfigurationSNMP Driver Reception of SNMP MessagesConfiguration File SNMP Event ExampleClass Definition Statement File KeywordsObject Identifier File Error FileStarting and Stopping the Adapter $AGENTADDRWarm Start Cold StartStopping the Adapter Events ListingHost on which the adapter runs adapterhostforwardingagent 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 Object Identifier File Changes Troubleshooting the SNMP Adapter94 IBM Tivoli Enterprise Console Adapters Guide c configurationfileChapter 8. IBM Tivoli Enterprise Console Gateways Controlling Event Traffic at the GatewayExample 3. Calculate the value for the EventSendThreshold keyword Configuration File Worksheets and CalculationsUNIX Microsoft WindowsUNIX /etc/Tivoli/tec/cache@EventServer#region tec/gatewaycache@EventServer#tmr-centralWindows $DBDIR/cache.dat@EventServer#region on managed nodes $TIVOLIHOME/tec/$ACTYPE.cache@ EventServer#region on endpointsGatewayQueueSize GatewayTMEAckEnabledGatewaySendInterval 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 logdefault.rls Configuration FileAdapter Files tecadlogfile.cfgFormat File Error FileClass Definition Statement File Events ListingEvent Class Default SeverityDefault Severity Event Class106 IBM Tivoli Enterprise Console Adapters Guide Event Class Default SeverityPrinterPaperOut PrinterTonerLow PrinterOffline PrinterOutputFull Default RulesPrinterPaperJam PrinterDoorOpen PrinterPaperOut PrinterTonerLow PrinterOffline PrinterOutputFullTroubleshooting the UNIX Log File Adapter RepeatedLoginFailure RepeatedLoginFailureFrom RootLoginSuccessFromLogfileAmd LogfileCron LogfileOserv LogfileDateSet 110 IBM Tivoli Enterprise Console Adapters Guide Adapter Files Chapter 10. Windows Event Log Adaptertecinstlwin.cmd tecadwins.exeDEFAULT Configuration Filetecadwin.baroc HostnameIsAdapterHostPreFilterLog=lognameEventId=value EventType=valueSource=value NumEventsToCatchUpPreFilterMode SpaceReplacementWINEVENTLOGS PreFilterLog=ApplicationSource=re’TEC.*’EventId Prefiltering Windows Log EventsThe UPS service terminated with service-specific error Jan 15 150619 1998 0 Error N/A ServiceControlManager 7024 \Format File SourceApplicationEventsProcessed Registry VariablesApplicationEventsProcessedTimeStamp DirectoryEventsProcessedDNSEventsProcessed DirectoryEventsProcessedTimeStampDNSEventsProcessedTimeStamp FileReplicationEventsProcessedTECInstallPath Low Memory Registry VariablesSecurityEventsProcessedTimeStamp SystemEventsProcessed1. Select Create Administrators from the Administrators icon Adapter Administrator Roles for Windows3. Type in SYSTEM in the Set Login Names dialog Starting the Adaptersource NT Event Class Structuresubsource hostnameNTPrinterWasSet tecadwin Command SYNOPSIS tecadwinDESCRIPTION EXAMPLESTroubleshooting the Windows Event Log Adapter 126 IBM Tivoli Enterprise Console Adapters Guide Adapter Files Chapter 11. Windows NT Event Log AdapterThe error file Configuration FileDEFAULT tecadnt.errNumEventsToCatchUp HKEYLOCALMACHINE\SYSTEM\ CurrentControlSet\Services\ TECNTAdapter\PreFilterLog=lognameEventId=valueEventType=valueSource=value Chapter 11. Windows NT Event Log AdapterSpaceReplacement Prefiltering Windows NT Log EventsPreFilterMode 130 IBM Tivoli Enterprise Console Adapters GuideEventId Format FileSource EventTypeRegistry Variables Non-English Format FilesApplicationEventsProcessed 132 IBM Tivoli Enterprise Console Adapters GuideApplicationEventsProcessedTimeStamp TECInstallPathPollingInterval SecurityEventsProcessed1. Select Create Administrators from the Administrators icon Adapter Administrator Roles for Windows NT3. Type in SYSTEM in the Set Login Names dialog Low Memory Registry VariablesStopping the Adapter Starting the AdapterEvents Listing Event Class StructureDefault Severity Event Class136 IBM Tivoli Enterprise Console Adapters Guide tecadnt Command tecadnt.exe -d -c ConfigFile -L none EventLog tecadntAuthorization 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 Format File Location Appendix B. Format File Referencev %lengths Format Specificationsv %lengths Log File Examplev %lengths+ v %tsu ’su su ’su succeeded for succeeded foron on Mappings Windows NT Examplestring constant DEFAULT keywordPRINTF statement LABEL keywordAdditional Mapping Considerations The following list describes how values were assigned Generating a New Class Definition Statement File for a TME Adapter Activating Changes Made with a Format FileNetWare log file UNIX log fileWindows NT event log Windows 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 MAP Statement MAPDEFAULT StatementExample nexpressionname objectidentifier Object Identifier to Name TranslationSELECT Class Definition Statement File Syntax Diagramskeydecl = 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 Notices Trademarks168 IBM Tivoli Enterprise Console Adapters Guide Obsolete term for GlossaryPage 5, 6 Index Special characters10, 24 CDS file keywords continued Page files continued Page Page TCP/IP continued Page 180 IBM Tivoli Enterprise Console Adapters Guide Page GC32-0668-01 Program Number 5698-TEC Printed in U.S.A