<<

Contents

Search

>>

 

Run of an Ebus program

 

The Ebus program is started by a command procedure on the operation system level. For that purpose the Java runtime environment version 1.5 or higher must be set up.

 

run_<Programname>.bat   (Windows)

 

or

 

 run_<Programname>.sh  (Unix/Linux).

 

Right after the start all variables of the program are initialised. Numeric auxiliary and Index File variables are initialised with zero, alphanumeric auxiliary variables with the empty string and alphanumeric Index File variables with blanks according to their field length.

 

Before the main window is shown, the configuration mask <programname>.jni is read. In this file all program settings that affect colors, look and feel, etc., are saved (read Configuration Mask).

 

After that, the macro before index-open (if existent) is executed. In this macro the path names, the physical names and the access mode of the Index Files, e.g., can be specified. After that, the Index Files that are used in the program are opened. The Index Files are checked on defects. If defects exist, a report window will appear for every defective Index File:

 

 

 

If No is chosen, the program with error report will be finished, otherwise the Index File will be reorganized.

 

After the Index Files (if existent) have been opened successfully, the macro after index-open is executed. If there is a GOTO #… to a mask field in this macro, program execution will immediately go to the respective mask. Otherwise the mask with the lowest mask number will be called after the macro after index-open has been executed.

 

With the call the mask is displayed on screen. The macros macro before mask output and macro after mask output are executed.

 

For every mask a certain field sequence has been specified in the layout. The fields are executed accordingly to this sequence. If an entry in a mask field is finished with <RETURN>, <→|> or <↓> , the mask field with the next higher sequence number will be called next. If no such mask field exists, the first field of the mask will be called, provided that the switch ROTATE is enabled (ENABLE ROTATE).

 

If the key <|←> or <↑> is pressed in the input field, the mask field with the next lower sequence number will be called. If no such field exists on the current mask, the last field of the mask will be called, provided that the switch ROTATE is enabled (ENABLE ROTATE).

 

With calling a field the respective macro before is always executed first (if existent). If a data record of an Index File is read in this macro (e.g. with READ, START, READS, READ-NEXT etc.), all mask fields of the current mask will be displayed again right after the macro’s execution, unless the instruction NODISPLAY was given or the switch AUTODISPLAY was set on DISABLE. If no other mask field is called in the macro before (GOTO #…), the current mask field will be displayed again after the macro’s execution, i.e. the value of the variable linked to the mask field will be put on screen.

 

With unchangeable mask fields the next mask field (according to field sequence) is called after the macro before has been executed and the mask field has been displayed. With this field the respective macro before is then again executed first.

 

With changeable mask fields the program expects an input of the user after the macro before is executed. If the field input is finished with <RETURN>, <→|> or <↓> , the macro after (if existent) will be executed afterwards. If a data record of an Index File is read in this macro (e.g. with READ, START, READS, READ-NEXT etc.), all mask fields of the current mask will be (like with the macro before) displayed again right after the macro’s execution, unless the instruction NODISPLAY was given and provided that the switch AUTODISPLAY was set on DISABLE.

 

Note: The macro after of a mask field will not be executed if the field input is finished with <Esc>, <|←> or <↑>.

 

If no other mask field is called in the macro after, the next mask field (according to sequence) will be called after the macro’s execution.

 

If the key <Esc> is pressed in a mask field, the mask will be finished.

 

If a mask has no mask fields, the macro for mask processing will be executed after the mask has been displayed.

 

 

Scrolling in Index Files

 

If the currently edited mask field is linked to an Index File variable, the user can scroll forward and backward in the respective Index File of this mask field with <F3> and <F4>. You scroll in the key that was specified by the attribute Scroll in Key with the mask field attributes. If no key has been specified, you will scroll in the key where the Index File field appears first.

 

 

Installing a java proramm as a service under Windows

 

start_service.bat is installing a java program as a service under Windows:

 

start_service.bat has to be called with the following parameters:

 

start_service <Program-Name> <Program-Path>

 

<Program-Name> is the name of the program, e.g. Prog1

 

<Program-Path> is the directory, in which the program <Program-Name> shall be started as a service. This directors must contain the files prunmgr.exe and prunsrv.exe.

 

The following command calls the dialog in order to start and to stop the service:

 

prunmgr //ES//<Program-Name>

 

The following command uninstalls the service:

 

prunsrv //DS//<Program-Name>

 

To install a client program as a service under Windows see Ebus-2T-Server.