                      README.TXT for SiEMUL.EXE
                      ==========================

This file explains how to run the program SIEMUL.EXE, which provides
an emulation of Psion's Siena software on sufficiently powerful PCs.

Files in the emulator:
----------------------
SiEMUL is distributed in the form of a .ZIP file containing the
following files:

    readme.txt          this documentation file
    licence.txt         user licence agreement
    siemul.exe          the emulator top level
    epoc.dll            used by the emulator (contains EPOC)
    epoc.rmi            used by the emulator (rest of OS and APPS)
    hhserver.par        configures the emulator
    rtm.exe             run-time support
    dpmi16bi.ovl        run-time support

Licence agreement - important
-----------------------------
Note: before using this software, you must read and agree with the
terms of the accompanying file LICENCE.TXT.

Intended purpose
----------------
Note: the intended purpose of SiEMUL is as an unsupported tool for
software developers.  Treat it with the caution you would normally
accord to unsupported software development tools - be sure to have
backups of any data on your PC, before using SiEMUL.

That said, it has been the experience of developers who have already
used SiEMUL that no significant data loss has resulted from the use
of this tool.

However, Psion cannot offer any warranties or guarantees on this
point.  In particular, users are warned not to try running SiEMUL
from inside Windows, OS/2, or Windows NT.

Installation of the software
----------------------------
You should copy the following files into the same directory on your
PC: siemul.exe, epoc.dll, epoc.rmi, hhserver.par, rtm.exe, and
dpmi16bi.ovl.

Rename SiEMUL.EXE if you like, but don't rename any other file.

Limitations of the emulator:
----------------------------
    You must be running a 386 (at least) PC.
    You must have at least 4MB ram.
    Only VGA graphics support.
    Operates in MS DOS only.
    SiEMUL will not run in a DOS box in Windows (it will "violate
Windows system integrity").
    SiEMUL will not run under Windows NT or O/S 2.
    In Windows 95 you MUST start, or restart, the computer in MS DOS mode.

To run the emulator:
--------------------
Go to the directory including SiEMUL.EXE and type "SiEMUL".

NB The emulator will behave oddly if it cannot find an M:.
So be sure that one is available (create one using SUBST if you need
to), although there doesn't have to be anything special in it.
(See below for notes on the DOS SUBST command.)

To exit the emulator:
---------------------
Press and hold down Ctrl-Alt-Esc simultaneously.

Other fatal application errors:
-------------------------------
These almost invariably mean that insufficient ram was available.
For example, ram allocated to a ram drive is inaccessible to SiEMUL.

Special keys inside the emulator:
---------------------------------
F1 is System, F2 Data, ..., F8 Sheet, F9 Menu, F10 Help, F12 Diamond
F11 simulates the machine being switched off then on (only has any
effect when a password is set).
Alt is the Psion key.
You can use the Insert key as an alternative to Shift-System.

Other limitations of the emulator:
----------------------------------
Differences at the low-level filing system level.
Address trapping is implemented differently.

Remote Link:
------------
Note that you can turn on Remote Link in the System Screen and gain
access to an attached Siena (or other Sibo computer) as REM::.

By default, this connection presupposes use of COM1.  However, if you
type "-p2" into the "Extra parameters" line in the "Remote link"
dialog in the System screen inside SiEMUL, COM2 will be used instead.

Notes about SUBST:
------------------
See your DOS manual for full details.
Example syntax is
    SUBST M: C:\PSION
To change a subst, you first have to "delete" it, eg using
    SUBST M: /D

Note that before you can SUBST to M:, the LASTDRIVE setting in
CONFIG.SYS must be set as least as high as M.  (If you have to change
your CONFIG.SYS, you will have to reboot your PC before this takes
any effect.)

You may also find it convenient to SUBST A: or B: whilst SiEMUL is
running, to lessen the amount of access made by SiEMUL to your floppy
disk drives.

Troubleshooting:
----------------
If you have problems running SiEMUL:
    disconnect any serial mice and/or remove their drivers
    remove any ramdrives from your PC configuration
    remove other ram-guzzlers from your PC configuration
    re-read this document (sorry if this sounds condescending).

Technical support for SiEMUL:
------------------------------
Psion regrets that no technical support is available on the use of
SiEMUL, whether by post, fax, telephone calls, or EMAIL.
