2.16 MESSAGES AND MESSAGE FILES

2.16.1 Message Formats

A TAE message is one line of text consisting of a message key followed by message text.

Example:

    [TAE-NOFILE]     The requested file cannot be found

In TAE, a proc writes a message using the TCL command PUTMSG (for procedures) or one of the subroutines XMPUT or m_msg (for processes). The key and the text are provided by the caller.

The format of the key is, by convention, "facility-msgid". The facility is an identifier for a program, a group of programs, or a subroutine package. The "msgid" uniquely identifies the message within the facility. The maximum length of a key is 17 characters. TAE reserves the facility identifier "TAE"; the applications programmer may define additional facility identifiers.

The key is used to uniquely identify a message. For example, the following command solicits details on the message with the key TAE-NOFILE:

    TAE>HELP-MESSAGE  TAE-NOFILE

2.16.2 Message Files

TAE message files contain the information displayed in response to a "HELP-MESSAGE" request. There is one message file per facility; the name of a message file for a given facility is the facility name with the letters "FAC" appended. For example, the name of the message file for facility "TAE" is "TAEFAC". The message files are located using the library order specified by the SETLIB command.

Message files are built using the MSGBLD utility.