Previous Topic: Naming Convention for MessagesNext Topic: Communication Methods


Message Facility Statements and Commands

This product provides statements and commands that are used exclusively by the message facility. Statements are used within message table files and are referenced during an initialization. Commands can be issued at any time to display or modify current message facility options.

TABLE Statement

The TABLE statement defines the primary message table to be used by the message facility. This table also allows you to indicate the language that is used within the message table. All subsequent MSG statements belong to the defined table. The language name can be any text string; it has no functional merit. The table and the language currently in use are displayed through the DISPLAY MSGTABLE command.

In the MIMMSGS file, the TABLE MIMMSGS,LANGUAGE=ENGLISH statement defines the MIMMSGS file as the primary message table from which all other files are called.

MSG Statement

The MSG statement is used to override the internally defined message attributes. The MSG definitions in the message tables that are shipped with CA MIM match the internally defined, default attributes. Any changes that are made to the message tables are noted during a CA MIM initialization by the MIM0866I and MIM0867I messages.

Only the following MSG statement parameter is valid in this product:

text

The content of the message you are writing in any language.

INCLUDE Statement

The INCLUDE statement is used in the primary message table to locate other message table files. During an initialization, the MSG statements found in those files are inserted at the point where the INCLUDE statement is defined.

For example, INCLUDE MICMSGS finds the message table that is named, MICMSGS, and inserts its MSG statements into the MIMMSGS file during CA MIM initialization.

DISPLAY MSGTABLE Command

The DISPLAY MSGTABLE command displays the primary message table name and language currently in use. This command also displays the MIM module, which contains the hard-coded default values for all messages that are managed by the message facility. This example illustrates this information:

MIM0822I MIM Message Tables
   Table       Language         Msg Count
   MIMDRMFM    ENGLISH.internal 1215
   MIMMSGS     ENGLISH           684
   MIIMSGS     ENGLISH           111
   MIAMSGS     ENGLISH            77
   MICMSGS     ENGLISH           108
   EDIMSGS     ENGLISH            21
   ICMMSGS     ENGLISH            21

The message table definitions that are contained in the MIMMSGS file override the internal default values that are located in the MIMDRMFM module.

MSGTABLE Command

The MSGTABLE command is used to change the primary message table after an initialization. This product loads the message tables during an initialization. After an initialization, changes to the message table files can be implemented immediately by issuing the MSGTABLE command.