Bernese GPS Software Version 5.0 - Bernese GNSS Software

18.6 Program Output and Error Handling
18.6 Program Output and Error Handling
Each Bernese main program reports its result in a program output file and (optionally) in
an error-file. The names of these files can be specified by the user in a standard way for
each program. Here is an example:
The user may specify a name for the program output file or use the default name. The
default name consists of the main program’s name and the extension “Lnn” where nn is a
counter incremented every time the input file is saved. The counter starts with 00 and runs
up to a maximum value which is specified in option “Maximum program output file number”
(”Menu>Configure>Program names”, see Figure 18.2). The number nn to be used for a subsequent
program run is stored in a file pgmnam.J in the campaign’s OUT-directory. This file is locked
with an extension lk while it is updated. If the J-file is deleted the counting starts again at
00 and a new J-file is created. The maximum program output file number may be any value
up to 999. If it is greater than 99 the extension switches from Lnn to nnn. We recommend
to specify explicit filenames (corresponding to result filenames) for all important program
runs.
Error and warning messages can either be merged into the program output file or written
into a separate file located in the ${U}/WORK directory with default extension MSG. An error
message starts with three*-characters. It is issued if the program cannot continue execution
for any reason. A warning message starts with three #-characters. It is issued to point the
attention of the user to an aspect of the recent program run that may be – depending on
the application – critical or not (e.g., if a satellite was not found in the standard orbit file).
The menu system remembers the name of the output file of the last started program. This
file can easily be displayed using the ^Output-button. Older program output files and error
message files may be found through ”Menu>Service>Browse program output” and ”Menu>Service>Browse
error message”. The browser for program output files and error message files offers the possibility
to search for a string. This may help to navigate through long output files.
In case a program encounters an unhandled error and aborts, a message usually appears
on the program’s standard output. This message may only be seen in the terminal window
from where the menu was started (on UNIX platforms only). If this window was closed or if
the menu was not started from a command line (e.g., under Windows), this output cannot
be seen. In order to get such messages on the screen, execute the program without the menu
(see Section 18.8).
Bernese GPS Software Version 5.0 Page 367