When a UTM application executes, openUTM generates messages that provide you with information on particular events.
A UTM message consists of a message number, a fixed message text and variable parts referred to as inserts. These inserts are dynamically assigned current values when the respective message is output. Examples of inserts are the name of the application or of the communication partner, counters, return codes, etc.
Each message is associated with an identifier - a message number. UTM message numbers always consists of the letter K or P followed by a three-digit number, e.g. K008; this is then followed by the actual message text.
UTM messages serve different purposes and can be sent to different recipients (message destinations). Within certain limits you can define message destinations yourself on an application-specific basis.
Some explanations and examples for UTM messages are listed below:
A user can be informed of a certain event at the terminal by means of a message and can be requested to make an input if necessary.
Example
During the sign-on check the password was found to be invalid. openUTM requests that the user repeat the KDCSIGN input at the terminal.
An event in the UTM application is logged by means of a message in the UTM log file SYSLOG. In this way, data is collected for monitoring the application run and for diagnostic purposes.
Example
A message informs you that a user has signed on to the application.If certain UTM messages are generated and you have defined the message destination MSGTAC for them, openUTM calls an event-driven program unit in the application (see section on "MSGTAC event service" in the openUTM manual „Programming Applications with KDCS”). This event service can, for example, issue asynchronous calls to the administrator using FPUT. This makes it possible to use programmed administration to react to events for which openUTM generates messages.
Example
If the event "service abort" occurs, message K017 or K055 is generated. The MSGTAC service can act on this message by locking the TAC, for example, and sending a message to the administrator.
In order to output a message, openUTM utilizes a message module specific to openUTM. This contains the properties and texts of all UTM messages.
You can, to a certain extent, structure the output of UTM messages for specific applications, see "section "Modifying message output".