User manual for Jekyll version 1.32, 3rd revision. Written by Pascal Haakmat, 29/06/1992 Jekyll was developed and written by Vincent Partington Jekyll, the protocol, is public domain. However, Jekyll as in the ST-implementation is shareware, and should be paid for. Vincent Partington Lindenlaan 637 1185 LZ Amstelveen Holland FidoNet: 2:281/202.15 NeST: 90:4001/202.15 Pascal Haakmat Geerdinkhof 130 1103 PT Amsterdam Holland FidoNet: 2:281/202.13 TABLE OF CONTENTS: ------------------ Titlepage ...................................... 1 Table of contents .............................. 2 I : Introduction .............................. 3 I.I : What is Jekyll? .................... 3 I.II : Why was Jekyll called Jekyll? ...... 3 I.III: System requirements ................ 3 I.IV : Functional overview ................ 3 I.V : Installation ....................... 3 II : Getting started ........................... 5 I.I : Making a private Jekyll connection .. 5 I.II: Making a BBS Jekyll connection ...... 6 III : Using Jekyll .............................. 7 III.I : Getting to know Jekyll ........... 7 III.II : The statuswindow ................. 7 III.III: Configuring Jekyll ............... 8 IV : The configuration files ................... 9 IV.I : JEKYLL.CFG ........................ 9 IV.II : JEKYLL.MAG ........................ 9 IV.III: JEKYLL.FKS ....................... 10 IV.IV : JEKYLL.BAN ....................... 10 IV.V : JEKYLL.LOK ....................... 10 V : Jekyll's switches ........................ 13 V.I : General switches ................. 13 V.II : Resume switches .................. 14 V.III : Special switches ................. 14 VI : More Jekyll functions .................... 16 VI.I : The fileselector .................. 16 VI.II : The send queue .................... 17 VI.III: The fileviewer .................... 17 VI.IV : The host mode ..................... 17 VI.V : The terminal ...................... 18 VII : Shareware message ........................ 20 VIII: Disclaimer ............................... 21 Appendix A: Key overview ....................... 22 Appendix B: Troubleshooting guide .............. 24 Appendix C: Examples ........................... 25 Appendix D: Update history ..................... 28 Appendix E: Jargon guide ....................... 31 I: Introduction =============== I.I: What is Jekyll? -------------------- Jekyll is, like Zmodem and Xmodem, a transfer protocol that allows errorfree filetransfer. However, Jekyll is far more power- ful, since it was written for, and on, the powerful micro- computers of today. I.II: Why was Jekyll called Jekyll? ----------------------------------- Jekyll was named after the well-known character in the book "The strange case of dr. Jekyll & mr. Hyde" by Robert Louis Stevenson. The book tells about the split personality of dr. Jekyll, and since Jekyll (the protocol) is capable of full-duplex transmission, it was thought to be a good name. I.III: System requirements -------------------------- Jekyll should run on any ST/STE/TT with TOS in ROM, and at least half a megabyte of memory, though when using it in conjunction with Hyde 1 megabyte is required. Jekyll will run from floppy disks, but a hard disk is strongly recommended. I.IV: Functional overview ------------------------- Jekyll has a mind-boggling amount of functions, and a lot of them are not really visible to the user. It is, therefore, hard to give a functional overview, and the list that will follow only contains the major ones. Many others can only be found and fully understood by using Jekyll ... - Full-duplex (both way) transmission of files. - Split screen full-duplex chat. - Remote-mode, making it possible to scan the other drive. - Fileviewer, to prevent boredom. - Highly configurable, using both the commandline and seperate configuration files. - Little terminal, for private use of Jekyll. - Special 'time left' indication for BBS usage. - Real-time packing, to increase throughput efficiency. - Up to 20 function keys may be defined. - Magics supported. I.V: Installation ----------------- Depending on your needs, installing Jekyll can range from real easy to rather hard. The average user will probably be satisfied with a Jekyll that does only one thing: TRANSFER. For them, the installation procedure is as follows: copy JEKYLL.TTP onto your comms-drive/dir, and run it when you want to transfer something. This will work, but you will only use a very small part of Jekyll's very large potential. Because Jekyll is such a powerful program, setting it up for your own needs might prove harder than you had expected. It is recommended you print this document, and have it handy at all times, until you get the 'feel' of it. If you are a sysop, and want to install Jekyll in your BBS as an external protocol, refer to Appendix D: Examples. II: Getting started =================== II.I: Making a private Jekyll connection ---------------------------------------- Jekyll has been equipped with a large amount of gadgets that might seem useless at first, but that provide you with a far more enjoyable transfer, especially when transferring with a friend. This also was the main goal of the protocol from the beginning. To make a private connection, follow the steps mentioned below (NOTE: this step-by-step-guide assumes you've linked the telephone via the modem!): - Run Jekyll, with an empty commandline. After the title screen has been displayed, Jekyll will throw you into the Jekyll terminal. - Call a friend that owns a copy of Jekyll, and tell him to run Jekyll just like you did. - Now make sure both modems are on, and both modems are Hayes-compatible. You should also check the current bpsrate, and adjust it as required. - Tell your friend to press F2, which will cause Jekyll to send 'ATA' to the modem. A sharp, high-pitched tone is heard. When you hear this tone, you should press F1, which will cause Jekyll to send 'ATD' to the modem. - When you hear the high-pitched whistles change into a sort of crackling sound, you can safely hang up the telephone, since the modems have made a connection. - The terminal will notice the connection, and will enter Jekyll automatically. You will see the title screen again which, on the bottom line, says: "Waiting for Handshake". - After a few seconds (2 to 3, usually) the two Jekyll's will have handshaked, and you will have entered Jekyll. The screen is divided in three parts: the upper part showing everything you type, the middle part showing everything your friend types, and the lower part showing all messages from Jekyll. Having done this, it is time to explore Jekyll. If you need help, press the [HELP] key. You can scroll through the helptext using cursor keys UP and DOWN. You may also jump to section III.I: "Learning the basics". II.II: Making a BBS Jekyll connection ------------------------------------- This is somewhat simpler than a private connection, since the modems have already connected; this part assumes you are inside a BBS, and have given the BBS the command to send you some files. - Run Jekyll, using the 'Execute program ...' option in your terminal program (if it has one), or by quitting the terminal program and running Jekyll from the desktop. - Jekyll will show it's title screen, with on the bottom line the message: 'Waiting for Handshake'. - Once handshaked, you will receive the requested file(s), and, depending on whether the sysop is available, you can chat with the sysop. III: Using Jekyll ================= III.I: Getting to know Jekyll ----------------------------- Once inside Jekyll, the screen is divided into three parts: the upper part (henceforth called 'window'), the middle part, and the lowest part. The upper window shows you everything you type during a transfer. It will be sent towards the other side, who will receive it in the lower window. The middle window shows you everything the other side types. And finally, the lower window shows you all the message from Jekyll, what file you are currently receiving/sending, etc. etc. Jump to section III.II for information on this window. Try typing something. You will see the characters you type appearing in the upper window. When your friend types something, those characters will appear in the middle window. Now we will send a file. Press CTRL + F to call on the fileselector (see section VI.I: "The fileselector"). The cursorkeys up and down allow you to scroll through the list of files, whilst pressing RETURN sends the highlighted file. UNDO takes you back to the chat window. If you understand what you're doing over here, you shouldn't have any difficulties in using the gargantuan amount of other functions inside Jekyll. You may want to print out appendix A of this document, the key overview. III.II: The statuswindow ------------------------ The statuswindow is used by Jekyll to show all errors, messages, and the status of the current filetransfer. The statuswindow is built up like this: Send: b