Novatel DL-V3, Reference Manual

Page: 54 / 116

54 DL-V3 Firmware Reference Manual Rev 2
Chapter 2 DL-V3 Commands
2.27 LOGFILE Open or Close File on CF Card
A logfile is a file on the CF card with properties as defined in Section 3.1, PDC Files on Page 75 . 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 Table 42 on Page 61 . 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 logfile 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.
• You must specify channel if you wish to specify file which is a valid ASCII value in
File Port Channel, see Table 42 on Page 61 . This resolves the ambiguity as to which
of the two fields has been entered.