Contents
|
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.
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.
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.