Documentation for P_TIME.OPL Version 1.1

Date: 06.05.1994



1. GENERAL

P_TIME.OPL is a program which shows you how you spend your time
with your psion series 3(a). The intention was to create facts to
argue with my wife, who means that i spend too much time joying
with my psion.
Although i have much learned from the DOHELP.OPL - program i request
full copyright for P_TIME.OPL in all parts. P_TIME.OPL may be distri-
buted and used as public domain program. You may use it at your own
risk.
You are allowed to modify this program under the following condition:
If you are modifying successfully P_TIME.OPL i request a copy of the
modificated program.


2. INSTALLATION

Copy P_TIME.OPL to your OPL-directory.
Start the OPL-translator.
Select P_TIME.OPL to edit.
Start translation.
Quit translation whithout starting P_TIME.OPL.
Return to system screen.
Start P_TIME.OPO listed under the OPL-RUN-symbol.


3. HANDLING, FEATURES

After initialization the program quits immediately, but whenever you
select then P_TIME.OPO, it shows you its information screen. This
screen contains the following parameters:

total time       =  the time since you have started P_TIME.OPO.

on time          =  time during total time, when the computer was
                    switched on.

programming time =  time during on-time, when you have programmed
                    something.

The time is shown in the format days (ddd, 0 - 365), hours (hh, 0 - 24)
and minutes (mm, 0 - 60). The on-time is shown aditionally related to
total time and the programming time related to on-time in percent.

The time measurement is updated every 10 seconds. If you select
P_TIME.OPO it is first shown the last info-screen and you may have
to wait up to 10 seconds until an updated screen is shown. You are
informed about a completed update by a message on the right bottom
of the screen. To quit the screen you have to hit any key.
The error of the shown values is equal to the error of the built-in
watch and the +-10 seconds error. Additional error occurs if you are
regarding the info screen to long, because this is detected as off-
time. I my opinion this error is neglectible if you use P_TIME.OPO
long enough.

The programming time is incremented whenever the standard path of
the foreground application is an OPL or OPD directory. So programming
is detected also it you use another editor than the built-in OPL-
editor (=WORD-application).
Auto-off of the series 3 is not influenced by P_TIME.OPO. Although it
wasn't possible to reduce the priority level of P_TIME.OPO it doesn't
need a lot of activity of your series 3 because of the 10 seconds
count interval. During this interval P_TIME.OPO is waiting for a timer
interrupt before continuing with work. Its work is then completed after
0,006 seconds.

For further information contact:
Heinrich Hiemesch@m2.maus.de
