Tymeac Run Time Functions

This section details the Tymeac functions for

• Notification,
• Logging and
• Statistics

Tymeac Notification

The notification system is optional. It is simply a user-written Tymeac Function that Tymeac management classes call when there is a problem.

The Tymeac Monitor examines the internal structure looking for actual or potential problems.

An actual problem is that all Queue Threads are 'disabled'.

A potential problem is that a thread's processing or wait time is excessive.

The Monitor sends a message describing the problem to this Tymeac Function. Further processing is the customer's option.

You set this up similarly to any user Function:

• Define a Processing Application Class that accepts a String and does whatever you want with that String.
• Define a Queue with one thread.
• Define a Function with one Queue.
• Place the name of the Function in the GENERAL section of the Tymeac User Variables (Stand-a-lone) or Configuration File (DBMS).

Tymeac provides a sample notification Function, TyNotify, and sample notification Class, DemoNotify

Tymeac Log

Tymeac uses an internal logging system. Most messages, during the life time of the Server, are written to the log only if you specify that there is a log.

There are three choices for a log medium:

1. the DBMS LogTable
2. to a local file or 
3. to a user class

DBMS

You define a DBMS table. Tymeac will write log messages to the log.

Local File

You put the fully qualified name of the local file in the configuration file or preference data or in the User Variables Class. Tymeac will write log messages to the log.

User Class

You define an alternative class that Tymeac may call to pass the message. See Alternatives for information about where you may put the log.

This is optional.

Tymeac Statistics

Tymeac optionally writes statistics only if you specify that there is a repository.

There are three choices for a statistics repository:

1. the DBMS LogTable
2. to a local file or 
3. to a user class

DBMS

You define a DBMS table. Tymeac will write statistics to the repository.

Local File

You put the fully qualified name of the statistics file in the configuration file or preference data or in the User Variables Class. Tymeac will write statistics to the repository.

User Class

You define an alternative class that Tymeac may call to pass the message. See Alternatives for information about where you may put the repository.

Statistics are available by three methods.

1. At shut down,
2. at de-activation and
3. on request.

Shut Down

Tymeac shut down, optionally, writes statistics to the repository. The Statistics are written after all Tymeac Queue Threads stop processing.

De-activation

Tymeac inactivation optionally, writes statistics to the repository. The Statistics are written after the inactivation period expires.

The activation framework is ideal for unattended use. Tymeac starts and ends only when necessary. Each time Tymeac deactivates, it writes the statistics for the session to the repository. In this way system personnel may monitor the sessions use and possibly adjust the deactivation time.

On Request

The On Request statistics Class is TyStats.  Press the button. The Class writes statistics to the repository.

© 1998 - 2007 Cooperative Software Systems, Inc.  All rights reserved.