B.28 LOGFILE Open or Close File on CF Card

A 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 Table 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 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.

DL-V3 User Manual Rev 3

125

Page 125
Image 125
Novatel DL-V3 user manual Logfile Open or Close File on CF Card, 125