![](/images/backgrounds/216335/bg7d.png)
DL-V3 User Manual Rev 3 125
B.28 LOGFILE Open or Close File on CF CardA logfile is a file on the CF card with properties as defined in Section C.1, PDC Files on Page 149.
The logfile command opens a logfile, associates a virtual channel with a logfile, or closes a logfile.
Only one logfile can be open at a time. A logfile cannot be reopened for further logging after it has
been closed.
The logfile open command associates a virtual channel(s) with a logfile.
• If channel is specified, channel is associated with the logfile. If channel is not
specified, all available virtual channels FILE_n are associated with the logfile.
• If file is specified, the virtual channel(s) is associated with a logfile named file.
File is specified in a base.ext format, where base is maximum 8 characters and the
optional ext is maximum 3 characters. The extension used for file creation is “pdc”.
If file is not specified, a default filename is created for the logfile as follows:
• The first four characters are taken from the last four digits of the DL-V3 serial
number.
• The second three characters are three digits representing the UTC day-of-year
(that is, in the range 001-366).
• The last character is an alphanumeric character denoting the session ID, assigned
in the sequence 0,…,9,A,…,Z. The first available session ID is used (that is, a
session ID which results in a filename which does not conflict with an existing
file on the CF card).
• If no channel was previously associated with the logfile (that is, the logfile has not
been previously opened), the logfile is opened. If the logfile has been previously
associated with a virtual channel(s) (that is, the log file is open), the virtual
channel(s) is associated with the already open logfile. This command fails if a
logfile is already open and a new logfile needs to be opened in the course of
execution of this command.
• You must specify channel if you wish to specify file which is a valid ASCII value
in File Port Channel, see Tabl e 54 on Page 134. This resolves the ambiguity as to
which of the two fields has been entered.
• The logfile close terminates an association of a virtual channel(s) with a logfile.
• If channel is specified, association of virtual channel channel with the logfil e is
terminated. If channel is not specified, association of all virtual channels with the
logfile is terminated, and the logfile is closed.
• If file is specified, the association(s) is terminated only if the association is with a
logfile named file. If file is not specified, the association(s) is terminated for any
logfile.
• If the association which has been terminated is the last one for the logfile, the logfile
is closed.