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.