                    PsiOn - V1.3 - By Paul Hargreaves
                    ---------------------------------

PsiOn is a very small program (with source) that controls your system
password in a more sensible manner. PsiOn turns off the PSION's power
on password and after your  PSION has been  switched off for a while,
PsiOn wakes  up and turns the  system password back on.   It can also
show your Agenda screen after your password has been entered.

PsiOn is designed to run on the PSION Series 3a, 3c and Siena. 
PsiOn will not run on a 3 classic - sorry.


Changes
-------
Changes have been moved into the file CHANGES.TXT.  


Installation
------------
Copy the PSI-ON.OPA into your INTERNAL drive. It's only 3k.  Copy the
PSI-ON.ICO  and PSI-ON.OPL into the  \OPL  directories if you want to
re-compile PsiOn.

I wouldn't advise putting PsiOn onto a flash/ram disk..if the program
is running and someone takes the SSD out then you'll get errors......

From the System screen, press Psion-I to install.  

PsiOn will create a file called  \OPD\PSI-ON.ODB on your default disk
whenever you change your PsiOn settings.
YOUR PASSWORD IS NEVER SAVED TO A FILE !!

THE ICON (C)1993 BY RIGHT HAND SOFTWARE.


Running PsiOn
-------------
Go to the icon and press Enter.

You'll be shown a screen that looks like this.....

                /---------------------------------\
                |          PsiOn V1.3             |
                |---------------------------------|
                |.Power on password   ________    |
                |.Switched off time   00:15:00    |
                |.Control Agenda      No          |
                |.Agenda View Key     W           |
                \---------------------------------/

Power on password :- The password  you type every  time you switch on
your PSION. THIS IS NOT SAVED ANYWHERE, NOR WILL ANY VERSION OF PsiOn
EVER SAVE IT AWAY.
PsiOn need to know this password, as there is no way for a program on
the PSION to "tell" what the password is.  Without this password, the
Password control functions of the PSION cannot be accessed.   You can
see this  when you try to  change your password.    You have to enter
your current password before any details are shown.

Switched off time :- How long  your PSION  is switched off and unused
until  PsiOn turns your password back on.  The default is 15 minutes,
but if you change  this setting then it will  be saved away  for  the
next time you run PsiOn.

Control Agenda    :- You can have PsiOn show  an agenda screen either
Each Morning (after 4am) or Every time you type in your password.
This works by looking for a running "process" called Agenda. If PsiOn
finds it, the screen will be shown in the mode selected below.   If 2
different Agenda's are running, then one of them will be shown. There
is no way for you to select which agenda to use, but it will Normally
be the first Agenda that is started.
[You can use Spy before opening any Agenda's,  then start each one in
turn.  The one with the lower Task number is the one PsiOn will show]

Agenda view       :- If the  Control Agenda  is set to yes,  then you
can select which view you'd like Agenda to be shown in.  

Here are the keys that you should select on a UK/US machine
     Week View        : W
     Day View         : D (or blank)
     To Do List       : T
     List View        : L
     Year View        : Y
     Anniversary View : A

And for the S3c and Sienna, you also have
     Busy View        : B

Non UK/US machines may have different letters.    Go into your Agenda
screen and press Menu,  scroll over to the Diamond list, and the keys
you can select will be shown.


After you press Enter, and assuming you typed in the right  password,
the screen will clear and you'll be taken to the System screen. PsiOn
HAS NOT CRASHED OR QUIT.  PsiOn returns you to the System screen.  To
see that PsiOn is running press Enter on the icon again.  

The screen will now look like this......


                 PsiOn_V1.3_(C)Paul_Hargreaves
                 ^A Arm Now ^P Pause mode


PsiOn sits in the background. If a key is pressed while the screen is
displayed,  or the machine is switched on,  PsiOn will notice after a
second or so and will take any necessary actions.

Please be patient when you press a key - PsiOn will change the screen
when it notices a valid keypress, but this could take anything upto 2
seconds.

If you press Psion-A, then PsiOn will act as if your machine had been
left switched off for a long time,  and it will re-arm your password.
This is useful  if you leave your machine lying around when you go to
lunch or whatever.  

Pressing  Psion-P  will make PsiOn leave your  password off until 4am
the next day.   This is useful for weekends - you switch your machine
on once on a Saturday, and you won't be forced to enter your password
until the next Sunday.

PsiOn takes /very little/ processor time while it's running.  You can
use the SPY (3a) Application to verify this.  

You can switch your machine off and on,  and the password screen will
not be shown.  PsiOn has turned off your password for you.

Now go back to the System screen and select  Control-Auto switch off,
you can reduce  this to a much shorter  time.   That way your machine
will switch off quicker,  but since PsiOn has disabled your password,
just pressing Esc or  any of the System keys will switch your machine
back on.  This will also help save your battery power.


Now switch off your PSION and wait a while   (15 mins if you left the
default set), and you'll see your PSION switch on for a brief second.

PsiOn has turned your system password back on,  just as if you'd done
it from the system screen yourself.   There is no way of getting past
the password screen...it's the real thing!

After you  have typed in  your password,   PsiOn  will disable it and
will reset it's timers again.  


Notes
-----
DO NOT CHANGE YOUR SYSTEM PASSWORD WHILE PsiOn IS RUNNING. PsiOn will
quit automatically if it notices that you've done this!

PsiOn does not affect any alarms that you have running,   nor will it
interfere with your remote link, or anything else !!


Why choose PsiOn over pason4c??
-------------------------------
PsiOn  works differently  to pason4c.    The main difference  is that
pason4c starts counting down when your PSION is turned on,  not while
it's switched off.     This means that if you have a password time of
5 minutes (for some strange reason) and you switched the PSION on and
used it for 6 minutes,  then switched off and on,  you'd be shown the
Password screen.  This, in my opinion, is wrong.

Please try  pason4c  and choose for  yourself.   I think mine's a lot
simpler to use and backups will stop PsiOn from running like all good
applications should.

I also  include FULL  source code with comments,   so you can be sure
that my program isn't doing anything it shouldn't(I'm NOT saying that
pason4c does!), and you can tweak to your hearts content!


Contacting the author [please!!!!]
---------------------

Snail Mail
----------
PAUL HARGREAVES
48 ALBERT ROAD
LONG EATON 
NOTTINGHAM
NG10 1JZ
ENGLAND

Fail Mail 
---------
PsiOn@hargreavesp.demon.co.uk  OR  pauhar@symix.com

Web page 
--------
http://www.hargreavesp.demon.co.uk/


This program is yours for Free!   You don't HAVE to send me anything.
I wrote this program for myself,  if you make use of it great....drop
me a line telling me what you think, what your settings are, and what
features you think might be useful.  If you make any nice changes, or
spot any bugs, then send me a copy of the program and I'll see what I
can do...

If you play Magic, The Gathering, I do like magic cards!!   I'll even
take those Mummies off you :-)  Just stick 'em in the post.

I have included the source for your viewing pleasure.   Please do not
change PsiOn in any way when you re-distribute PsiOn, unless you have
my written permission.


And Finally
-----------
A big thank you to my beta testers -
Paul Bird, Garry Box, Joseph Reger.

A Special thank you to  Geoff Morrison,   who spent a lot of time and
effort beating me up with little suggestions and comments (especially
about the size of the program).  


PsiOn is (C)1996 Nov/Dec by Paul Hargreaves  
PsiOn is (C)1997 Feb     by Paul Hargreaves

(I'm sorry if the notes look  a little  hurried...  but I hate  doing 
documentation, and anyway, PsiOn is simplicity itself)
