Bernese GPS Software Version 5.0 - Bernese GNSS Software

Table 18.3: Keywords for starting the menu in special modes.
18.9 Technical Details
Keyword Description
INP FILE NAME Name of the program input file to be read by the menu
OUT FILE NAME Name of the program output file to be written by the menu
MODUS Execution mode of menu (INTERACTIVE)
If the menu is started with two arguments it normally runs in the
non-interactive mode.
RUN BPE Name of the input file for starting a BPE (${U}/PAN/RUNBPE.INP), see
Section 19.8.2
RESETCPU Name of the CPU-control file to be reset, see Section 19.4
PRINT PID Prints the system process ID of the menu program to the error output
18.9.4 Running the Menu in Special Modes
The menu may either be started in interactive mode (see Section 18.2) or in non-interactive
mode. In non-interactive mode the menu needs a menu command file as an additional
(second) argument:
$XQ/menu.sh $U/PAN/MENU.INP $U/WORK/MENUTASK.INP for UNIX platforms
%XQ%\menu %U%\PAN\MENU.INP %U%\WORK\MENUTASK.INP for Windows platforms
This way of starting the menu is used, e.g., when starting the BPE from the command
line (see Section 19.8.2) or to run the menu in a BPE user-script (see Section 19.6.3). The
auxiliary input file MENUTASK.INP contains information on how the menu shall be started
and what it shall do. The file has to be created manually or with an user-script. The location
and the filename may be defined by the user.
The information in the file MENUTASK.INP is keyword-annotated using the same notation as
in usual panel files. The keywords for special modes of the menu are listed in Table 18.3. In
addition to these keywords it is possible to overwrite the values of any keyword in the input
files MENU.INP, MENU EXT.INP, MENU PGM.INP, and MENU VAR.INP, allowing to modify the
entire configuration of the menu. In the non-interactive start of the BPE, e.g., the active
campaign and session are overwritten by the start script.
The keyword MODUS allows to start the menu in interactive mode, an option which is,
e.g., used in the script RUNGPS for starting programs which are not available through the
menu. The script defines the input file name (keyword INP FILE NAME), and the path to the
executables (by overwriting the value of the option “Default program path to the executables”
in panel MENU PGM.INP, ”Menu>Configure>Program names”) using the user’s input.
18.9.5 The MENUAUX-Mechanism
The menu program does not access Bernese data files directly in order to avoid the duplication
of file formats in different reading and writing routines (in Fortran and in C++). To
access data files a special mechanism is implemented using the Fortran program MENUAUX.
This allows, e.g., to display selection lists that are generated from input files such as, for
example, station names for datum definition extracted from binary Bernese observation files
or from normal equation files. In principle any specialized action may be performed using
this mechanism.
Bernese GPS Software Version 5.0 Page 377