# NAME

mtc − Message table compiler

# SYNOPSIS

mtc [−help] [−desc] [−I\fIdir\fP] [−B\fIfile\fP] [−L\fImax] filename

# DESCRIPTION

mtc takes an ASCII file defining the messages for a subsystem and generates the standard include files xxx__Message.h and xxx__MsgTbl.h where xxx is the subsystem name defined in the message table. The xxx__Message.h file contains a set of #defines for the message identifiers. These defines are used when passing a message ID to the MPM functions. This file should be included wherever messages are issued. The xxx__MsgTbl.h file contains the run-time information used by the MPM subsystem. This file should only be included in the function which calls pdx_SetTable. See pdx_SetTable(3) for further information.

If the −B option is specified then a binary file will be generated instead of the xxx__MsgTbl.h file. See mpm_intro(3) for information about using binary message files.

# OPTIONS

−help

Displays a summary of the available options.

−desc

Generate a formatted ASCII file of all the message ids with the corresponding message text and description information.

−B file

Generate a binary file with name file instead of the xxx__MsgTbl.h file.

−I dir

Search the specified directory for files referenced in include statements. Multiple −I options can be used and will be searched in the order specified.

−Lmax

Break output quoted strings into strings no longer than max characters. This option is useful for systems which have a limit on the length of quoted strings. Use of this option requires an ANSI-C compiler on the function which includes the xxx__MsgTbl.h file. This option is ignored if −B is also specified.

# SEE ALSO

mpm_intro(3), pdx_intro(3), pdx_SetTable(3)

# DIAGNOSTICS

Assorted diagnostic messages will be issue when errors are encountered in the input file. Most diagnostics display the source line in error and a pointer to the part of the line being parsed when the error occurred. If a semi-colon is missing, the line displayed will usually be the one following the offending line. Warnings do not prevent the generation of the include files while errors do. A summary of the number of warnings and errors is displayed at the end of the compile.