<<

Contents

Search

>>

 

Programs (Menu item File/Open/Program)

 

Hyperlinks:

Copy Program

Print Programs

Mask Properties

Mask Layout

Report Properties

Report Layout

 

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.