                                        Worklog3a
     Activity logging program for Psion Series 3a
                          (c) Alfa Computing 1996
                                  Richard Schmidt
                       Richard Sturenberghlaan 50
                                2273 GX  VOORBURG
                            THE NETHERLANDS (EUR)
                  Email @ Compuserve : 100735,331
     Email @ Internet : 100735.331@compuserve.com
                                                 
                                   Version V1.0.1
                                         26/03/96


Index
=====
1.     INTRODUCTION
2.     INSTALLATION
2.2    REQUIREMENTS
2.3    HOW TO INSTALL
2.4    DISTRIBUTION
3.     KEYBOARD REFERENCE
4.     THE AUTHOR
4.1    HOW TO CONTACT THE AUTHOR
4.2    DISCLAIMER
4.3    HOW TO REGISTER
5.     FUTURE DEVELOPMENT

1. Introduction
===============
Welcome to WorkLog3a!

WorkLog3a is a project activity logging
program. It can log activities for specific
projects during a work day and save time
spend on these activities to a database.

This program can be useful for people
working on several projects having to
monitor their labour and creating time-sheets.

Features of WorkLog3a:
- input of projects and recording activities
  for this projects.
- calculation of:
  * total work hours per project within a
    specific period, and all projects
    cumulated;
  * total work hours per project today;
  * total work hours per project in a;
    specific week; totals are specified
    per day;
  * available and remaining budget;
- memo per project;
- notification when exceeding workday hours
- (audible)notification when activity has
  expired on user specified duration forcing
  application to come to foreground;
- printing projects and its activities/totals;
- tracking remaining vacation hours
- and lots of other stuff...

WorkLog3a is only available in English for the
Psion Series 3a.

2. Installing WorkLog3a
=======================
Before using the application you should install
it from your PC to your Psion.

2.1 Requirements
================
The application requires 75K RAM memory and
approximately 50K ram of disk space. If your
machine appears to be out of memory try to close
a few applications or erase files from internal
memory (after making a backup first!).

2.2 How to install
==================
To install WorkLog3a:

- start RCOM or MCLINK;
- connect and switch on Psion link in system
  screen with Psion-L;
- copy file WORKLOG.OPA to an \APP directory on
  any disk
- copy file WORKLOG.HLP to an \APP\WORKLOG
  directory on any disk.
- Create directory \WORKLOG\ on any drive and
  copy EXAMPLE.* to this directory. These
  files contains an example projects file.
- Install the WorkLog3a application in the system
  screen by pressing Psion-I.

Make sure you have an \OPD directory on your
default drive. WorkLog3a will save its
configuration to \OPD\WORKLOG.INI.

2.3 Distribution
================
An unregistered copy of this application may be
distributed freely. The application itself
consists of the following files:

WORKLOG.OPA    Main application
WORKLOG.HLP    Help screens
MANUAL.TXT     This manual
HISTORY.TXT    Changes since initial version

EXAMPLE.WKL    !
EXAMPLE.WKI    ! files for example
EXAMPLE.WKT    !

3. Keyboard reference
=====================

File - Open - Psion-O
---------------------
Opens new projects file. A projects file
contains project descriptions and all the
activities. A projects file consists of
two files and optionally some memo files:

\WORKLOG\EXAMPLE.WKL    projects
\WORKLOG\EXAMPLE.WKT    descriptions
\WORKLOG\EXAMPLE.WKI    project info
\WORKLOG\EXAMPLE\*.WKM  memos for EXAMPLE

File - New - Psion-N
---------------------
Create new projects file. New files will
be stored in the \WORKLOG\ directory.

File - Tidy up - Psion-K
------------------------
This option can be used to tidy up the
activities file. All activities for all
projects will be removed before a specific
date.

Search - Find - Psion-F or F
----------------------------
Find project in list. Searches through
projects and makes an occurrence current
project.

Search - Find next - Psion-G or G
---------------------------------
Find next project in list. Searches from
current project to end.

Search - Jump - Psion-J
-----------------------
Jumps to project by number. Every project
in the list is preceded by its record
number. Use jump to jump to a project
by entering this record number.

Project - Enter - Psion-E
-------------------------
Add a new project to the project file.
A maximum of 1000 projects can be entered.
The unregistered version of WorkLog3a allows
for 5 projects.

PROJECT - short description for project

DESCRIPTION - long description for project

CHARGE/HOUR - internal charge per hour,
this information is used to determine the
remaining budget.

BUDGET - budget (money value) for this project

Project - Enter - Psion-U or ENTER
----------------------------------
Update current project. Updated project
are always moved to the end of the list.

Project - Delete - Psion-D or DELETE
------------------------------------
Delete current or marked projects.

Project - Info - Psion-I
------------------------
Display information about:
1. number of projects in current project file
2. number of activities for ALL projects
3. number of activities for CURRENT project

Project - Memo - Psion-+
------------------------
Create or edit memo for current project.
Each project can have one memo. This option
launches the built in WORD application.
Therefore memos are limited to 40000 characters.
Memos are stored in a subdirectory (with same
name as projects file) in the directory that
contains the project files (usually
\WORKLOG\). The names for the memo files
are equal to the internal project id number
(invisible for user).

Be aware when renaming a projects file to
rename also the memos subdirectory.

Project - Mark current - Psion-M
--------------------------------
Mark current project. Marked projects can be
deleted in one pass. All reports on screen
or printer apply to either ALL projects or
MARKED projects.

Project - Mark all - Psion-A
----------------------------
Mark all projects.

Project - Unmark all - Shift-Psion-U
------------------------------------
Unmark all projects

Activity - Start - Psion-S, S or SPACE
--------------------------------------
Start activity for current project. Depending
on the setting a dialog box appears (at the
end or start of activity) querying the
description for the activity.

During the activity a dialog box is displayed
showing the elapsed time and remaining
duration time. The duration of an activity
acts as a countdown timer for activities.

Depending on the settings, an activity can
be stopped automatically forcing WorkLog3a to
come to foreground and beep optionally.

WorkLog3a allows for a maximum of 3000
activities per projects file.

Activity - Manual entry - Shift-Psion-M
---------------------------------------
Add activity to activity database manually
without having to start (record) an activity.
This option can be used when you "forgot" to
start a new activity and want to add it
afterwards.

It is possible to enter:
- a period with start and end date;
- a duration with start date and a duration
  of 15min, 30min, 1hr, 2hrs, 4hrs or 8hrs.

Activity - View - Psion-V or TAB
--------------------------------
View all activities for current project.
This dialog shows descriptions, start- and
end date for all activities. This dialog
also allows for deleting activities.

Activity - Categories - Psion-C
-------------------------------
Every activity has a desciption. Categories can
be used as descriptions for these activities.
A maximum of 10 descriptions can be entered.

Activity - Categories - Psion-V
-------------------------------
Update remaining vacation hours for this year.
It is possible to add or substract hours.

remaininghours=remaininghours+add-subtract

Totals - None - Psion--
-----------------------
Stop display of totals in project table view.
Switching off totals speeds up scroling.

Totals - Period - Shift-Psion-P
-------------------------------
Calculates total labour per project in a
specific period. If projects are marked than
only marked project will be calculated.

Totals - Day - Shift-Psion-D
----------------------------
Calculates total labour per day for a maximum
of 7 consecutive days starting at a specific
date.

Totals - Week - Psion-W
-----------------------
Calculates total labour per day in a week.
The number of working days (1-7) in a week
depends on your settings in the preferences
dialog (default 5).

Totals - Today - Psion-* or *
-----------------------------
Calculates total labour today.

Totals - Remaining budget - Psion-B
-----------------------------------
Calculates remaining budget per project.
Uses budget and charge/hour specified
with project.

Totals - Set filter - Shift-Psion-F
-----------------------------------
Normally the calculation of totals applies to
all activities. By setting a filter, only
activities with same description as filter
will be taken in account when calculating
totals.

Special - About - Shift-Psion-A
-------------------------------
Displays about information.

Special - Register - Psion-R
----------------------------
Register your copy of WorkLog3a.

Special - Set preferences - Psion-Q
-----------------------------------
Set global preferences. These preferences are
devided over two pages.

TIME FORMAT - time format for displaying
and printing time.

WORK DAY - length of workday in hours. Used
to determine when workday hours are exceeded.

WORK DAYS PER WEEK - number of work days
per week. When making a report for working
hours in a week.

DEFAULT CHARGE FOR NEW PROJECTS - default
charge per hour used when entering new
projects.

DEFAULT BUDGET FOR NEW PROJECTS - default
budget used when entering new projects.

WORKHOURS NOTIFICTION - totals for today
are calculated when an activity has
stopped.

PROMPT FOR DESCRIPTION - prompt for description
when starting or stopping a task. Three types
of prompt are available:
- Do not ask;
- Before starting;
- When stopping.

DEFAULT ACTIVITY DURATION - default activity
duration for new activities. Depending on setting
the activity will continue or terminate after
this time has elapsed. It's also possible to
select an audible warning.

ON EXPIRATION DURATION - determines what action
to take when activity duration has elapsed.
(see setting above)

Settings are saved to \OPD\WORKLOG.INI

Special - Zoom in - Psion-Z
---------------------------
Enlarge screen font used for displaying projects.

Special - Zoom out - Shift-Psion-Z
----------------------------------
Reduce screen font used for displaying projects.

Special - Print setup - Psion-Y
-------------------------------
Select between printing to file or parallel
port.

LINES/PAGE - maximum lines per page for
work hours reports.

HEADER - text header to appear on top of
each page.

Special - Print - Psion-P
-------------------------
Print totals for period, week or subsequent
days. Set "Include activities" to yes if
all activities are to be printed as well.

Special - Exit - Psion-X
------------------------
Exit application.

4. The author
=============

4.1 How to contact the author
=============================
The author can be reached by mailing to:
Alfa Computing
Richard Schmidt
Richard Sturenberghlaan 50
2273 GX  VOORBURG
THE NETHERLANDS (EUR)
Email @ Compuserve : 100735,331
Email @ Internet : 100735.331@compuserve.com

4.2 Disclaimer
==============
The author takes no responsibility for any lost
data or hardware malfunctions of any kind due to
the use of this software or any other software
that ships with WorkLog3a.

4.3 How To register
===================
- send cash in envelope to my postal address or
- use SwReg on compuserve to register
  SWReg id : 10384
  Product  : WorkLog3a
  Price    : $20 or equivalent
- Only for Dutch users
  Stort voor registratie Hfl 35,-- op
  girorekening 6338889 tnv R.G.Schmidt
  te Voorburg o.v.v. uw adresgegevens.

  **********************************
  * registered PTM3a users receive *
  * a free update                  *
  **********************************

OTHER SOFTWARE : CALC3a and TRIPS3a

5. Future development
=====================
- export to ASCII;
- client information per project;
- table view of activities;
- sorting activities on date;
- maximum labour per project;
- tidy up, move (marked) activities to other
  projects file.
etc.