StateDMI / Command / StartLog
Overview
The StartLog
command
(re)starts the log file. It is useful to insert this command as the first command in a command file,
in order to persistently record the results of processing.
A useful standard is to name the log file the same as the command file, with an additional .log
extension,
and this convention is enforced by default. A date or date/time can optionally be added to the log file name.
Command Editor
The following dialog is used to edit the command and illustrates the command syntax.
StartLog
Command Editor (see also the full-size image)
Command Syntax
The command syntax is as follows:
StartLog(Parameter="Value",...)
Command Parameters
Parameter | Description | Default |
---|---|---|
LogFile |
The name of the log file to write surrounded by double quotes. The extension of .log will automatically be added, if not specified. |
If not specified, the existing file will be restarted. |
Suffix |
Indicates that a suffix will be added before the .log extension, one of:
This is useful for automatically archiving logs corresponding to commands files, to allow checking the output at a later time. However, generating date/time stamped log files can increase the amount of disk space that is used. |
Do not add the suffix. |
Examples
See the automated tests.
Troubleshooting
See the main troubleshooting documentation
See Also
SetDebugLevel
commandSetWarningLevel
command