GENMSGTBL

From ICE Enterprises
Jump to navigation Jump to search

Generates table file containing all message definitions for X-Midas.

<OPT> Name of option to generate the messages table for.


 ***********************************************************************
 ** This command is an X-Midas macro and is only used by NeXtOpt. See **
 ** the CONVERT command for the NeXtMidas counterpart. XBC does not   **
 ** need to do this directly, please see the "NeXtMidas User's Guide" **
 ** for more information on using messages in XBC.                    **
 ***********************************************************************


This works similar to the way X-Midas GENMSGINC primitive that creates the
"qmessages.inc", except that this creates "qmessages.tbl". This Table file
is used by NeXtOPT when translating configured messages between X-Midas and
NeXtMidas.

GENMSGTBL starts with the X-Midas "messages.cfg" includes the messages.cfg
for all other option trees on XM_PATH (note that <OPT> and X-Midas SYS are
always included, even if not in XM_PATH). In all cases, more recently defined
messages have precedence over previously defined ones. The precedence looks
like this (left=higher precedence):

    <OPT> [others] SYS
             ^      ^
             |      |
             |     X-Midas SYS option tree
             |
            All option trees on XM_PATH (use NXM for NeXtMidas SYS)

By default, NeXtOPT uses the qmessages.tbl found in the NXM (NeXtMidas SYS)
option tree. To override this use the /MSGOPT=<opt> switch when starting
NeXtMidas. Note that <opt> must be on your path, and <opt> can NOT be "SYS"
(the X-Midas SYS option tree). To use the NeXtMidas SYS option tree, use
/MSGOPT=NXM (this is the default).

See Also: CONVERT, NM