|
LOG Control the script log file |
Top Previous Next |
If the [ file name ] argument is present, this script command creates a new script log file by this name. It is also implied that script logging is to be turned on. The script log file records all commands and status messages that occur during a file transfer session. This file is useful to determine if an unattended session was successful.
The /new option instructs FileLink to create a new log file name using the current date and time. Such a file will be created when the command is executed and, if the /maxsize option is also specified, whenever the log file exceeds this maximum size. The [ file name ] argument must be present, but it can be an empty string. FileLink takes the base file name (i.e., the part of the file name before any extension) and appends the current date and time in the fashion shown below. Notice that if no extension is originally specified, FileLink appends .log to the final file name.
LOG "mylog" /new // creates log file = mylog Wed Oct 30 15.38.43 2002.log
LOG "mylog.txt" /new // creates log file = mylog Wed Oct 30 15.38.43 2002.txt
LOG "mylog.xx.log" /new // creates log file = mylog Wed Oct 30 15.38.43 2002.xx.log
LOG "" /new // creates log file = Wed Oct 30 15.38.43 2002.log
When the /new option is used the name of any newly created log file is available in the %currentlogfile script variable.
The /maxsize option limits the maximum size that a log file can grow to. The size is specified in kilobytes. When the maximum size is reached, FileLink handles this condition in one of two ways. If /new is also specified, the current log file is simply closed and a new file is created using the convention described above. If /new is not present, FileLink toggles between two files. When the first file is full, it is closed and a second created and written to. When the second file is full, it is closed and the first file is reopened, cleared, and logging continues. This alternating between files continues until FileLink terminates. When /maxsize is present, [ file name ] is altered as shown below. Notice that if no extension is originally specified, FileLink appends .log to the final file name.
LOG "mylog" /maxsize=100 // creates log file = mylog 1.log // this alternates with a file to be named mylog 2.log
LOG "mylog.txt" / maxsize=100 // creates log file = mylog 1.txt // this alternates with a file to be named mylog 2.txt
The /append option instructs FileLink to append new log data to a previously existing file specified by [ file name ]. If [ file name ] does not exist, it will created. The /append option may be combined with /maxsize but may not be used with the /new option.
If [ file name ] is omitted, the /on and /off options control logging to a previously defined log file. When logging is turned on, new log messages are appended to the existing log file. For example:
LOG /off
|