Log_File

This parameter specifies the path (absolute or relative to the working directory) and name of the Session log file.

Session log files are not interchangeable between different versions/editions/widths of Dyalog. In addition, starting multiple instances of a Dyalog interpreter with the same log file name will only create a log file for the first instance started.

This is mitigated by including a * character in the default Session log’s filename, for example, log.*.dlfx or log*.dlfx. In this situation, at start-up, Dyalog attempts to open, and then lock, a file in which the * is replaced with an increasing integer value starting from 000, for example, log*.dlfx results in files called log000.dlfx, log001.dlfx, and so on. If a file cannot be opened and locked, the value is incremented. This means that starting multiple instances of the same interpreter simultaneously will create and open multiple log files with different values. If one or more instances are then closed, starting a new instance will re-open the closed log file for that interpreter that has the lowest value. The process fails, and no log will be created or used, if the value would exceed 999.

NOTE: The LogFile property of ⎕SE reports the name of the log file that is being used.

The default is <DocumentsDirectory>\Dyalog APL-<bits> <DyalogMajor><DyalogMinor> <Unicode|Classic> Files\default_*.dlfx, for example, C:\Users\Bob\Documents\Dyalog APL-64 20.0 Unicode Files\default_*.dlfx

See also Use log file.