Messages in openUTM on BS2000 systems

The following components of UTM event reporting are included in the delivery package:

• the German standard message module KCSMSGS

• the English standard message module KCSMSGSE

• the message definition file SYSMSH.UTM.070.MSGFILE

The message definition file contains the message texts in German and English and forms the basis for the creation of user message modules.

You must declare user message modules in the configuration using the MESSAGE statement. If you do not issue a MESSAGE statement, the German standard message module KCSMSGS is used to output messages

If you want to use the English standard message module in your application, you must replace the German message module with the English message module in the library (see openUTM manual “Messages, Debugging and Diagnostics on BS2000 Systems”).

In order to internationalize your application you can create multiple user specific message modules in a variety of languages and include them in the configuration of a UTM application. In this way, UTM messages can be output to a terminal user in a variety of

languages within any given UTM application. The language used to communicate with the user depends on the locale (language identifier lang_id and territorial identifier terr_id) that you assign the user during generation as well as on the availability of the user message module which has been assigned an appropriate locale during generation.

If more than one message module is assigned for a UTM application, then a locale must be assigned to each message module.

MESSAGE statement in section  "MESSAGE - define a UTM message module" User message modules are defined with the following operands:

• MODULE=

  Name of the message module you want to incorporate in the configuration.

• LIB=

  Identifies the object module library from which the message module is loaded dynamically. If a generated message module modulename is not contained under the name lmodname in the library omlname when linking the application, the linkage editor reports that the module is missing. The message module can be loaded dynamically.

• LOCALE=

  Defines the language environment (locale) of the message module if language specific message modules have been created for specific message output. These national language message modules are used for users and LTERM partners whose language and territorial identifiers match the locale defined here. For further information, see "Internationalizing the application - XHCS support(BS2000 systems)".

USER statement in section "USER - define a user ID" and LTERM statement in section "LTERM - define an LTERM partner for a client or printer" With the following operand you specify the message module (and the language) which is used to output messages to the user/client:

• LOCALE=

  Language environment (locale) of the user/client.

Application message module and user message modules

If multiple message modules are used for an application, then a distinction is drawn between application and user message modules. The application message module is the message module in whose MESSAGE statement the locale specifications correspond to those in the MAX statement. The application message module has a special significance within the application. The message destination specifications entered for the application message module determine the destination for message output. The message destination specifications in the other message modules have no significance. The application message module is used to output messages to the message destinations SYSLST, SYSOUT and CONSOLE.

Messages to the destinations STATION, SYSLINE and PARTNER employ the message module whose lang_id and terr_id specifications (of the Locale) correspond to those of the user or LTERM partner for which the message is output. Here, the user specification takes priority over the LTERM partner specification, i.e. if a user is signed on when the message is output, openUTM uses the message module which corresponds to this user.

If a locale (lang_id, terr_id) for which there is no message module in the application has been generated for a user or LTERM partner, then the user or LTERM partner is assigned a message module which corresponds with the lang_id and for which no terr_id has been generated. If no such message module is present, the application message module is used to output messages to this user or LTERM partner.

MAX statement in section "MAX - define UTM application parameters" With the following operand you specify the message module which is used as application message module:

• LOCALE=

  The locale of the message module that is to be used as the application message module. A message module with this locale must be generated with a MESSAGE statement.