You can also add events to your application by adding event messages to your scripts, or methods. The following sections describe the message interface for each event.
This event is generated by your application to initialize the TECEIF.DLL. It is sent once and must precede other events.
tvInitTamEvents: source with: subSource
where sourceis the application name and subSourceis the application component name that generates this event
Example: TivInitTAMEvent new tvInitTamEvents: 'MyApp' with: 'InitComponent'
This event is generated when an application is started.
tvSendStartupEvent: aString
where aString is a text message
Example:TivApplicationStartupEvent new tvSendStartupEvent: 'MyApp', Date dateAndTimeNow
This event is generated to close the TECEIF.DLL.
tvTecClose
Example:TivApplicationCloseEvent new tvTecClose
This event is generated when an application is shutting down.
tvSendShutdownEvent: aString
where aString is a text message
Example: TivApplicationShutdownEvent new tvSendShutdownEvent: 'MyApp ',Date dateAndTimeNow
This event is generated when the program enters an extended period of inactivity.
tvSendIdleEvent: aString
where aString is a text message
Example: TivApplicationIdleEvent new tvSendIdleEvent: 'MyApp'
This event is generated when a critical application error occurs.
tvSendApplicationError: errorNum with: errorString
where errorNum is an error number and errorString is an appropriate error message string
Example: TivApplicationErrorEvent new tvSendApplicationError: 14 with: 'myapp.dll not found'
This event is generated when an application encounters an error when interfacing with an SQL database. If information is not available for some of the database fields, an empty string should be specified.
tvSendSQLError: anArray
where anArrayis an Array object that contains:
This event is used to send a generic event to the TECEIF interface. If you define a new event, it must also be defined to the Tivoli Enterprise Console. See the next section for an example of how to define a generic event.