Bernese GPS Software Version 5.0 - Bernese GNSS Software

19. Bernese Processing Engine (BPE)
19.6.6 Stop a User Scripts with an Error
To stop the user script in case of an error do not use the Perl command exit 1. If the user
script is terminated with the command die the BPE client reports the error to the BPE
server. Using exit instead of die stops the complete client and no ending message is sent to
the BPE server. As a consequence the BPE server will wait for this client script forever.
19.6.7 Old User Scripts and Non-Perl User Scripts
As stated above the user scripts may on UNIX systems be written in any programming
language provided that the environment variables are accessible and the system commands
can be executed. If the run method is not overloaded in the user script (overloading is possible
if the user script is written in Perl), the default run method (defined in ${BPE}/RUNBPE.pm)
is called and performs the following system command:
system "$$bpe{U_OLD}/SCRIPT/$$bpe{SCRIPT}";
It means that non-Perl user scripts are started as separate processes without any arguments.
These scripts cannot use directly the methods defined in${BPE}/RUNBPE.pm. Instead of that
the non-Perl scripts can use the utilities that are located in the ${X}/SCRIPT directory. Here
is the list of available files with their brief description:
AUTO UPD BEG MENU DO TAIL SET SESS ... dummy scripts (they have no functionality
but they are called in old user scripts)
CLEAN UP ... deletes some program-specific files
END MENU ... sets the exit code according to error status
PRT GOTO PRT MESS RUN PGMS ... wrappers of the corresponding methods
defined in ${BPE}/RUNBPE.pm
We have already stated that the new BPE is backwards compatible and old user scripts
prepared for the Bernese GPS Software Version 4.2 can be used. A few modifications of the
scripts are, however, necessary due to the new menu system, see Section 24.3.
19.7 BPE Program Option Directories
19.7.1 Program Input Files
The program input files used by Bernese programs started in user scripts are located in the
user’s ${U}/OPT-directory tree. For each script a subdirectory of ${U}/OPT is specified in
the PCF in the column “Opt dir”. Several scripts may access the same option subdirectory.
This subdirectory has to contain not only the program input files but also all menu input
files MENU*.INP (except of MENU CMP.INP).
Before starting the user script the client copies the content of the corresponding option directory
into the PAN subdirectory of the client-specific temporary area. Accessing program
input files using the RUNBPE::putKey method modifies the files in this temporary directory.
Before executing a Bernese program the client executes the menu in non-interactive
Page 408 AIUB