Programs (Menu item
File/Open/Program)
Hyperlinks:
The program description contains the data for
the program generation. It is saved in the current working directory in the
file <Programname>.pgj.
General structure of an Ebus program
When the Ebus program is started two
initialisation macros can be executed. The first one is executed before the
Index Files are opened and the second one afterwards. Then the first mask
usually appears on the screen.
When a mask field is activated, the respective Macro
before is executed (if existent). Then the user puts in the data. After
that the Macro after is executed (if existent). Then the next mask field
is activated according to the specified field sequence.
A mask field can be linked to an Index File
variable or an auxiliary variable. In this way screen inputs are immediately
assigned to the linked variable.
For program control commands are available in
the programming language. These commands can call subprograms and sequential
programs, activate any masks or mask fields or terminate the running program.
Creation of a program in Ebus-J
First the Index File specifications for the
Index Files used in the program must be recorded. (see Index Files).
Afterwards the masks and reports of the program
are created.
The macros that are called in the program are
recorded with the macro editor.
In the menu item Generator the Java Sourcecode is created from the program
specification and compiled into an
executable program.
The executable program has the name
<Programname>.jar and can be started with the command procedure
run_<Programname>.bat (Windows) or run_<Programname>.sh
(Linux/Unix).
The created program is completely independent
of the Ebus-J.
Open
Program

Program Name: The
program name may only contain letters, numbers and the underscore _ . If the
program exists already, program execution will continue at the listbox Masks
right after the program name has been entered. There the mask editor can be
opened instantly with RETURN, double-click or the button 'Edit Mask
Layout'.
The following function keys (Icons) are
available:
F2: Select Program: One
program from all existing programs can be selected.
F3:
Scroll forward: next program
F4:
Scroll backward: previous program
F5:
Delete Program. The program in the input field Program Name is
deleted.
F7: Select Program
(history): A program from all lately used programs can be chosen.
F8: Copy Program:
single programs or all programs of a program can be copied.
F9: Print Program:
single programs or all programs of a program can be printed.
Short description: The short description is displayed behind the program name in the dialogs
for program selection.
Detailed description: The detailed description is information only; it does not influence the
program.
Macro Before Index-Open: This macro is the first macro to be executed after the program is started.
The Index Files used in the program will be opened after the macro has been
executed. In this macro the paths (instruction PATH),
the openmode (instruction OPENMODE) and the physical names of
the Index Files (instruction NEWNAME) can be set or changed.
Macro After Index-Open: This macro is executed after the Index Files used in the program have
been opened. If there is no jump to a mask in this macro (instruction GOTO), program execution jumps to the first mask of the program (that is the
mask with the lowest number) after this macro has been executed.
Masks: When
a New Mask is created, first the Mask Properties and then the
Mask Layout have to be set. When a new mask is clicked on or selected with
RETURN, the editor for the mask layout is called.
Button 'Mask Properties': The dialog for setting the mask properties is started.
Button 'Edit Mask Layout': The editor for the mask layout is started.
Button 'Delete Mask': The currently selected mask is deleted after confirmation.
Reports: By
double clicking an entry in the listbox or pressing the button 'Edit
Report Layout' the editor for the selected report is started. By
selecting the entry new report a new report can be added.
Button 'Report Properties': The dialog for setting the report properties is started.
Button 'Edit Report Layout': The editor for the report layout is started.
Button 'Delete Report': The currently selected report is deleted after confirmation.
Button 'Save':
The data are saved and program execution continues at the field Program
Name.
Button 'Cancel':
Program execution continues at the field Program Name. If data
have been changed, the user will be asked if changes are to be saved.