-LOG mcompile option

The log (-LOG) option of the mcompile utility command is used to enable logging. The log file will be produced showing the results of each executable map's compilation. (-LOG) has an optional parameter to specify the location or file name, or both, for the mcompile log file. The mcompile log contains all the map compilations resulting from the current mcompile utility command on the command line. The default file name for the mcompile log will be map_source_file_name.mcl. The default location for the mcompile log will be the directory where the source map file is located.

The file name or the location parameter, if specified with the (-LOG) option of the mcompile utility command, could be the name of the directory where the mcompile log file will be written, the full file path specification in which a wildcard can be used to represent the map source file, or the full path in which the complete filename can be specified. The default naming convention for the mcompile log file is map_source_file_name.mcl. If the . is specified with the (-LOG) option, the mcompile log will be written to the default location (directory where the map source file is located) using the default naming convention. If a wildcard is specified in the full path as mcompile mymaps.mms -A -LOG C:\MyDev\CompileResults\2002-02-28_*.build.results, the mcompile log file will be produced in the C:\MyDev\CompileResults directory with the 2002-02-28_mymaps.build.results naming convention. If the complete file name is specified as mymaps.mms -A -LOG C:\MyDev\CompileResults\mymaps_buildresults.txt.txt, the mymaps_buildresults.txt will be produced in the C:\MyDev\CompileResults directory.

If the mcompile utility command is unable to create the mcompile log file, the map compilation will terminate and the Fatal error - Could not start map compilation, unable to create the log file fatal error message will display on the console. If nothing is specified in the command line for the log, by default, the command line assumes the (-LOG) option is included in the command line, and writes the log messages to the console.