Tivoli Connection Guide and Reference


Adding events as messages

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.

Initialize Tivoli Event DLL

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'

Application Startup Event

This event is generated when an application is started.

tvSendStartupEvent: aString

where aString is a text message

Example:TivApplicationStartupEvent new tvSendStartupEvent: 'MyApp', Date dateAndTimeNow

Application Close Event

This event is generated to close the TECEIF.DLL.

tvTecClose

Example:TivApplicationCloseEvent new tvTecClose

Application Shutdown Event

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

Application Idle Event

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'

Application Error Event

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'

SQL Error

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:

Application Send Event

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.


[ Top of Page | Previous Page | Next Page | Table of Contents ]