-R mcompile option

The results (-R) option of the mcompile utility command will have a parameter to specify the location or file name, or both, for the build results file produced by the map compiler for each executable map. There are 2 different cases where (-R) can be used in the mcompile utility command.

In the first case, the (-R) option is used with the compile all maps (-A) option. The specified parameter could be either the name of the directory where the build results files will be written or the full file path specification in which a wildcard can be used to represent the executable map naming convention. The default naming convention for the build results file is executable_map_name.mme. If a wildcard is specified in the full path as mcompile mymaps.mms -A -R C:\MyDev\CompiledResults\*.err, the build results files will be produced in the C:\MyDev\CompiledResults directory with the executable_map_name.err naming convention.

In the second case, the (-R) option is used without the compile all maps ( -A ) option. The specified parameter could be the name of the directory where the build results files will be written, the full file path specification in which a wildcard can be used to represent the build result file, or the full path in which the complete filename can be specified. The default naming convention for the build results file is executable_map_name.mme. If a wildcard is specified in the full path as mcompile mymaps.mms MyExecMap -R C:\MyDev\CompiledResults\2002-02-28_*.err, the build results file will be produced in the C:\MyDev\CompiledResults directory with 2002-02-28_MyExecMap.err naming convention. If the complete file name is specified as mcompile mymaps.mms MyExecMap -R C:\MyDev\CompiledResults\MyExecForwin.txt, the MyExecForWin.txt will be produced in the C:\MyDev\CompiledResults directory.

If the (-R) option is not specified, the build results will be written to the console. If the (-R) option is specified, but no parameter is provided, the build results will be written to the same directory as of the map source file using the default executable_map_name.mme naming convention. If the file name or the path provided for the ( -R ) option is not valid or returns error while attempting to open or write to the file, the Compilation error - The file/path provided for the option (-R) is not valid, unable to write to the specified directory/file message will be written to the mcompile log file, if it is enabled.