************************************************************************** - THE LEGENDARY >> SUBSOFTWARE << IN 87/88/89/90 !!! ==================================================== - CONTACT US - BP: 36 - - 1380 REBECK - - BELGIUM - - DON'T SEND ANY DISKS - ************************************************************************** **************************** * * * * * Handshake Version 2.12a. * * * * * **************************** HandShake V2.12a. Summary of Features. If you want to see how this version of Handshake has changed from the previous versions please refer to the Version History section at the end of this document. WHAT IS IT? Handshake is the copyrighted property ( (c) 1987, 1988) of Eric Haberfellner Handshake is a Full featured VT52/100/102/220 terminal emulator for those people who really need it. I have taken great pains to support the full VT102 spec (VT102 is a superset of VT100) and most of the VT220 spec. I have no real way currently to test the full functionality of the VT220 emulation, so I am relying on my users to point out any errors. Please detail any problems that you find, and I will fix them for the next release. I take no responsibility for the proper functioning of this program or for any damage to you or your business that may be caused by this program. (obligatory disclaimer.) WHAT IS IT NOT? Handshake doesn't try to be an all round, general purpose, modem program which supports a multitude of transfer protocols, a script language, etc. There are plenty of good programs out there which fulfill this need. Several Handshake users however claim they use it for all their communications and that handshake does more than many programs that make greater claims. See the review included in the ARC file. IMPORTANT NOTE ABOUT DISTRIBUTION AND SHAREWARE Feel free to use and distribute this program as you like, as long as it is not for commercial use. If you like it, use it and want to see it get better, please send a contribution of $25.00 to the address listed in the program's "About.." requester. Commercial users are urged to contact the author. Please do not alter or rename the distribution ARC file in any way if you pass it along or post it on a bulletin board. The current Handshake distribution ARC file is called HDSK212a.arc. This way people can tell what version of Handshake is on a BBS. Future enhancements that I would like to do include ZMODEM file transfer protocol, perhaps make Handshake an AREXX host, multiple number dialing, etc, however I will have to see an increase in user support if I am going to do these things. If you like this product and use it send a contribution. This is not free software. It is SHAREWARE it has a cost that you are expected to pay if you use it. Let me know what features are important to you. If you feel that there are features missing that you would like to see, please let me know that as well. How would you feel if Handshake got even bigger? Is size a problem? How do you feel about overlays? Would having to do an assign in your startup-sequence make Handshake unusable or cumbersome to you? COME ON PEOPLE TALK TO ME! I know that you are out there and using Handshake. If the support does not pick up I will have to start releasing crippled versions of Handshake, and only send the full featured non-freely distributable versions to people who contribute. I do not want to have to do this, it is contrary to my beliefs about SHAREWARE and people supplying quality software to others for low cost. I know it is a nuisance to have to walk to your chequebook and fill out a cheque, address an envelope, and mail it, but prove that you are someone that cares about SHAREWARE and wants it to continue. Make a statement, not just for me and my program, but for other SHAREWARE products that you use as well. The people who write these programs are highly skilled professionals in most cases who want to help other users. They deserve your support! WHAT IS THIS DOCUMENT? This document is a quick description of the features of Handshake paying particular attention to the less obvious aspects of Handshake so that an experienced user will be able to use the program. This document assumes that the user has experience with terminal programs and the Amiga. Especially the Intuition user interface ( Menus, requesters, etc. ) WHAT IS THIS DOCUMENT NOT? This document is not a course on telecomunications and modem usage it assumes some familiarity with telecommunications and terminal programs. If you are not familiar with terminal programs or the Amiga user interface, find a friend who is and ask him/her to help you. WHAT DO YOU NEED TO RUN HANDSHAKE? An Amiga with 512K or more. At least version 1.2 of Kickstart and Workbench. THIS PROGRAM WILL NOT WORK WITH VERSION 1.1 OR EARLIER OF AMIGADOS. Hardware to connect to the other computer. This may consist of only a cable if you are locally wired, or a cable and a modem if you are accessing the other computer over the telephone. This program does work with memory expanded beyond 512K. WHY SHOULD YOU USE HANDSHAKE? If you have a requirement for FULL VT52/100/102/220 compatability and have not been satisfied by other programs which only do half the job, this is probably the program you have been looking for! Here is a list of some of the features that Handshake offers: - Full 24/48 line display with title bar enabled! No more turning the title bar on and off to see all 24 lines. - Full VT52 support. Every VT100 has a VT52 inside of it. So does Handshake -- right down to the VT52 graphics character set. - VT102 Edit mode. Local insert and deletes. - VT220 Emulation. Including downloadable character sets. It works great with VMS APL. - VT220 7 or 8 bit control mode. Selectable erase etc. - Smooth or Jump scrolling. - Block or Underline see through reverse video cursor. Blinking or non-blinking - Full VT100 Special Graphics Character Set. - Full double height and double width characters. - 132 character per line mode. It may be necessary to run preferences and use the screen centering gadget a little to the left in order to see the last few columns in 132 column mode. - Double height and width characters in 80 and 132 column mode. - All character modes. Normal, Bold, Reverse video, Underline and Blinking in any combination. - Optional color mode. Uses ANSI color selection codes. Handy for bulletin boards which support color. - Full keyboard support. This includes VT52 mode. Handshake handles the escape sequences to turn auto repeat on and off and lock the keyboard. No more run away cursors while in EDT under VMS etc. - As of release 1.60a Handshake supports the additional Amiga 500/2000 numeric keypad keys. - ASCII file transfer mode with user definable end-of-line translation for both sending and receiving. No more carriage returns in your received files (unless you want them). - XMODEM, XMODEM/CRC, YMODEM, YMODEM Batch, KERMIT/TEXT, KERMIT/8 BIT BINARY and KERMIT/7 bit BINARY protocols for binaryfile transfers. - Six user definable function keys. - Dialing Support with a 20 Phone number Directory. Optional auto redialing is available. System characteristics ( baud rate, data bits, parity, stop bits ) can be specified in the dialing directory entry. Auto redial can be specified in the directory entry. This dialing mode is geared to Hayes compatible modems, although the user can specify the dialing prefix ( ATDP or ATE0DT, etc. ). - Fast! Using a 95K text file captured from a VAX which was then sent to Handshake from a local microcomputer, Handshake maintained a throughput of 875 characters per second. This means that Handshake can take characters as fast as your host can send them at 7200 baud, and still look good at 9600. A real VT100 can't keep up at 9600 baud either. You can use the shareware BLITZFONTS program to get even better performance. - Complete Workbench integration. Handshake can be started from the Workbench. As you save parameter files, icons are optionally created. These icons can be used to invoke Handshake later with the same paremeters. You can even specify a host to dial immediately when the icon is invoked. This feature can be turned off if you prefer the CLI and do not want .info files cluttering up your disk. - The ability to capture screen images to an ASCII file or to a printer. Just for you Toronto Real Estate Board Users. See, I do listen to my users. - Handshake will optionally make use of the ARP file requester if ARP.library is installed in the LIBS: directory of your workbench disk. WHAT PROBLEMS ARE THERE WITH HANDSHAKE? * * PLEASE READ THIS SECTION!! * The VT220 mode does not support the Host Definable Keys feature. This will probably be in the next major release. Line noise will sometimes select one of the special character sets (this happens with real VT100 terminals too). You can reselect the ASCII font by selecting the Terminal Type from the Terminal menu. For instance, if you are in VT102 mode, and you wish to reset the ASCII character set, just select the VT102 submenu. Handshake takes up a lot of memory for its fonts and buffers. Handshake will run on a 512k system, but you may run into problems if you have a background utilities running (machii, virusx, etc). The best solution is to buy more memory. A 512k Amiga is really starving. However I intend to address this problem in a future release. Maybe a menu option to disable everything but the 80 column fonts. You may find that you can not see the last two or three columns of 132 column mode. If this happens to you, run Preferences and move the screen centering gadget to the left a bit. This should fix the problem. WHO DO YOU CALL WITH PROBLEMS, SUGGESTIONS, MAKE CONTRIBUTIONS TO ETC? Me! Eric Haberfellner, 57 Marble Arch Crescent Scarborough, Ontario CANADA M1R 1W8 Voice Phone (416) 757-1055 ( After Six P.M. EST please ). I am on available on BIX as ehaberfellner, and can be reached through USENET at ...utgpu!mnetor!becker!haberfellner!eric WHAT DO YOU NEED TO KNOW ABOUT HANDSHAKE TO USE IT NOW? The follwing things about Handshake are not obvious so you should familiarize yourself with this section. * READ THIS NOTE. * Handshake uses a 660 pixel wide screen instead of the usual 640 pixels. * This means that the Handshake extends 20 pixels further to the right * Than most screens. It may not be possible to seew the screen depth * arrangement gadgets at the right of the title bar or the last 3 or 4 * columns of test in 132 column mode unless you run preferences and move * the screen centering gadget a little to the left!! Command line. Handshake can be invoked from the CLI. The general form of the command line is illustrated below (parts in square brackets are optional): Handshake [-p parameter_file_name] [destination_name] The parameter file name is the parameter file to be used, if none is specified the default file Handshake.parms is used. The destination name is the name of the remote computer to be dialed. This name must be one that appears in dialing directory of the parameter file being used and must be spelled exactly the same way it is spelled in the dialing directory entry (Case of characters is not significant). If the name in the dialing diretory entry ends in a '*' or the Auto Redial menu selection is set in the parameter file, Handshake will keep dialing the number until a connection is made. If the name in the dialing directory entry ends in a '*', do not include the '*' on the command line when specifying the destination name. If this dialing directory entry appeared in the default file Handshake.parms: 555-1234:1200,8,n,1 Fred's BBS* The following command line coule be used to call this BBS. Handshake "Fred's BBS" Note that the '"'s are necessary in this case because the name of the BBS has a space in it. Here is another example. Handshake -p universities.parms UCLA This would dial the phone number associated with the descriptor UCLA in the parameter file universities.parms For a complete description of dialing directory entries, see the discussion later in this section Workbench. Handshake can also be invoked from the Workbench. There is an icon which looks like a terminal. Invoking this icon will cause Handshake to be invoked with the parameters from Handshake.parms, or if this file does not exist Handshake will use it's built in parameters. In the project menu there is an item "Create Icons". if you set this to "Yes" Handshake will create a telephone icon every time that you save the parameters. While Handshake is saving the parameters it will also prompt you for a dialing descriptor which if specified will be used as the initial dialing destination when the icon is invoked. CLI users will probably want to keep the "Create Icons" option set to "No" so that their disks will not be cluttered with un-necessary .info files. Keyboard. VT100 Keys Amiga Keys ---------- ---------- Arrow keys Arrow keys F1 through F4 F1 through F4 on all Amaigas or F1 Keypad ( on Amiga 500/2000 F2 Keypad ) on Amiga 500/2000 F3 Keypad / on Amiga 500/2000 F4 Keypad * on Amiga 500/2000 Keypad 0 through 9 Keypad 0 through 9 on all Amigas Keypad . Keypad . on all Amigas Keypad - Keypad - on all Amigas Keypad , RIGHT_ALT key on all Amigas **Watch for this** or Keypad , Keypad + on Amiga 500/2000 Keypad Enter Keypad Enter on all Amigas VT220 Keys Amiga Keys ---------- ---------- Arrow keys Arrow keys F1 through F4 F1 through F4 on all Amaigas or PF1 Keypad ( on Amiga 500/2000 PF2 Keypad ) on Amiga 500/2000 PF3 Keypad / on Amiga 500/2000 PF4 Keypad * on Amiga 500/2000 F1-F4 Do not transmit any key codes and are not currently mapped. F5 RIGHT-AMIGA B on all Amigas F6 F1 on all Amigas F7 F2 on all Amigas F8 F3 on all Amigas F9 F4 on all Amigas F10 F5 on all Amigas F11 Escape on all Amiags F13 Any SHIFTED Arrow key on all Amigas F12 Backspace on all Amigas F14 F6 on all Amigas F17 F7 on all Amigas F18 F8 on all Amigas F19 F9 on all Amigas F20 F10 on all Amigas FIND SHIFTED-Keypad 7 on all Amigas INSERT HERE SHIFTED-Keypad 8 on all Amigas REMOVE SHIFTED-Keypad 9 on all Amigas SELECT SHIFTED-Keypad 4 on all Amigas PREV SCREEN SHIFTED-Keypad 5 on all Amigas NEXT SCREEN SHIFTED-Keypad 6 on all Amigas Keypad 0 through 9 Keypad 0 through 9 on all Amigas Keypad . Keypad . on all Amigas Keypad - Keypad - on all Amigas Keypad , RIGHT-ALT key on all Amigas **Watch for this** or Keypad , Keypad + on Amiga 500/2000 Keypad Enter Keypad Enter on all Amigas The Back space and Del keys can be reversed with a TERMINAL menu option. User Definable Function Keys. The function keys F5 through F10 are now user definable keys. There is now a new menu item in the Porject menu, the "Function keys" item. Selecting this option will cause the Function Key Edit Requester to appear. Just type in the strings that you want the fucntion keys to transmit. When you are finished, just select the ALL DONE gadget. There are two other gadgets on the Function Key Edit Requester. These allow the user to specify which characters in the transmit strings should be used to represent the carriage return and line feed keys. The default values are the '~' for carriage return and '`' for line feed. Please note that inorder to change these charcters it is necessary to delete the character which appears in the gadget before typing in the new one. The function key definitions are saved along with the phone directory and other options the the selected Handshake parameter file. File Transfers. The "Receive/Transmit CR/LF as ..." menu options are only applicable to the ASCII file transfer modes. These can be used to translate end of line characters when sending to the other system. For instance, when sending to a VAX which is receiving with the CREATE command, you will want to send a carriage return to the VAX at the end of each line. Amiga text files have no carriage returns in them so lines are terminated with line feed characters. By selecting the Transmit LF as CR option Handshake will do the conversion for you. As of version 1.30b you no longer have to terminate ASCII Receive (capture) mode in order to do a binary file transfer. Handshake will automatically suspend cpature mode while the transfer is taking place and will restart it when the transfer has completed. If you use the XMODEM, XMODEM/CRC or single file YMODEM binary file transfer mode, be aware that the received file will probably have to be truncated. This is because all files received by XMODEM are a multiple of 128 bytes long. AmigaDos does not like these extra bytes. There are several good public domain utilities available to strip these bytes off the end of the file (TAILRID, for one). If you send your files in ARC format then this is not a problem. Handshake also supports the YMODEM Batch protocol and KERMIT. Using these protocols lets you transfer multiple files in one trnasfer, frees the receiving user from the necessity of having to enter the name of the file being received, and results in files that have the same length as the original file (No need to chop extra bytes off the end of the file). Handshake does however ask the receiving user to specify the directory path into which the received files should be placed. This directory path MUST end in a ":" or a "/". Some exapmles of valid directory paths are: df0: df1:source/ source/ :source/ vd0:source/headers/ RAM:download_files/ my_files: /* In this case my_files must be a vilume name or have been assigned with the assign command. */ If you do not specify a directory path the files will be placed in the current directory. When sending with YMODEM Batch protocol you can specify a file name as usual, or use wildcards as well. Here are some sample YMODEM Batch send file specifications: df0:source/my_file.c ram:#? df1:source/headers/#?.h You get the idea. YMODEM Batch or KERMIT will transfer all the specified files to the receiver. It will send the file names, and the file lengths as well. Handshake now supports the KERMIT file transfer protocol. It is used in much the same way as the YMODEM Batch protocol which also supports multiple file transfers. There are three KERMIT modes. KERMIT 8 bit Binary, KERMIT 7 bit Binary and KERMIT Text. Kermit 8 bit Binary requires you to be connected with the other computer with 8 data bits. It will not work with a seven bit connection. KERMIT 7 bit binary works with a 7 bit connection it uses the KERMIT binary escaping feature. This should only be used if an 8 bit connection is unavailable, since it can really slow down the transfer. KERMIT Binary protocols do image transfers, the received or sent file is bit for bit identical with the original. Kermit Text is used for text files, and will work with either a 7 bit or 8 bit connection. It should be used for text files only. The received files will have no cariage returns at the end of the lines, only line feeds. If you want the carigae returns, use one of the binary protocols For the protocol transfers and for the ASCII Send, Handshake pops up two windows, one in its own screen and one in the workbench screen. These windows provide information on the progress of the transfer. The one in the Handshake screen can be used to abort the transfer just by clicking on the close gadget in the upper left hand corner. The window in the Workbench screen is provided so that during a long file transfer you can use your multi-tasking Amiga to do other things and not have to keep flipping back to handshake to see if the transfer has completed. If you have the Audio Bell option enabled, You will hear a rising sequence of notes for a successfull file transfer, and a falling sequence of notes for an unsuccessfull file transfer. Dialing the Phone. In order to dial a number from the dialing directory ( Menu option "Dial Phone" ), click using the mouse on the small square gadget immediately to the left of the number that you want to dial. Clicking on the text of the number allows you to edit the entry, but not to dial it. The dialing directory is saved to disk whenever you save the parameters It is possible to have several diailing directories by using different parameter files. Whenever Handshake goes into auto-dialing mode, it pops up a pair of windows much like in file transfer mode to keep you informed of progress. See the description in the file transfer section above. If the Audio bell feature is enabled, you will hear a four note sequence to indicate that the connection has been completed. Format of dialing directory entries. A dialing directory entry has the following general format. The parts in the square brackets are optional. The * at the end of the line is used to indicate auto redialing. telephone_number[:baudrate[,data_bits[,parity[,stop_bits]]]] [desc][*] Below are some sample dialing directory entries: 123-4567 Simplest case. Dial the number using the current serial parameters. 123-4567 Joe's BBS Same as above with a description. 123-4567 * Both of these will dial 123-4567 Joe's BBS* Until the other system Answers. 123-4567:1200 Call the number changing baud rate to 1200 if necessary. 123-4567:1200,8,n,1 Joe's BBS* A biggie. Call Joe's until it answers using 1200 baud, 8 data bits, no parity and 1 stop bit. Valid parity characters are n=none, o=odd, e=even, m=mark and s=space. Interlace. The Half screen interlace mode is intended to give you a full 24 line VT100 Emulation in half a screen. This leaves you the other half to do whatever you like, and still watch your terminal screen. The full screen interlace mode is useful in 132 column mode. Readability of characters in interlaced mode may depend on your selection of colors. (I find that black characters on a gray background look just super ). HANDSHAKE VERSION HISTORY Version 2.12a - Cleaned up font support so that Handshake's fonts were not visible to other applications in the system (i.e. Notepad). - Fixed several downloadable font bugs which were reported by Joe Trivers. Many thanks to Joe, who brought over a real VT220 to demonstrate these bugs. - 24 line half screen mode stopped working in the last version as a result of the interlace bug fix. This has been corrected. - Last version was not linked with a tiny _main, as a result a window opened on the workbench when handshake was run from the workbench. This version is correctly linked. - Changed the default foreground colour in the colour mode to 7 instead of 1. Version 2.11a - Fixed the "Interlace WorkBench" bug reported by Joanne Dow. If you were running Handshake in 48 line mode with an interlaced workbench and flipped back to the workbench with the Amiga-M,N keys junk would be displayed. Version 2.10a - Set default VT220 character set mapping to gr<-g2<-DEC special character set. - Fixed and improved the VT220 soft font support. - Changed Backspace handling so that it does now not wrap to previous when at the start of a line. - Added menu item to transmit the answer back message. - ASCII screen images (printed or filed) no longer have trailing blanks. - Added close file option for the Save Screen submenu. - ctrl-Z and ctrl-X now displayed as upside down ?. - Fixed File IO Guru in BuildFullName. - Cleaned up handling of IDCMP messages all over. - Added default fourth colour for File requester. This can be edited using the color edit in the project menu. - Added menu item in the phone menu which lets the user dial without first hanging up. This is required for some phone systems which require multiple dials to reach a destination. Also some people did not like the wait associated with waiting for the phone to hang up. - General cleanup of dialing code. - Fixed bug in locked line requester which caused it to hang. - Fixed receive buffer overflow problem. Receive buffer now stands at 1536 bytes. - Ymodem receives now correctly display received size when a retransmitted block is encountered. - Screen formats and colors are now set if a parameter file is loaded once Handshake is already running. - Added more VT220 control keys (3,4,5,6,7). - Added support for mark and space parity. - Added support for zero stop bits. - File requesters for loading and saving parameters now only display files which have a ".parms" extension. If a file name without this extension is entered. it will be added. - Removed WaitBOVP () calls and replaced them with WaitTOF () calls. WaitBOVP () BUSY WAITS!! UGH. - Replaced RJ's file requester with the ARP one. If ARP.library is not available, fall back to old style plain requesters. - Fixed the Special Graphics character set GURU reported by Joe Trivers. - Added direct screen print to the "Save Image" submenu. - Added Close File menu option for "Save Image" submenu. - The "New File" option in the "Save Image" memu item no longer saves the first image. You must explicitly save all images now with the Write Sreen submenu item. - Corrected spelling for "Successful" - Sundry other small fixes. Version 2.00a - Incredible code changes from last version. - Full VT200 support (actually VT220 except for User Definable Keys). - Added RJ Mical's color editor so you can set and save colors. See PROJECT menu. - Added RJ Mical's file requester. All file names are now input using this file requester. - Made several code changes related to serial input to clean up the lockup problem. - See the new keyboard layout above. Some keys have moved to accomodate VT200 support. - Optinal 8 color mode for "ANSI" BBSs. - Ability to save ASCII screen images to a file. See the Screen Image menu item in the Project Menu. - Fixed Backspace and delete handling. No longer affects CTRL-h. Version 1.60a Jan/88 - Massive code cleanup. Defined function prototypes for all functions in the source. Compiled with Lattice v4.0. Since this version is such a major reworking of the source and compiled with a new compiler, I would like to hear back from users as quickly as possible if you encounter any bugs. - Function prototyping turned up a bug in VT102 insert line feature which could have caused trashing of very low memory. Fixed. - Tried to convert to 16 bit integers. Failed because of bugs in Lattice v4.0. However the source is all set to go. Maybe next release if Lattice fixes their bugs in getfnl(). This should speed things up a bit more. - Added support for the extra keys on the Amiga 500/2000 Keypad. These can now be used as F1 through F4 and the VT100 keypad comma key. See the text above. - Added KERMIT 7 bit binary protocol for users who connect to host system with 7 bit connections and want to transfer binary files very slowly. - Reversed PHONE and TRANSFER menus. - Cleaned up XMODEM transfer protocol bugs. XMODEM wouldn't switch from CRC to checksum properly. - Improved dialing. Handshake now recognizes the baud rate that a connection is made at from the CONNECT message. i.e. CONNECT 1200 or CONNECT 2400 etc. It also recognizes the return codes BUSY, NO ANSWER, NO DIALTONE and NO CARRIER if one of these is returned by the modem it is displayed for 1 second on the STATUS line of the auto redial window. Any of these codes is taken as a failure to connect. Version 1.50a - Added user definable function keys. keys F5 through F10 are now available as user definable keys. See the documentation above. - Kermit File transfer protocol added. See documentation above. - Some characters were getting lost after file transfers. this is now fixed. Version 1.42a - Fixed the horrid "Beep forever" bug. - Fixed the rename command in EXEC_ME for Handshake.rev. Version 1.41a - Fixed bug in YMODEM Batch protocol. It would work with another Amiga running Handshake, but not with any other YMODEM Batch implementations. Version 1.40a - Fixed the horrible dialing bug which appeared in v1.30b. Boy am I embarassed. Dialing would not work unless AUTO REDIAL was selected. - AmigaDos requesters now appear in the Handshake screen instead of popping the Workbench screen to the front. Big improvement. - YMODEM and YMODEM Batch file transfer protocols are here. See the File transfer section of this document and the Binary Protocol item of the TRANSFER menu. - Added a bell. Handshake now beeps upon receipt of a BEL character. Handshake also now gived an audio indication of file transfer completion and connection in auto redial mode. The user can select audio bell, visual bell, both or none. See the new Bell Type item in the TERMINAL menu. - Added the VT100 Margin bell feature. See the new Margin Bell item in the TERMINALcmenu. - Added a blinking/non-blinking option for the cursor. If you are using a parameter file from a previous version of Handshake, the cursor will not blink initially. Go to the Cursor item of the TERMINAL menu and select blinking. Now save your parameters. From now on the cursor will blink again when you start Handshake. - Speeded up CRC calculation for file transfers. - Fixed a minor bug which caused XMODEM sends to always show 1 error even there had not been one. This did not affect the transfer. - Fixed a bug which sometimes caused inproper font selection after going into VT52 mode and back out again. - Fixed bug in UK Character set support. - Speeded up CRC calculation for file transfers. I am now doing bytewise instead of bitwise CRC calculation. Version 1.30b - Replaced the abort requesters with windows. The windows are used to provide progress information about file transfers and auto-dialing as well as serving as abort devices. To abort a file transfer or auto-dialing just click on the close gadget of the window in the handshake screen. - The windows described above are also duplicated on the Workbench screen. This is so that you can do other things while a large file transfer is in progress and not have to keep flipping back to Handshake to see if it is finished yet. Same for auto-dialing. - Relinked with a "tiny" _main.o so that the lattice standard input/ output window no longer pops up in the workbench screen. - Capture mode (ASCII Receive) can now remain active during binary file transfers. Handshake will suspend it until the transfer is over and then start it up again. - Added XMODEM/CRC file transfer mode. Version 1.21a - Local echo mode did not work properly. This has been fixed. - Reseting the terminal would sometimes leave a double cursor on the - Screen. This has been fixed. Version 1.20a - Improved Workbench interface. Handshake will now optionally create create Telephone icons for saved parameter files. This allows the user to select which paramter file to use from the Workbench. The icons can also be created in such a way that Handshake will automatically start dialing a specified number when it is invoked with that icon. - Fixed a bug which caused XMODEM transmits to sometimes hang. - Changed autodialing support so that it now works with modems that report status while they are dialing (Like the Volksmodem 1200). - Dialing destinations which contained spaces on the command line did not work, even when enclosed in quotes. This has been fixed. - Selecting the Reset Terminal option from the menu or typing Amiga-V would cause two cursors to appear on the screen. This has been fixed. Version 1.10a - At last, a real 132 columns instead of 128. - Added some intelligence to the routines that display the cursor. This yielded a 35% performance improvement. Handshake now has an average throughput of about 875 characters per second. - Cleaned up parsing of command line parameters especially the dialing directory entry. - Put error checking into reading of parameter files. If the file does not exist or is of the wrong size put up a requester advising the user. If the default file Handshake.parms cannot be found do not annoy the user with a requester (use the built in defaults). - The command line dialing direcotry entry is now case insensitive. - Added some register variables in several places. Handshake is now about six percent faster because of this. - Fixed a bug which caused the line attribute for the bottom line to not be reset when the screen was cleared. - Fixed a hideous bug which caused the input subtask to lock up sometimes. This would appear to the user as a blank title bar. This would only happen if the user interface task sent a "go to sleep" message to the serial input task at the same instant that an IO completed, therefore this was more likely to happen at higher baud rates. Sorry about that one. Version 1.02a ( not released to the public at large ). - Added command line parameters to specify parameter file to use, and to allow the user to specify a remote computer to dial from the command line. - Added 20 second dialing timeout to the dial timeout menu. - In order to abort redialing it was sometimes necessary to select the abort requester more than once. This is now fixed. - Moved File transfer and redialing abort requester to upper right portion of screen. - General cleanup of the file transfer code. Receiveing to disk is now much faster. Transfer aborts now work porperly at high baud rates. Version 1.01a - Auto redialing added. - Pulse/Dial menu option replaced with user definable dialing string. - Added menu item to allow user to specify backspace & del key operation. - Fixed bug which caused menus to not be updated after a reset if no parameter file was present. Version 1.00a - Handshake Unleashed on an unsuspecting public. An historic Moment! ========================================================================== - REVIEW - ------ This file contains a test of five VT100 emulators which appeared on USENET. I am writing this preamble to discuss the results. Below the line of dashes this file appears exactly as it did on USENET. In This test the tester claims that Handshake does not support a full 132 columns. It does. However it uses a 660 pixel screen instead of the usual 640 to do this. THis means that the Handshake screen extends further to the right than the workbench screen. It is possible that you will not be able to see the last few columns of 132 column mode and the depth arrangment gadgets on the right side of the title bar. If this is the case, run preferences and move the screen to the left a little this will allow you to see the whole Handshake screen. This is what must have happened to the tester. The tester also claims that he is not sure if Handshake smooth scrolls. I am not sure what happened here but I assure you that Handshake smooth scrolls. Try it yourself. Just select Smooth scroll from the TERMINAL menu. For the Answerback test, the tester claims that none of the emulators supports the entering of an answerback message. He must have missed the Answer Back item from the TERMINAL menu. Handshake does support this. The alternate ROM character sets are marked as "unknown" in the test. Handshake handles these by mapping the ASCII and Special Graphics character sets onto ROM 0 and ROM 1 respectively. In the test it was correctly pointed out that Handshake did not correctly handle the UK character set mode. This has been fixed in the current release. Also the tester gives the address of Howlett Gaffran Inc as the address where to send contributions for Handshake. I (Eric Haberfellner) and Handshake have no more affiliation with Howlett Gaffran Inc. The new correct address is: Eric Haberfellner 57 Marble Arch Crescent Scarborough, Ontario CANADA M1R 1W8 I would also like to take this time to thank Mr. Strovnik for taking the time to run these tests on Handshake and hope that the few corrections that I Have made to his results in the above paragraphs will make Handshake an even better and more usable product to him and others. And now for the test itself! The text below here has not been altered in any way. -------------------------------------------------------------------------------- From rutgers!husc6!necntc!ames!lll-tis!ssc!strovink Mon Jul 13 21:21:24 EDT 1987 Relay-Version: version B 2.10.3 4.3bsd-beta 6/6/85; site cbmvax.UUCP Path: cbmvax!rutgers!husc6!necntc!ames!lll-tis!ssc!strovink >From: strovink@ssc.afit.arpa (Mark Strovink) Newsgroups: comp.sys.amiga Subject: vt100 emulators (+ Handshake) Message-ID: <161@ssc.afit.arpa> Date: 1 Jul 87 17:44:58 GMT Date-Received: 1 Jul 87 23:20:25 GMT Reply-To: strovink@ssc.UUCP (Mark Strovink) Organization: Air Force Institute of Technology; WPAFB, OH Lines: 132 Keywords: emulators, vt100, handshake I could not resist running VTtest on Handshake v1.21a when I saw Marco Papa's results for some vt100 emulators. The following contains Marco Papa's [editted but not changed] results along with mine. Here are the results of running Per Linberg's VTTest program on Diga! 1.0, A-Talk 1.1, Dave Wecker's VT100 2.6 and the VT100 emulator included in xterm 6.6B as part of the X Window System. I [Marco Papa] run version 1.7b of the VT100 test program, dated 1985-04-19. The test was compiled on a VAX running 4.2BSD [4.3BSD for me]. Here are the gruesome details. The notes are as follows: OK passes the test with NO errors FAILS There is at least ONE error NA The feature is not available. TEST TYPE Diga! A-Talk xterm VT100 (2.6) Handshake v1.21a --------- ----- ------ ----- ----------- ---------------- 1. Test of Cursor movement a) 80 char screen pattern FAILS OK FAILS OK OK b) 132 char screen pattern FAILS OK FAILS FAILS OK Diga! supports 80, 128, and 132 chars/line. A-Talk supports 80 and 128. [Handshake supports 80 and 128 (but acts like 132 by remembering what is in columns 129 through 132 although you cannot see it)] c) cursor control char inside ESC sequence FAILS OK OK OK OK d) leading zeros in ESC sequence OK OK OK OK OK 2. Test of Screen Features a) wrap around mode setting FAILS OK OK OK OK b) Tab setting/resetting OK OK OK FAILS OK c) light background FAILS OK OK FAILS OK d) dark background FAILS OK OK FAILS OK e) scroll up region 2 OK OK OK OK OK f) scroll down region 2 OK OK OK OK OK g) scroll up region 24 OK OK OK OK OK h) scroll down region 24 OK OK OK OK OK Note: only xterm partially supports "soft" scroll. [All others were "jump" scroll (Handshake might "soft", but at 3am it SEEMED to jump).] i) origin mode test 1 OK OK OK FAILS OK j) origin mode test 2 OK OK OK OK OK k) graphics rendition FAILS OK OK OK OK [is anyone else bothered by the look of underlines with inverse characters?] l) save/restore cursor with underscore/blink/reverse FAILS OK OK FAILS OK 3. Test of Character Sets a) USA ASCII OK OK OK OK OK b) UK FAILS OK OK FAILS ASCII c) graphics/line drawing FAILS OK OK OK (prtly) OK d) Alternate ROM 1 FAILS OK FAILS FAILS unknown e) Alternate ROM 2 FAILS FAILS FAILS FAILS unknown 4. Test of double Size Characters [ ** Handshake v1.21a DOES support double size characters! ** ] None of the [other] emulators supports double height/double width character fonts. Most of them will still place the character at the right spot with no garbage around. FAILS here means garbage on screen, OK means no garbage [OKAY means works like vt100]. a) double height/width FAILS OK OK OK OKAY b) Frame with blinking bold FAILS OK OK OK OKAY c) Half box OK OK OK OK OKAY 5. Test of Keyboard [only Handshake shows LEDs. For LED test only: FAILS means garbage on screen, OK means no garbage, OKAY means LEDs display correctly] a) LEDs FAILS OK OK OK OKAY b) Auto-repeat OFF FAILS FAILS OK FAILS OK c) Auto-repeat ON OK OK OK OK OK d) ANSI Reset Cursor Mode OK OK OK OK OK e) VT52 Cursor Mode FAILS FAILS FAILS FAILS OK f) ANSI numeric keypad FAILS OK OK OK OK g) ANSI application keypad FAILS OK OK OK OK Diga! does not remap PF keys and keypad "," in either num. or appl. mode h) VT52 numeric keypad FAILS FAILS FAILS FAILS OK i) VT52 application keypad FAILS FAILS FAILS FAILS OK A-Talk includes a VT52 emulator that passes test e, h and i. j) control codes OK OK OK OK OK 6. Test of Terminal Reports a) Answerback Message NA NA NA NA NA All emulators pass the test, but do not allow entering a message b) Linefeed/Newline Set FAILS OK OK FAILS OK c) Linefeed/Newline Reset OK OK OK OK OK d) Report terminal status FAILS OK OK OK OK e) Report cursor position FAILS OK OK OK OK f) Report device attribute OK OK OK OK OK g) Report Parameters 1 FAILS FAILS OK FAILS OK h) Report Parameters 2 FAILS FAILS OK OK OK 7. Test of VT52 Mode [ ** only Handshake supports VT52 mode ** ] A-Talk includes a separate VT52 emulator that passes the test. Diga! also provides a separate VT52 amulator. 8. Test of VT102 features (insert/delete char/line) a) test 1 [accordian screen] FAILS FAILS OK FAILS OK b) test 2 [insert] FAILS FAILS OK FAILS OK c) test 3 [delete] FAILS FAILS OK FAILS OK [an "a" is in col 1, a "b" in col 132. delete removes everything inbetween so "b" should move to col 2. With Handshake it does, even though display stopped at column 128.] d) test 4 [staggered columns]FAILS OK OK FAILS OK e) test 5 [staggered double ]FAILS OK OK FAILS OK f) ANSI insert char FAILS OK OK FAILS OK 9. Test of reset and Self test a) Reset FAILS OK OK OK OK b) confidence test FAILS OK OK OK OK The only thing that I did not include is the "Test of known bugs". None of the emulators seem to implement any of them. [I ran into bugs 6 and 8 with Handshake] [now back to our regularly scheduled show...] Handshake v1.21a supports file capture/transmit and XMODEM tranfers. You can save your setup, phone book, etc. It has some other features but the above results seem more important (for now). Handshake is shareware written by Eric Haberfellner (BIX=ehaberfellner). He asks for a monetary contribution and suggests the sum of $25. He also lists his phone number for calls after 6 pm EST (416-757-1055). Apparently Handshake is released by: Howlett Gaffran, Inc. 570 Hood Rd Unit 18 Markham Ontario Canada L3R 4G7 because that is where he wants money sent. Eric, as soon as I wrestle the checkbook away from my wife, I will mail you the $25! Will you then add support for Kermit? Mark Strovink (strovink@afit-ab.arpa <- arpanet address) Disclaimer: I have no affiliations with Eric or Howlett Gaffran, Inc. and everything I say is my personal responsibility. Right Mom? Caution: humorous ending under construction. Your tax dollars at work! ========================================================================== - README - ------ Handshake.doc describes how to use this product. Handshake.review is a review from USENET which compares Handshake to other VT100 emulators. Since this is a major new release of Handshake, I would appreciate it if you would report any bugs you find as soon as possible. Don't just assume that someone else has already reported it. Eric Haberfellner THE >> SUBSOFTWARE << IN 90!!... ==========================================================================