SECTION 5 -- MESSAGE FUNCTION

The m_ package consists of one function, m_msg, which may be used to write messages to the session log and to the standard output device. Note that if session logging is disabled, the message is only written to the standard output device.

5.1 m_msg - Log a Message

CODE m_msg (message, key)

Function return:

SUCCESS: the message was successfully logged.
P_FAIL: general failure indication.

Arguments:

```
message: input, TEXT message[];
```
The text to be logged. The length must be less than or equal to 80 bytes.
```
key: input, TEXT key[];
```
The key to be associated with the message. The key is also saved for the default value of skey in the z_exit function.

m_msg logs a message to the standard output, and, if session logging is enabled, writes the message to the session log. A message in TAE is defined to be a key followed by general text. The format of the key is "facility-error". See Section 2.16 of the TAE Command Language (TCL) Programmer's Manual for more information on messages.

If the message text contains a "%", then it must be preceded by another "%".

z_init must be called to initialize standard output before any calls to m_msg are executed.

This function may not be used in an ASYNC-PROCESS job.