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
Displays a summary of the available options.
Generate a formatted ASCII file of all the message ids with the corresponding message text and description information.
Generate a binary file with name file instead of the xxx__MsgTbl.h file.
Search the specified directory for files referenced in include statements. Multiple −I options can be used and will be searched in the order specified.
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.