Amiga Elysian Archive

home *** CD-ROM | disk | FTP | other *** search

/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / jrc99n.lzh / jrc99n.doc < prev next >

Wrap

Text File | 1990-04-05 | 151KB | 4,290 lines

******* **** **** * * * * * * * * * **** *** ** *** ** * **** **** * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *** * * **** **** * * * * * * Version 1.0 Copyright (C) 1988-90 by John P. Radigan A Shareware telecommunications tool for the Amiga personal computer. DEDICATION ---------------------- In memory of James E. Spessard ii DISCLAIMER ---------------------- No warranties are implied or expressed with regard to the fitness or merchantability of JR-Comm for any particular purpose. All risks and damages, incidental or otherwise, arising through the use or misuse of JR-Comm are entirely at the responsibility of the user. While considerable effort has been made to provide you with a reliable product, there is no guarantee that this program is 100% "bug-free". Any problems that do arise will be corrected when and if feasible. Maintenance releases may be made available in order to correct potentially hazardous situations. Fixes for benign problems will usually be deferred to the next major release of JR-Comm. This disclosure does not guarantee future versions of this product, only a prescribed method of dealing with possible errors, and their corrections, to this program. LICENSE ------------------- JR-Comm is a copyrighted product made available to you under the concept of Shareware. It has never been, and will never be, a Public Domain or otherwise "free" program, therefore, you must obtain a license in order to rightfully use it. So that you may be provided ample time to fully evaluate JR-Comm, you are granted a limited use license for a period of thirty days after initial usage. Registration is required for any continued use past this evaluation period. Commercial or governmental use is limited to one person during the evaluation period. Further use requires registration of every copy in use. Site licenses are available for eleven or more copies per order. They are distributed as one master disk to one contact person. This person is required to limit the number of active copies in circulation equal to or less than the quantity registered. User groups may use the site license discount rates for a one-time group registration for each new release of JR-Comm. The order must be addressed to the Treasurer of the user group and must also include a list of the first and last names of each member who is registering JR-Comm. The list must be printed on user group letterhead. The group will then receive one master disk of JR-Comm along with a list of registration id numbers for the registered members. The group is required to supply disks for copying the master. iii DISTRIBUTION ------------------------ Distribution is limited to the original shareware distribution archive file only, none of the member files may be omitted. Furthermore, no profit or other material gain may be realized for distributing JR-Comm with the sole exception of recovery for media and postage. Bundling JR-Comm, the distribution archive or any member files, with any commercial product is not permitted unless a Commercial Distribution Agreement has been previously obtained from the author. At no time are you allowed to distribute a copy of JR-Comm that has had a user registration ID number installed in it. ACKNOWLEDGEMENTS ---------------------------- Michael Cox for permission to include the SkyPix terminal protocol. Chuck Forsberg for his X/YMODEM and ZMODEM protocol specifications and for his public domain rz.c, sz.c & zm.c source files. Russ Ranshaw for his CompuServe B Plus protocol document. Paul Resch for his BPLUS.C source file, converted from the Pascal source BPLUS.PAS by Russ Ranshaw. Peter Boswell for his WXMODEM protocol document. iv TABLE OF CONTENTS 1 OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 Display features . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 Transfer protocols . . . . . . . . . . . . . . . . . . . . . . 1 1.3 Phonebook . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.4 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . 2 2 SETUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.1 System requirements . . . . . . . . . . . . . . . . . . . . . 4 2.2 Assigned directory/volume . . . . . . . . . . . . . . . . . . 4 2.2.1 JRCOMM: . . . . . . . . . . . . . . . . . . . . . . . . 4 2.2.2 SKYPIX: . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3 JR-Comm files . . . . . . . . . . . . . . . . . . . . . . . . 5 2.4 File search logic . . . . . . . . . . . . . . . . . . . . . . 5 2.5 Limitations in 512k environments . . . . . . . . . . . . . . . 6 2.6 Notes for 1Meg system users . . . . . . . . . . . . . . . . . 6 2.7 Starting JR-Comm for the first time . . . . . . . . . . . . . 6 2.7.1 Registration procedure . . . . . . . . . . . . . . . . 7 2.7.2 User name entry . . . . . . . . . . . . . . . . . . . . 7 2.7.3 Creating the jrcomm.def file . . . . . . . . . . . . . 7 2.7.4 Terminal parameters . . . . . . . . . . . . . . . . . . 7 2.7.5 Serial parameters . . . . . . . . . . . . . . . . . . . 8 2.7.6 Modem parameters . . . . . . . . . . . . . . . . . . . 8 2.7.7 General parameters . . . . . . . . . . . . . . . . . . 8 2.7.8 Saving your defaults . . . . . . . . . . . . . . . . . 8 2.8 Modem setup . . . . . . . . . . . . . . . . . . . . . . . . . 8 2.8.1 Carrier detect signal . . . . . . . . . . . . . . . . . 8 2.8.2 Data terminal ready signal . . . . . . . . . . . . . . 9 2.8.3 The initialization command . . . . . . . . . . . . . . 9 2.8.4 Modem response codes . . . . . . . . . . . . . . . . . 9 2.8.5 Dialer auto-baud feature . . . . . . . . . . . . . . . 10 2.8.6 Additional information for MNP modems . . . . . . . . . 10 2.9 Specific instructions for different modems . . . . . . . . . . 11 2.9.1 Supra Modem 2400 (external) . . . . . . . . . . . . . . 11 2.9.2 MultiTech 224EH (external) . . . . . . . . . . . . . . 11 2.9.3 USRobotics Courier HST (external) . . . . . . . . . . . 12 3 SYSTEM BASICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.1 The display . . . . . . . . . . . . . . . . . . . . . . . . . 13 3.2 Status line . . . . . . . . . . . . . . . . . . . . . . . . . 14 3.3 Connect timer . . . . . . . . . . . . . . . . . . . . . . . . 14 3.4 Time-of-day clock . . . . . . . . . . . . . . . . . . . . . . 15 3.5 Terminal emulations . . . . . . . . . . . . . . . . . . . . . 15 3.5.1 TTY . . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.5.2 Amiga ANSI . . . . . . . . . . . . . . . . . . . . . . 15 3.5.3 IBM color . . . . . . . . . . . . . . . . . . . . . . . 15 3.5.4 IBM mono . . . . . . . . . . . . . . . . . . . . . . . 15 3.5.5 VT100 . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.5.6 SkyPix . . . . . . . . . . . . . . . . . . . . . . . . 16 3.6 Review buffer . . . . . . . . . . . . . . . . . . . . . . . . 16 3.7 Capture file . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.8 Chat mode . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.9 File transfers . . . . . . . . . . . . . . . . . . . . . . . . 17 3.10 Gadget types . . . . . . . . . . . . . . . . . . . . . . . . 18 v 3.10.1 String gadgets . . . . . . . . . . . . . . . . . . . . 18 3.10.2 Option select gadgets . . . . . . . . . . . . . . . . 18 3.10.3 Control gadgets . . . . . . . . . . . . . . . . . . . 18 3.10.4 Intuition gadgets . . . . . . . . . . . . . . . . . . 18 3.11 Keyboard attention sequences . . . . . . . . . . . . . . . . 19 4 SPECIAL REQUESTERS . . . . . . . . . . . . . . . . . . . . . . . . . 20 4.1 YAFR...? . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 4.1.1 Functional description . . . . . . . . . . . . . . . . 20 4.1.2 File lists . . . . . . . . . . . . . . . . . . . . . . 20 4.1.3 SELECT gadget . . . . . . . . . . . . . . . . . . . . . 21 4.1.4 PARENT gadget . . . . . . . . . . . . . . . . . . . . . 21 4.1.5 UNSELECT gadget . . . . . . . . . . . . . . . . . . . . 21 4.1.6 Filename string gadget . . . . . . . . . . . . . . . . 21 4.1.7 Pathname string gadget . . . . . . . . . . . . . . . . 21 4.1.8 OK gadget . . . . . . . . . . . . . . . . . . . . . . . 22 4.1.9 CANCEL gadget . . . . . . . . . . . . . . . . . . . . . 22 4.1.10 Close window gadget . . . . . . . . . . . . . . . . . 22 4.2 Query requester . . . . . . . . . . . . . . . . . . . . . . . 22 5 MENUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.1 Project menu . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.2 Phonebook menu . . . . . . . . . . . . . . . . . . . . . . . . 23 5.3 Buffer menu . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.4 Transfers menu . . . . . . . . . . . . . . . . . . . . . . . . 24 5.5 Options menu . . . . . . . . . . . . . . . . . . . . . . . . . 24 5.6 Misc menu . . . . . . . . . . . . . . . . . . . . . . . . . . 24 5.7 Modes menu . . . . . . . . . . . . . . . . . . . . . . . . . . 24 6 PHONEBOOK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.1 Directory requester . . . . . . . . . . . . . . . . . . . . . 25 6.1.1 DELETE gadget . . . . . . . . . . . . . . . . . . . . . 25 6.1.2 EDIT gadget . . . . . . . . . . . . . . . . . . . . . . 25 6.1.3 DIAL gadget . . . . . . . . . . . . . . . . . . . . . . 25 6.1.4 UNSELECT gadget . . . . . . . . . . . . . . . . . . . . 25 6.1.5 ADD gadget . . . . . . . . . . . . . . . . . . . . . . 25 6.1.6 SORT gadget . . . . . . . . . . . . . . . . . . . . . . 26 6.1.7 LOAD gadget . . . . . . . . . . . . . . . . . . . . . . 26 6.1.8 SAVE gadget . . . . . . . . . . . . . . . . . . . . . . 26 6.1.9 Master password string gadget . . . . . . . . . . . . . 26 6.2 Entry editor requester . . . . . . . . . . . . . . . . . . . . 26 6.2.1 Name string gadget . . . . . . . . . . . . . . . . . . 26 6.2.2 Phone string gadget . . . . . . . . . . . . . . . . . . 26 6.2.3 Macros string gadget . . . . . . . . . . . . . . . . . 26 6.2.4 Capture string gadget . . . . . . . . . . . . . . . . . 27 6.2.5 Password string gadget . . . . . . . . . . . . . . . . 27 6.2.6 Length string gadget . . . . . . . . . . . . . . . . . 27 6.2.7 Dial prefix option gadgets . . . . . . . . . . . . . . 27 6.2.8 Cents/min string gadget . . . . . . . . . . . . . . . . 27 6.2.9 Password type option gadgets . . . . . . . . . . . . . 27 6.2.10 Reset timer gadget . . . . . . . . . . . . . . . . . . 27 6.2.11 Parameter requester gadgets . . . . . . . . . . . . . 28 6.2.12 CANCEL gadget . . . . . . . . . . . . . . . . . . . . 28 6.3 Dialer operation . . . . . . . . . . . . . . . . . . . . . . . 28 6.3.1 Response codes . . . . . . . . . . . . . . . . . . . . 28 6.3.2 Dialer window . . . . . . . . . . . . . . . . . . . . . 29 6.4 Master password . . . . . . . . . . . . . . . . . . . . . . . 29 7 TRANSFER PARAMETERS REQUESTER . . . . . . . . . . . . . . . . . . . . 31 7.1 Protocol gadgets . . . . . . . . . . . . . . . . . . . . . . . 31 7.1.1 Some notes on flow control . . . . . . . . . . . . . . 32 vi 7.2 ASCII send parameters . . . . . . . . . . . . . . . . . . . . 32 7.2.1 Expand blanks gadget . . . . . . . . . . . . . . . . . 32 7.2.2 Prompt char string gadget . . . . . . . . . . . . . . . 33 7.2.3 Char delay string gadget . . . . . . . . . . . . . . . 33 7.2.4 Line delay string gadget . . . . . . . . . . . . . . . 33 7.3 Miscellaneous parameters . . . . . . . . . . . . . . . . . . . 33 7.3.1 Binary mode gadget . . . . . . . . . . . . . . . . . . . . . 33 7.3.2 Save aborted gadget . . . . . . . . . . . . . . . . . . 33 7.3.3 Relaxed timing gadget . . . . . . . . . . . . . . . . . 33 7.3.4 Auto chop gadget . . . . . . . . . . . . . . . . . . . 33 7.3.5 Overdrive gadget . . . . . . . . . . . . . . . . . . . 34 7.4 ZMODEM options . . . . . . . . . . . . . . . . . . . . . . . . 34 7.4.1 Resume transfer gadget . . . . . . . . . . . . . . . . 34 7.4.2 Auto download gadget . . . . . . . . . . . . . . . . . 34 7.4.3 Auto d/l challenge gadget . . . . . . . . . . . . . . . 34 7.4.4 Escape ctrl chars gadget . . . . . . . . . . . . . . . 34 7.4.5 32 bit CRC gadget . . . . . . . . . . . . . . . . . . . 34 7.5 ZMODEM send modes . . . . . . . . . . . . . . . . . . . . . . 35 7.5.1 Skip if absent gadget . . . . . . . . . . . . . . . . . 35 7.5.2 Newer gadget . . . . . . . . . . . . . . . . . . . . . 35 7.5.3 Newer/longer gadget . . . . . . . . . . . . . . . . . . 35 7.5.4 CRC different gadget . . . . . . . . . . . . . . . . . 35 7.5.5 Append files gadget . . . . . . . . . . . . . . . . . . 35 7.5.6 Overwrite files gadget . . . . . . . . . . . . . . . . 35 7.5.7 Protect all files gadget . . . . . . . . . . . . . . . 35 7.5.8 Don't care gadget . . . . . . . . . . . . . . . . . . . 35 8 SERIAL PARAMETERS REQUESTER . . . . . . . . . . . . . . . . . . . . . 36 9 MODEM PARAMETERS REQUESTER . . . . . . . . . . . . . . . . . . . . . 37 9.1 Modem commands . . . . . . . . . . . . . . . . . . . . . . . . 37 9.1.1 Init command string gadget . . . . . . . . . . . . . . 37 9.1.2 Hangup command string gadget . . . . . . . . . . . . . 37 9.1.3 Dial prefix string gadget . . . . . . . . . . . . . . . 37 9.1.4 Dial postfix string gadget . . . . . . . . . . . . . . 37 9.2 Alternate dial prefixes . . . . . . . . . . . . . . . . . . . 37 9.3 Response code string gadgets . . . . . . . . . . . . . . . . . 38 9.4 Dialer parameters . . . . . . . . . . . . . . . . . . . . . . 38 9.4.1 Redial delay string gadget . . . . . . . . . . . . . . 38 9.4.2 # of retries string gadget . . . . . . . . . . . . . . 38 9.4.3 Dial timeout string gadget . . . . . . . . . . . . . . 38 9.5 Miscellaneous options . . . . . . . . . . . . . . . . . . . . 38 9.5.1 Ignore Carrier Detect gadget . . . . . . . . . . . . . 38 9.5.2 Hang up on dialer exit gadget . . . . . . . . . . . . . 38 9.5.3 Dialer auto-baud gadget . . . . . . . . . . . . . . . . 39 9.5.4 Drop DTR to hangup gadget . . . . . . . . . . . . . . . 39 9.5.5 Flush with a BREAK gadget . . . . . . . . . . . . . . . 39 9.6 Screen type options . . . . . . . . . . . . . . . . . . . . . 39 9.7 Font size . . . . . . . . . . . . . . . . . . . . . . . . . . 39 9.8 Terminal type . . . . . . . . . . . . . . . . . . . . . . . . 39 9.9 EOL out option gadgets . . . . . . . . . . . . . . . . . . . . 39 9.10 Capture filters . . . . . . . . . . . . . . . . . . . . . . . 40 9.10.1 ANSI codes gadget . . . . . . . . . . . . . . . . . . 40 9.10.2 CTRL chars gadget . . . . . . . . . . . . . . . . . . 40 9.10.3 Backspaces gadget . . . . . . . . . . . . . . . . . . 40 9.11 Miscellaneous options . . . . . . . . . . . . . . . . . . . . 40 9.11.1 Strip high bit gadget . . . . . . . . . . . . . . . . 40 9.11.2 Custom palette gadget . . . . . . . . . . . . . . . . 40 9.11.3 Destructive BS gadget . . . . . . . . . . . . . . . . 40 9.11.4 Swap DEL & BS gadget . . . . . . . . . . . . . . . . . 40 9.11.5 Smooth scroll gadget . . . . . . . . . . . . . . . . . 41 vii 9.11.6 Chat line on gadget . . . . . . . . . . . . . . . . . 41 9.11.7 Wrap lines gadget . . . . . . . . . . . . . . . . . . 41 9.11.8 IBM Doorway mode gadget . . . . . . . . . . . . . . . 41 9.11.9 Cursor blink gadget . . . . . . . . . . . . . . . . . 41 9.11.10 Optimized scroll gadget . . . . . . . . . . . . . . . 41 9.11.11 Add linefeeds . . . . . . . . . . . . . . . . . . . . 41 9.12 Answerback message string gadget . . . . . . . . . . . . . . 41 9.13 Color string gadgets . . . . . . . . . . . . . . . . . . . . 42 9.13.1 Text color string gadget . . . . . . . . . . . . . . . 42 9.13.2 Background string gadget . . . . . . . . . . . . . . . 42 9.13.3 Cursor string gadget . . . . . . . . . . . . . . . . . 42 10 MACROS REQUESTER . . . . . . . . . . . . . . . . . . . . . . . . . . 43 10.1 Macro escape codes . . . . . . . . . . . . . . . . . . . . . 43 11 PALETTE REQUESTER . . . . . . . . . . . . . . . . . . . . . . . . . 44 11.1 Red Green and Blue proportional gadgets . . . . . . . . . . . 44 11.2 Color select gadgets . . . . . . . . . . . . . . . . . . . . 44 11.3 RESET gadget . . . . . . . . . . . . . . . . . . . . . . . . 44 11.4 UNDO gadget . . . . . . . . . . . . . . . . . . . . . . . . . 44 11.5 Palette usage . . . . . . . . . . . . . . . . . . . . . . . . 44 11.5.1 Default palettes . . . . . . . . . . . . . . . . . . . 44 11.5.2 Phonebook entry palettes . . . . . . . . . . . . . . . 45 12 GENERAL PARAMETERS REQUESTER . . . . . . . . . . . . . . . . . . . . 46 12.1 Status line options . . . . . . . . . . . . . . . . . . . . . 46 12.1.1 Status line active gadget . . . . . . . . . . . . . . 46 12.1.2 Time of day clock gadget . . . . . . . . . . . . . . . 46 12.1.3 Connect timer gadget . . . . . . . . . . . . . . . . . 46 12.1.4 24 hour mode gadget . . . . . . . . . . . . . . . . . 46 12.2 Miscellaneous options . . . . . . . . . . . . . . . . . . . . 46 12.2.1 CTS/RTS handshake gadget . . . . . . . . . . . . . . . 46 12.2.2 Immediate exit gadget . . . . . . . . . . . . . . . . 46 12.2.3 Logfile active gadget . . . . . . . . . . . . . . . . 46 12.2.4 Split review gadget . . . . . . . . . . . . . . . . . 47 12.2.5 File saver gadget . . . . . . . . . . . . . . . . . . 47 12.2.6 Sound beep gadget . . . . . . . . . . . . . . . . . . 47 12.3 String gadgets . . . . . . . . . . . . . . . . . . . . . . . 47 12.3.1 GMT offset string gadget . . . . . . . . . . . . . . . 47 12.3.2 Task priority string gadget . . . . . . . . . . . . . 47 12.3.3 Chat history size string gadget . . . . . . . . . . . 48 12.3.4 Review buffer size string gadget . . . . . . . . . . . 48 12.3.5 Transfer buffer size string gadget . . . . . . . . . . 48 12.4 Default filename string gadgets . . . . . . . . . . . . . . . 48 12.5 Paths string gadgets . . . . . . . . . . . . . . . . . . . . 48 12.6 Font string gadgets . . . . . . . . . . . . . . . . . . . . . 48 12.7 Serial device string gadgets . . . . . . . . . . . . . . . . 48 13 MISC MENU ITEMS . . . . . . . . . . . . . . . . . . . . . . . . . . 49 13.1 Timer reset . . . . . . . . . . . . . . . . . . . . . . . . . 49 13.2 Send break . . . . . . . . . . . . . . . . . . . . . . . . . 49 13.3 Hangup modem . . . . . . . . . . . . . . . . . . . . . . . . 49 13.4 Clear screen . . . . . . . . . . . . . . . . . . . . . . . . 49 13.5 Print screen . . . . . . . . . . . . . . . . . . . . . . . . 49 13.6 Registration . . . . . . . . . . . . . . . . . . . . . . . . 49 14 MODES MENU ITEMS . . . . . . . . . . . . . . . . . . . . . . . . . . 50 14.1 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 14.2 Chat line . . . . . . . . . . . . . . . . . . . . . . . . . . 50 14.3 HEX output . . . . . . . . . . . . . . . . . . . . . . . . . 50 14.4 IBM Doorway . . . . . . . . . . . . . . . . . . . . . . . . . 50 viii 14.5 Screen title . . . . . . . . . . . . . . . . . . . . . . . . 50 15 INFORMATIONAL MESSAGES . . . . . . . . . . . . . . . . . . . . . . . 51 15.1 Directory not found . . . . . . . . . . . . . . . . . . . . . 51 15.2 User font not found . . . . . . . . . . . . . . . . . . . . . 51 15.3 Can't load file, wrong version . . . . . . . . . . . . . . . 51 15.4 Can't open log file . . . . . . . . . . . . . . . . . . . . . 51 15.5 File already exists, resume d/l? . . . . . . . . . . . . . . 51 15.6 File already exists, overwrite? . . . . . . . . . . . . . . . 51 15.7 Really quit JR-Comm? . . . . . . . . . . . . . . . . . . . . 51 15.8 Unable to open printer . . . . . . . . . . . . . . . . . . . 51 15.9 Review buffer is empty . . . . . . . . . . . . . . . . . . . 52 15.10 Print registration form? . . . . . . . . . . . . . . . . . . 52 15.11 File jrcomm is missing . . . . . . . . . . . . . . . . . . . 52 16 WARNING MESSAGES . . . . . . . . . . . . . . . . . . . . . . . . . . 53 16.1 Directory read error . . . . . . . . . . . . . . . . . . . . 53 16.2 Could not open screen . . . . . . . . . . . . . . . . . . . . 53 16.3 Could not open window . . . . . . . . . . . . . . . . . . . . 53 16.4 Capture file currently open! . . . . . . . . . . . . . . . . 53 16.5 Protocol requires handshaking . . . . . . . . . . . . . . . . 53 16.6 Couldn't open capture file . . . . . . . . . . . . . . . . . 53 16.7 CTS disabled, no CTS present . . . . . . . . . . . . . . . . 53 16.8 CTS disabled, no DSR present . . . . . . . . . . . . . . . . 53 16.9 CTS disabled, shared mode . . . . . . . . . . . . . . . . . . 53 16.10 Session will expire in 5 mins . . . . . . . . . . . . . . . 54 17 FATAL ABORT MESSAGES . . . . . . . . . . . . . . . . . . . . . . . . 55 18 SUPPORT INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . 56 ix JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 1 OVERVIEW 1.1 Display features - JR-Comm automatically adjusts itself to either NTSC or PAL displays, interlace and overscan is supported as well. - Terminal emulations for TTY (dumb terminal) Amiga ANSI, IBM ANSI (color and monographic modes), VT100 and SkyPix. - An optional status line with hidden gadgets for easy adjustment of transfer protocol, duplex, XON/XOFF flow control, data length, parity, stop bits, baud rate and resetting of the connect timer. - 40 definable function key macros per macro file. Each macro can contain a maximum of 160 characters. Several macro primitives are available, like chaining to another macro or loading other phonebook and macro files. - A special keyboard mode for IBM scan codes. Allows 100% compatibility with remote DOS programs available in the MS- DOS world. DoorWay is one of the more popular programs in use with certain BBS installations. - Split review buffer option that allows simultaneous terminal I/O while viewing the contents of the review buffer. - Chat mode provides line editing and history features. Natural control codes are immediately sent whereas escaped control codes are inserted in the chat line buffer. - Optimized scrolling option for boosting throughput of multiple bit-plane displays. - Smooth-scroll option available. - User definable font available. 1.2 Transfer protocols - CIS B+, XMODEM, XMODEM-1k, WXMODEM, YMODEM, YMODEM-g, ZMODEM and ASCII file transfer protocols are present. All implementations adhere strictly to their respective specifications. JR-Comm provides file transfer throughput that exceeds most every telecommunications product that is currently available for the Amiga computer. - JR-Comm has the most complete ZMODEM implementation of any currently available Amiga telecommunications product. Auto- downloads and a full set of upload send options are a few of the available functions for this protocol. - 1 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 - All file I/O is handled asynchronously to provide floppy disk users with throughput figures that are simply unobtainable with lesser telecommunications products. - Upload overdrive option for ZMODEM and YMODEM-g protocols that provide the absolute maximum in throughput speed for users with high-speed modems. - Intelligent auto-chop for XMODEM, XMODEM-1k and WXMODEM protocols. - ASCII send has options for character and line delays as well as prompt mode for line oriented editors. Blank line expansion is also available. 1.3 Phonebook - Each phonebook file can contain up to 9999 entries. Each entry is capable of completely re-configuring JR-Comm. - Ability to generate a unique password for each directory entry based upon a master password for each phonebook file. - Sort options available for name, phone number or in user selected ordering. - An intelligent dialer that monitors the results of each attempt and is capable of multiple entry dialing in order of selection. - Automatic baud rate detection option for Hayes compatible modems. 1.4 Miscellaneous - A powerful file requester that maintains several lists of files, devices and directories rather than hardcoded selections that may not exist on your system, or even worse, may not include devices/volumes unique to your environment. A batch selection facility unique among any other telecommunications product which enables you to select files from any number of directories in a simple manner. - User adjustable task priority, chat history, review and transfer buffer sizes. - User definable serial device for third party multi-port boards. - Optional file saver to prevent complete loss of file if a system crash occurs during a download. - 2 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 - Special keyboard sequence which releases the serial.device in the event of a lock-up when an XOFF character is received while XON/XOFF handshake is active. - 3 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 2 SETUP 2.1 System requirements Version 1.2 Workbench or later is required. A minimum memory size of 1Meg is highly recommended. Users with 512k of memory can run JR-Comm, but their system will be very limited. PAL users with 512k may have to remove some external drives due to the larger vertical display that it uses. In both cases the 2 color screen must be used. If you're using a shell, like the Amiga shell in 1.3 or WShell you may not have enough memory to access the editor functions of the phonebook. An external phonebook editor was created just for this purpose. The recently released 1.3.2 version serial.device will provide you with somewhat better performance although the original driver works just fine. A Hayes compatible modem is preferred but not essential. Although you will need the former style of modem if you intend to utilize all that the intelligent dialer has to offer. The modem should at least have a functional carrier detect signal. Recognition of the DTR signal by the modem is not required, but does make hanging up the modem much easier. JR-Comm was written with high-speed modems in mind. Tests have been conducted locally during development with a 14.4kbps US Robotics HST and with a MultiTech 224EH MNP 2400bps modem. Please see the section below on modems for more information. The installation instructions described below assume a certain level of familiarity with the AmigaDOS CLI. "The AmigaDOS Manual", 2nd. edition, from Bantam Computer Books is a valuable book to have and is highly recommended. 2.2 Assigned directory/volume names 2.2.1 JRCOMM: JR-Comm will look for this assigned directory or floppy disk volume name when it is first started. If it is present, JR- Comm will load and save its data files here. It is not required to be present though, the assigned directory S: will be used instead. - 4 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 2.2.2 SKYPIX: This assignment (or floppy disk volume name) is used when then SkyPix terminal emulation is active. Like the JRCOMM: assignment, it is optional. The default would be ram: if this assignment is not present. 2.3 JR-Comm files There are four data files that JR-Comm uses. Their postfixes are listed was follows: .def The default parameters file. JR-Comm will search for a file named jrcomm.def when it is first loaded. See the search order section described below. .phones Phonebook file. Contains a list of phonebook entries which are used by the intelligent dialer. The file jrcomm.phones will be loaded if found when JR-Comm is first started. .macros Function key macros file. Holds up to 40 separate 160 character macros. JR-Comm looks for a jrcomm.macros file when it is first started. .log Optional file. JR-Comm writes status entries to this file if the logfile option is active. 2.4 File search logic JR-Comm uses a single pathname to locate all related data files. When you first start the program it will assign either JRCOMM: (if it is present) or S: as the data files pathname. The current directory is first checked for the file jrcomm.def. It will be loaded if found, otherwise JR-Comm searches the data files path that was set above (S: or JRCOMM:). An internal set of defaults will be used if no file is located in either directory. All other files will be searched for in the data files path only. But, the jrcomm.def file is able to set this to an alternate pathname for re-direction when it is loaded. Floppy based systems probably won't benefit from using this redirection feature, it is of more use to hard disk users who can have different environments conveniently located under one directory. Floppy disk users would do better to make multiple copies of their JRCOMM: master disk and configure each disk for different environments instead. - 5 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 2.5 Limitations in 512k environments You must use a 2 color screen with this set-up. This leaves you with about 100k of free memory once JR-Comm is loaded. The extra bit of free memory gives you enough room to open the various requesters in the program. Worst case would be having the terminal requester open when editing a phonebook entry. This situation has three requesters open simultaneously and uses about 40k of additional memory. If you decide to use a different depth screen you will find that some, if not all, of the requesters cannot be opened from lack of memory. If you end up in this situation exit JR-Comm via the <RAMIGA>Q sequence and delete your jrcomm.def file to reset JR-Comm to its internal defaults. You may also have to remove any additional floppy drives past DF1: Each drive frees up about 26k of memory. Users running a PAL display will have somewhat less memory due to the additional scan lines that are available with it. 2.6 Notes for 1Meg system users Although an Amiga outfitted with 1 megabyte of ram enables you to run JR-Comm with a 16 color display, you are going to find that the program is going to operate very slowly. This is due to not having any true fast ram, even though the AmigaDOS Avail command may say that 512k of it is recognized as fast ram. Without any true fast ram available, the 68000 cpu is prevented from running code while the display is being painted on your monitor and while the blitter is doing scroll operations. In effect, your machine is being slowed down by as much as (or more than) 50%. Depending on how you use JR-Comm, you may find that dropping down to an 8 color display will give you enough extra processing power to achieve your telecommunications goals. 2.7 Starting JR-Comm for the first time JR-Comm will use its internal defaults the first time you start it. You can save any changes you make so that JR-Comm will configure itself to these settings every time it is used afterwards by writing the defaults to the file jrcomm.def. Registered users will need to start JR-Comm the first time with the jrcomm file in the current directory so that the - 6 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 registration number can be installed in the file. Do not distribute this copy of JR-Comm after you have installed your registration ID in it. 2.7.1 Registration procedure Registered users can deactivate the 3 hour session timer that prevents unlimited usage of JR-Comm for unregistered users. By selecting the Registration menu item in the Misc menu, a registration ID requester is openned. Enter your registration number so that JR-Comm can install this inside itself. The jrcomm executable file must be in the current directory for this to succeed. If you are an un-registered user just press return without entering any other text in the string gadget, you could also select the close window gadget in the upper left corner of the registration ID requester. A new registration requester will be openned which will allow you to print out a registration form and license when you are ready to register yourself. 2.7.2 User name entry Anytime JR-Comm fails to find a jrcomm.def file when it starts it will ask for the users first and last name. This is saved in the jrcomm.def file. 2.7.3 Creating the jrcomm.def file Once you see the flashing cursor you are ready to set the basic default parameters and write them to the jrcomm.def file. 2.7.4 Terminal parameters Users with only 512k of memory should open the terminal parameters requester to set a two color screen prior to doing anything else. Otherwise you will probably not be able to continue any further due to not being able to open any other requesters. Open the requester by selecting the terminal menu item in the options menu. Set the available options to your liking. See the section on the terminal parameters for more detailed information of each option. - 7 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 2.7.5 Serial parameters Open the serial port parameters requester by selecting the serial menu item in the options menu. Set the appropriate parameters for your set-up, the defaults provided are usually sufficient. 2.7.6 Modem parameters This requester provides you with numerous options to tailor JR-Comm to the modem you are using. See the sections on modem installation and on the modem parameters requester for additional information. 2.7.7 General parameters Notice the string gadget labeled JR-Comm files, it should contain either JRCOMM: or S:. If you wish to use the current directory exclusively for all JR-Comm files then you must select this gadget and delete its contents. Leave it alone otherwise. If you are using a third party multi-port serial board or an alternate serial device driver please enter the proper information in the lower right string gadgets. You will have to exit and then re-start JR-Comm if you changed this. If you are using an MNP or other high-speed modem that requires a fixed baud rate you will most likely need to set the CTS/RTS handshake option too. Please see the section below about modems prior to doing this. 2.7.8 Saving your defaults At this point you can save these setting by selecting the write defaults menu item in the project menu. A file requester will open and the filename shown should be jrcomm.def. Select the "OK" button or press return to write the defaults. 2.8 Modem setup Hayes compatible modems are preferred for use with JR-Comm. Fortunately, almost every modem made today is Hayes compatible. The specific features the modem should have are discussed below. 2.8.1 Carrier detect signal The modem should have a functioning carrier detect (CD) signal on pin 8 of the serial port. The CD signal becomes - 8 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 true when the modem connects to another modem and establishes a carrier between the two devices. This signal is what JR-Comm uses to advance the connect timer in the status line. It is also used by the dialer to detect when a connection has been established. Some modem manufacturers default the modem to permanently assert this signal true. If the timer starts to increment after starting JR-Comm, then this is the case. Refer to your modem manual to set your modem so that it allows the CD signal to work properly. If you cannot get the CD to work then you should activate the gadget button labeled "Ignore carrier detect" in the modem requester. You should also turn off the connect timer in the general requester too. 2.8.2 Data terminal ready signal This signal (DTR) on pin 20 of the serial port tells the modem when the data terminal, JR-Comm in this case, is ready. JR-Comm also uses this signal, if the modem recognizes it, to force the modem to hang up or go on hook. As with the CD signal, many manufacturers will assert this signal permanently true also. Check the manual for the modem to determine if the modem will go on hook and then return to its command state when the DTR signal is dropped and then raised again. If it can then set the modem up to allow this and also set the "Drop DTR to hang up" gadget in the modem requester. 2.8.3 The initialization command The modem requester has a string gadget that is set to the following Hayes compatible modem command: "ATZ^M~~~ATE1 Q0 V1 X4^M" This command is most likely fine as it is. Again, modify it to your needs for your particular modem. The '~' character inserts a one half second delay, it is not sent to the modem. 2.8.4 Modem response codes The list of response codes in the modem requester should also not need to be changed if you modem is Hayes compatible. Change them otherwise. - 9 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 2.8.5 Dialer auto-baud feature The dialer has the ability to automatically adjust JR-Comm's baud rate to that of the connection. To do this properly you modem must be able to tag a numeric value to the connect response. If no number is added then the auto-baud feature will set the rate to 300 baud. The X4 command should accomplish this. 2.8.6 Additional information for MNP modems In order to use an MNP modem properly, and to maximize the throughput they are capable of delivering, you need to set JR-Comm and the modem to a fixed baud rate that is usually 2 or 4 times greater than the connection rate between the local and remote modem. Since JR-Comm is now capable of sending data at a baud rate that is higher than what the two modems are connected at, it requires some sort of handshaking so that no data losses occur. The kind of handshaking most often used in this type of situation is hardware, or CTS/RTS handshaking. If you plan to download to a floppy disk and are going to use ZMODEM, you must have XON/XOFF handshake active in order for the serial.device to stop the flow of data while writing to disk. YMODEM-g transfers to floppy are not possible when using the internal serial.device due to it not dropping RTS when the serial input buffer is almost full. XON/XOFF handshake is disabled for YMODEM-g because it needs full 256 byte transparency for successful transfers. If you are using an alternate serial.device that supports RTS handshake then YMODEM-g to floppy is possible. The default serial device for the internal port in the Amiga has an oddity in that it requires the DSR signal to be active when it is first opened or it will not use the CTS/RTS handshake mode. Most MNP modems default to have the DSR signal (pin 6) follow the carrier detect signal, fortunately, they always have a command and/or switch to permanently set DSR active. Set your modem to keep DSR high if you wish to use CTS/RTS handshaking. In addition to the DSR signal having to be permanently asserted, your modem must have CTS true when the modem is not online. Check the manual for your modem to insure that these two signals are set up correctly or else JR-Comm will notify you that it was unable to honor your request for CTS/RTS handshaking and will open the serial device in normal mode instead. - 10 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 2.9 Specific instructions for different modems 2.9.1 Supra Modem 2400 (external) This is your basic, no-frills, Hayes compatible 2400bps modem. Unlike most older modems, this one has no dip switches to configure the modem for operation. Instead, it has a non-volatile ram area which holds the current modem settings when it is turned off. A special modem command writes the settings to ram after you've configured it. There should also be a companion command to reset the modem to the default factory configuration. The sequence of modem commands to configure this modem for use with JR-Comm are as follows: 1. AT&F (reset modem to factory defaults) 2. AT&C1&D2&W &C1 - Carrier detect functions normally. &D2 - Hang-up and return to command mode. &W - Write settings to NVRAM. 3. Set modem init string in modem requester to "ATZ^M". Carrier detect and DTR will operate as expected and you can use the DTR to hang up option with this configuration. 2.9.2 MultiTech 224EH (external) The 224EH is a 2400bps Level 5 MNP modem. It should be representative of most Hayes compatible MNP modems that are available today. Configuration sequence for this modem is: 1. Set switches to: 12345678 1234 11010110 0110 (0 - OFF 1 - ON) 2. AT&F (reset modem to factory defaults) 3. ATB1X4&E1&E4&Q1$BA0&C1&R2&S0&W0 B1 - Wait-for-dialtone dialing. X4 - Hayes dialtone and busy detection. &E1 - enable MNP auto-reliable mode. &E4 - CTS/RTS flow control. &Q1 - Hayes Smartmodem 2400 responses. $BA0 - Baud adjust off. &C1 - Carrier detect functions normally. &R2 - CTS drops for 2 seconds on disconnect. &S0 - DSR permanently asserted. &W0 - Write settings to NVRAM. 4. Set init string to "ATZ^M". 5. Set dial prefix to "AT&E1&E14DT" 6. Set alternate dial prefix #1 to "AT&E1&E15DT". 7. Set alternate dial prefix #2 to "AT&E0DT". - 11 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 The three different dial prefixes are needed to enable and disable the MNP mode before dialing. This is needed due to the inability of a true Hayes modem to successfully complete a connection when an MNP modem calls it. The default dial prefix enables MNP without data compression. This one should be used when there is the possibility of transferring an archive file since compression will delay the transfer. Alternate dial prefix #1 will enable both MNP and data compression which will greatly increase throughput for text only transfers. The last prefix will disable MNP for calling true Hayes modems. If the connection is made but no data is seen you should try calling back with MNP disabled to see if it now works. If it does this number is most likely a true Hayes modem and you should use this prefix for all future calls. 2.9.3 USRobotics Courier HST (external) The Courier HST is an example of the latest in high-speed modem technology. The version discussed here is the newer 14.4kbps HST without the V.32 option. Configuration sequence for this modem is: 1. Set switches to: 1234567890 1 1101011001 1 (0 - OFF 1 - ON) 2. AT&F (reset modem to factory defaults) 3. ATB1X6&B1&H1&K0&R2&S0&Y0&W B1 - HST mode. X6 - Enable VOICE response. &B1 - Fixed DTE rate. &H1 - CTS/RTS flow control. &K0 - Disable data compression. &R2 - Pass data on RTS high. &S0 - Set DSR high permanently. &Y0 - Destructive break signal. &W - Write settings to NVRAM. 4. Set init string to "ATZ^M". 5. Set dial prefix to "AT&M4&K0DT" 6. Set alternate dial prefix #1 to "AT&M4&K1DT". 7. Set alternate dial prefix #2 to "AT&M0&K0DT". You may want to use "X4" instead of "X6" if you get a lot of false VOICE responses. The dial prefixes function exactly like the ones for the MultiTech modem discussed above, see that section for a description of the prefixes. - 12 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 3 SYSTEM BASICS 3.1 The display The default display used is a borderless Workbench window. Although not visible, there is the usual front/back gadget pair in the upper right corner of the window. Optional displays include borderless windows on a 2, 4, 8 or 16 color custom screen. A menu item is available which toggles the display of the screen title so that you can drag down the JR- Comm custom screen. Programs such as QMouse and Mach enable you to swap screens quite easily and are recommended for use with JR- Comm sessions that use a custom screen. The color palette allows the user to modify the colors for each phonebook entry. There is one user configured default palette as well as hard-coded palettes for IBM color, VT100 and SkyPix emulations. See the section on the palette requester for more information. The default console device used by the Amiga for the CLI and other text based displays is slow compared to the custom display included within JR-Comm. A sprite is used to implement the cursor in JR-Comm. This allows for faster text rendering since the blitter doesn't have to be called on each time in order to restore the present position prior to moving the cursor to a new location. An unfortunate side-effect of using a sprite is that a block style cursor is not possible since it would hide any character that is underneath it. An optimized scroll mode is available to boost average throughput of 8 and 16 color displays. With this feature enabled, JR-Comm will use the minimum horizontal width and number of bit-planes needed to satisfy a scroll operation. This option greatly reduces DMA requirements when the smooth scroll feature is active. Two internal fonts are provided, one for a normal display, the other for use with interlace screens. Interlace provides 25 and 50 line fonts. A set of external fonts are provided for use with the VT100 and SkyPix terminal emulation modes. In addition, there is the option for user definable fonts if desired. - 13 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 3.2 Status line The status line in JR-Comm is normally displayed as follows. .....(status/chat)..... * X FX 8N1 9600 00:00:00 7:30 pm | |||| ||| | | | | | | Printer ---------+ |||| ||| +--+ +------+ +-----+ @!Protocol -----------+||| ||| | | | @(VT100 use only) ------------+|| ||| | | | @!Duplex -------------+| ||| | | | @!Handshake --------------+ ||| | | | !Data bits ----------------+|| | | | !Parity -----------------+| | | | !Stop bits ------------------+ | | | !Baud rate --------------------+ | | !Connect timer ---------------------------+ | !Time of day -------------------------------------+ The items above that are marked with an exclamation point have invisible gadgets associated with them which allow you to toggle through the available values for that particular item. The handshake item will only enable and disable XON/XOFF flow control. Hardware or CTS/RTS flow control can only be selected while off-line from the general parameters requester. The connect timer will be reset when its gadget is selected. The time-of-day clock will toggle between 12 and 24 hour modes. Items marked with a '@' symbol are replaced by periods when using the VT100 emulation. These four dots represent the four LED indicators on a real VT100 terminal. When the indicator "on" it is signified by an asterisk. The gadgets that are available in an emulation other than VT100 are disabled while VT100 is active. The dotted line to the left of the above status line indicates the status message and chat line area. ASCII send and capture filenames will be displayed here while the chat line mode is inactive. Three special characters are used to describe the type of file being processed. They are: < The left angle bracket character indicates when an ASCII send is in progress. > A single right angle bracket character signifies a new or cleared capture file is open. >> A pair of right angle brackets are used when the capture file is opened in append mode. 3.3 Connect timer The connect timer will increment while a carrier detect signal is present from the modem (the CD signal from your modem must be functional for this feature to work properly). If the cents/min option is set to a non-zero value in a particular phonebook entry, the connect timer toggles every four seconds between total - 14 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 connect time elapsed and the accumulated total for this connection in dollars/cents. 3.4 Time-of-day clock The clock is capable of displaying the time-of-day in either 12 or 24 hour mode. It may also be turned off. 3.5 Terminal emulations 3.5.1 TTY The TTY emulation is your basic line oriented dumb terminal. The high bit is always reset on any incoming data when using this emulation. 3.5.2 Amiga ANSI This mode emulates the AmigaDOS console device. 3.5.3 IBM color Excepting the lack of blinking characters, this emulation provides you with a 100% accurate IBM ANSI terminal. When the IBM scan codes feature is active, your Amiga will faithfully emulate remote DOS operations equal to MS-DOS telecomm programs such as QMODEM. 3.5.4 IBM mono This emulation provides both the hi-intensity and blinking characters attributes of IBM monochrome displays. Amiga display limitations prevent having these two attributes available with the color emulation, so this mode was provided in the event that you must have the blinking attribute present. 3.5.5 VT100 This emulation provides you with an almost complete VT100 terminal. The keypads on the A500 and A2000 keyboards fully represent the VT100 keypad with the top row of keys on the Amiga being the PF keys. The <ALT><F1-4> function key sequences will produce PF key equivalents for the A1000 keyboard. The macros for these function key combinations are disabled while using this emulation. - 15 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 3.5.6 SkyPix This emulation provides a unique graphics and sound terminal capability for use with the Atredes and SkyLine bulletin board systems. Please be aware of the silent file transfer capability of this emulation, it sends sound and brush files without bringing up the file transfer requester, a prompt of the filename being received is shown in the status window so that you are aware of the transfer taking place. The receive indicator on your modem will also flash in the same manner as an XMODEM transfer because that is what is used for this emulation. 3.6 Review buffer The review buffer holds a portion of the most recently received data. The size of the review buffer is user defined and defaults to 16k. If the status line is enabled it will display a message indicating when JR-Comm is in review mode. When the review mode is first started it will fill the screen with the most recent data received. The review buffer is controlled by the following key sequences. <CTRL><UP> Move to the beginning of the buffer. <SHIFT><UP> Move up one display page. <UP> Move up one line. <CTRL><DOWN> Move to the end of the buffer. <SHIFT><DOWN> Move down one display page. <DOWN> Move down one line. <ESC> End review mode, return to the terminal. 3.7 Capture file The capture file feature allows you to save data received by JR- Comm. There are four ways the capture file can be opened. The first two opens a new file (deletes the contents of an existing file). The second two will open an existing file in append mode. Each major mode has a sub-mode that will save the contents of the review buffer too. The capture buffer is operated in asynchronous file I/O mode so that maximum throughput is achieved when capturing large amounts of data. See the chapter on the terminal parameters requester for information on the capture filters that are available. 3.8 Chat mode Line editing is available while in the chat mode. The left and right cursor keys move through the current line. The delete key has two functions, alone it deletes the character underneath the - 16 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 cursor, when pressed while the shift key is down it will insert a blank at the current cursor position. The <BACKSPACE> key works as expected. If the return key is pressed while in the middle of the chat line the complete line will be transmitted to the modem. Several other editing functions are available with the left and right arrow keys when used with the <ALT>, <SHIFT> and <CTRL> keys. They are: <ALT> Move cursor to left or right of chat line display. <CTRL> Move cursor to start or end of the chat line. <SHIFT> Move cursor left or right one word. The chat mode also has a history buffer which can be accessed via the up and down cursor keys. The default size of 50 lines is used unless you have increased or decreased it. Natural control characters are sent to the serial port immediately while in chat mode. This is convenient when you need to stop and re-start the display via the <CTRL>-S and <CTRL>-Q sequences. Finally, the '^' character can be used to send control characters out via the chat line. Two '^' characters in a row will send the '^' character itself. 3.9 File transfers When you initiate a file upload or download you are first greeted with the file requester. Select the desired file(s) for an upload or enter the new filename for a download when using a protocol other than CIS B+, YMODEM(-g) or ZMODEM. These protocols send the filename in a special header block, so the file requester isn't opened when downloading via these protocols. The transfer status window is then opened. The information this window displays is as follows: Filename Filename being transferred. Size Size of file being transferred. Estimated time Estimated from baud rate, filesize and protocol efficiency figure. Actual time Self explanatory. Total xfer'd or Block Block or percentage of file transferred so far. Chars/sec Throughput figure, does not include protocol overhead data in computation. Total errors Received during the transfer. Errors this block For this block only. Last response Status line. Selecting the close window gadget while a transfer is in progress will abort the transfer. Please be patient if you do abort it, as JR-Comm attempts to purge all data before returning - 17 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 to the terminal in an effort to prevent garbage from being displayed. 3.10 Gadget types JR-Comm uses several types of gadgets. Their functions are described as follows. 3.10.1 String gadgets These gadgets use the familiar Amiga rectangle with a label to the immediate left. JR-Comm enhances the string gadgets by range checking integer input for validity and by looking for appropriate filename postfixes when required, if the requisite postfix is absent, JR-Comm will append it. The list of possible postfixes are: .def defaults file. .phones phonebook file. .macros macros file. .cap capture file. .log log file. .font font file. 3.10.2 Option select gadgets These gadgets are likened to a button switch. If the gadget is selected, the inside dot will be present. Otherwise, it shows only the outer circle. Some groups of option select gadgets are mutually exclusive, for instance, only one protocol can be active at a time (excluding ZMODEM auto- download, which can be active in addition to another protocol being selected). 3.10.3 Control gadgets These gadgets select functions within the requester and are filled rectangles with rounded corners, the gadget label is centered inside the gadget in capital letters. 3.10.4 Intuition gadgets The default Intuition close window, depth and drag gadgets work as expected. JR-Comm retains the position of a requester for future use if it is dragged to a new location from the default centered position. - 18 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 3.11 Keyboard attention sequences There are two special keyboard sequences that JR-Comm will recognize. They are: <CTRL><HELP> - XON/XOFF handshake release. Use this when the program seems to freeze up. JR-Comm will also release itself automatically after 10 seconds has elapsed without receiving an XOFF character from the remote system. <SHIFT><RETURN> - Will toggle between the filename and pathname string gadgets of the file requester, ignored otherwise. - 19 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 4 SPECIAL REQUESTERS 4.1 YAFR...? Yes, Another File Requester... Why? Well simply put, it was needed for one reason, selecting multiple files for batch transfers. But, the big difference here is that this requester gives you the ability to select files from multiple directories and/or volumes. 4.1.1 Functional description The file requester opens up in one of two modes as indicated in the title. One mode is a "SINGLE FILE REQUEST", which will allow you to select only one file at a time. The other mode is "BATCH FILE REQUEST", which allows you to select any number of files. In either mode the file requester is dynamic. Which means that it can process gadget selections while building the current directory files list. The large rectangle is the familiar file selection array, which displays up to 15 files and/or directories at a time. Directories are prefixed with a "(dir)" string to indicate that it is not a file. The righthand side of the list shows the size in bytes of each file. Below the selection rectangle there are two size indicators. The one on the left, labeled "Free:", shows the amount of free space left on the current device for the current directory. The right side shows the total number of bytes of files selected. To the left of the selection rectangle is the proportional scroll gadget which enables the user to scroll through a list of filenames. The knob, or smaller rectangle inside the scroll gadget indicates what percentage of the list is displayed at any one time. The special keyboard sequence <SHIFT><RETURN> will toggle between the filename and pathname string gadgets. 4.1.2 File lists The file requester creates five separate lists that you can browse through for selecting files or for changing directories. The lower middle control gadget enables you to toggle through each list. The currently displayed list is indicated by the label of the gadget itself. These labels are: - 20 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 FILES The files and directories of the current directory, selected files are displayed in inverse video. DEVICES The list of devices known to AmigaDOS. DIRECTORIES Assigned directories. VOLUMES Floppy and/or hard disk volume names. SELECTED The current list of user selected files. Files selected from this list will be removed from the selection list. 4.1.3 SELECT gadget This gadget is functional only while the current directory list is being displayed and the requester was opened in batch file mode. It will select every file in the current directory. 4.1.4 PARENT gadget This gadget will change the current directory to the parent of the current directory. 4.1.5 UNSELECT gadget This gadget is functional while the current directory or the selected files list is displayed. Any matching files from the selected files list will be removed. In the case of the selected files list, all files will be deselected. 4.1.6 Filename string gadget The requester will open with this string gadget set to a suggested filename for phonebook, macro, defaults, capture and log files. It also displays the last filename selected. You may enter a filename of your choosing instead if you so desire. Pressing a <SHIFT><RETURN> sequence will toggle the activation between this string gadget and the pathname string gadget. 4.1.7 Pathname string gadget This string gadget contains the pathname of the current directory. - 21 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 4.1.8 OK gadget This gadget instructs JR-Comm to accept your file selection(s). 4.1.9 CANCEL gadget This gadget will clear the selected files list and abort the function that opened the file requester. 4.1.10 Close window gadget Operates in the same manner as the CANCEL gadget described above. 4.2 Query requester This requester is used along the same lines as the AmigaDOS system requester. The basic difference being that the first character of each possible response, such as 'Y' and 'N' for YES and NO, indicate which key you can press on your keyboard to respond to the requester. Depending on the type of question being asked, your response will either be YES/NO or OK/CANCEL. - 22 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 5 MENUS The character in square brackets to the right of each menu item name listed below will select that item when used in conjunction with the right Amiga key. Any item with a numeric key assignment will open a requester. See the respective chapter for a more detailed description of each one. The Modes menu contains items that are checkmarked when active to indicate that the respective mode for each item is or is not active. 5.1 Project menu [?] About Displays information about JR-Comm. [L] Load defaults Load a default parameters file. [W] Write defaults Write a default parameters file. [G] Send User ID Sends users firstname, lastname and id as one string with a space between each and a carriage return at the end. [Q] Quit JR-Comm Exits program. 5.2 Phonebook menu [1] Directory Phonebook requester. [R] Re-dial Restarts the intelligent dialer. [Z] Send password Sends the password for the active phonebook entry. 5.3 Buffer menu [K] Kill buffer Clears the entire review buffer. [V] View buffer Activates review mode. [O] Open capture Open a new capture file (clears an already existing file). [F] Open w/save Opens a new capture buffer and saves the contents of the review buffer. [A] Append capture Append capture to an existing file. [I] Append w/save Appends to an existing file and also saves the contents of the review buffer. [C] Close capture Close the capture file. - 23 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 5.4 Transfers menu [2] Parameters Parameters requester. [U] Upload Initiate a file upload (from your system). [D] Download Initiate a file download (to your system). [S] ASCII send Send a text file. 5.5 Options menu [3] Serial Serial requester. [4] Modem Modem requester. [5] Terminal Terminal requester. [6] Macros Macros requester. [7] Palette Palette requester (not active in Workbench screen). [8] General General requester. 5.6 Misc menu [T] Timer reset Reset connect timer. [B] Send break Send a break signal to the modem. [H] Hangup modem Hangup modem (via command or DTR). [X] Clear screen Clear the screen. [E] Print screen Prints text of current screen. [0] Print registration Print user registration form (not present in a registered copy of JR- Comm). 5.7 Modes menu [P] Printer Toggles the printer on or off. [Y] Chat line Toggles chat mode on or off. [J] HEX output Incoming data displayed as hexadecimal data in columns of 16 with ASCII along the right-hand side when this mode is active. [M] IBM Doorway Toggles IBM Doorway keyboard mode. [N] Screen title Toggles screen title on/off (not available in Workbench screen). - 24 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 6 PHONEBOOK 6.1 Directory requester The phonebook directory requester is sort of a control panel for adding, editing and deleting phonebook entries. It also allows you to select one or more entries for use by the intelligent dialer. The string gadget labeled "Master password:" contains the character string that is used by JR-Comm to automatically generate passwords for each directory entry. 6.1.1 DELETE gadget Selecting this gadget will place the phonebook into delete mode, which is signified by this gadget being highlighted and all the other control gadgets are ghosted. You must double-click an entry in order to delete it from the phonebook. Entries that are selected for dialing may be deleted too. In order to save your deletions, you must save the phonebook again. 6.1.2 EDIT gadget This gadget functions like the DELETE gadget above, with the only difference being that a single click on an entry is all that is needed to edit it. See the discussion on the entry requester below. 6.1.3 DIAL gadget JR-Comm is capable of multi-dialing any number of directory entries, just select the entries you want dialed first. You then start the dialer by either double-clicking the last selection or by selecting this gadget. You can also dial one entry alone by double-clicking it. See the discussion about the intelligent dialer below. 6.1.4 UNSELECT gadget This gadget will unselect all entries in the phonebook. 6.1.5 ADD gadget Add a new phonebook entry by selecting this gadget. See the discussion about the entry requester below. - 25 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 6.1.6 SORT gadget Opens a small requester for the type of sort you want done to the directory. The options available are: NAME Alpha sort of entry names. NUMBER Alpha sort of entry phone numbers. SELECT Sorted in order of selection. 6.1.7 LOAD gadget Load a phonebook. 6.1.8 SAVE gadget Save the current phonebook. 6.1.9 Master password string gadget This feature gives you a very easy way to maintain unique passwords for each system you call. The master password is combined with the name in a phonebook entry to form a unique string of non-sense characters when the entry is first created or again whenever you select a password type option in the entry requester. See the discussion on the master password below. 6.2 Entry editor requester 6.2.1 Name string gadget The phonebook entry name is entered here. If this is left blank the entry will be discarded. 6.2.2 Phone string gadget Enter the phone number here. Up to 36 digits are allowed. 6.2.3 Macros string gadget The macros filename is optional, if one is entered it enables the MACROS control gadget for creating/editing the macros file for this entry. - 26 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 6.2.4 Capture string gadget Another optional entry. If you enter a filename here it will be opened in append mode once the dialer establishes a connection. The review buffer will be cleared prior to opening the capture file when a connection is established. 6.2.5 Password string gadget The password for the current entry can be manually entered, or you can have JR-Comm create one for you instead, see the section on password types for more information on this feature. 6.2.6 Length string gadget Used in conjunction with the password type gadgets described below. Only a decimal number from 1 through 20 will be accepted. 8 is used as a default. 6.2.7 Dial prefix option gadgets Selects the desired alternate dialing prefix which are used during the dialing of an entry. The default is "None" which indicates the default prefix in the modem requester. 6.2.8 Cents/min string gadget Optional. Enter the decimal number of cents per minute (100 = a dollar) which will be displayed in the status line while connected. The carrier detect signal must function properly on your modem for this feature to work correctly. 6.2.9 Password type option gadgets Selecting any gadget other than the one labeled "Fixed" results in a generated password of that type once the entry requester is closed. The password length is determined by the value in the length string gadget described above. The "Fixed" gadget will be set when the requester is first opened. This prevents JR-Comm from changing the password until you wish to do so. 6.2.10 Reset timer gadget This option causes JR-Comm to reset the connection timer when a connection is first established by the dialer. It is on by default. - 27 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 6.2.11 Parameter requester gadgets The five gadgets along the bottom of the entry requester will open the associated parameters requester for this entry. All parameters are set to the ones in effect when the phonebook was first opened. See the discussions on each of these requesters for more details on their contents. 6.2.12 CANCEL gadget This gadget will abort the current edit and return to the phonebook. If the entry requester was opened via the ADD gadget the entry will be discarded. 6.3 Dialer operation The dialer is controlled by three parameters in the modem requester, number of retries, dial timeout and redial delay. The number of retries defaults to 15 and applies to each entry that is selected when the dialer is started. The dial timeout refers to how many seconds the dialer will wait for a connection after dialing, it defaults to 30 seconds. The redial delay is also in seconds, defaults to 60 and is the amount of wait time at the end of the list before re-starting again. When the dialer establishes a connection it will re- configure JR-Comm and load a macros file if one exists for that entry. It may also open a capture file too. A menu item is also provided to re-start the dialer from where it left off after making the last connection. 6.3.1 Response codes The dialer has a degree of intelligence by responding to the different codes that the modem is capable of returning. The codes and their effect on dialer operation is as follows: - 28 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 BUSY Dialer skips to next entry. ERROR Causes dialer to exit immediately. *VOICE Entry is de-selected. CONNECT Entry is de-selected and dialer exits after re-configuring all JR-Comm parameters to the settings in the phonebook entry. *NO CARRIER Entry is de-selected after receiving this response 3 times for the same entry. *NO DIALTONE Three of these responses will cause the dialer to exit. Features with an asterisk can be disabled by clearing the respective string gadget in the modem requester. 6.3.2 Dialer window The dialer will open its status window while it is dialing. There are three keys that are assigned functions to control the operation of the dialer. They are: <ESC> Exits the dialer immediately. <DEL> Removes entry from the selected list. <SPACE> Skips to next entry or re-dial delay, as necessary. 6.4 Master password The idea behind this feature is to make it simple to create and maintain unique passwords for each system you have an account on. Common sense tells you that having a unique password for each system is safer than using the same password on many of them. Changing them every so often is also another good habit to get into in order to help prevent unauthorized access of your accounts. The problem, up until now, was the easy maintenance and orderly changing of a list of passwords without losing them. By having the password placed in the phonebook entry itself eliminates the possibility of losing it, other than having the phonebook file destroyed. So, backup your phonebook often if you plan to use this feature. The criteria for a unique password is satisfied by combining the master password with the name of the phonebook entry. The length and password type generated is dependent on the options in the entry requester. By changing the master password, you then have the option to create a new password for an entry whenever you need to by simply selecting a password type in the entry requester. The sequence of steps required to accomplish this should go something like this: - 29 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 1. Change the master password. 2. Do not change any entry passwords yet, you must call the system with the old password still intact. 3. After you've logged in you can now open the phonebook and select the EDIT gadget to edit the entry of the system you're connected with. Select one of the password type options and close the entry requester. 4. The new password can now be used to update the password on the system. 5. After insuring that the system has accepted the password change you should save the phonebook to update the password in the file. - 30 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 7 TRANSFER PARAMETERS REQUESTER This requester contains all the options for the file transfer protocols available in JR-Comm. 7.1 Protocol gadgets All the file transfer protocols in use by JR-Comm strictly adhere to the specifications outlined in the various documents that are available for each protocol. The following is a short description of the protocols available. CIS B+ CompuServe's B+ file transfer protocol. XMODEM The original XMODEM checksum protocol was created by Ward Christensen back in 1977. Since then it has been modified for better error correction by using an optional 16 bit CRC polynomial. JR-Comm will automatically attempt the CRC type transfer first and step down to the original checksum version if it's not recognized. XMODEM-1k Another variation of XMODEM, this one uses 1,024 byte packets which gives higher throughput than the original XMODEM protocol. Some systems incorrectly call this YMODEM. WXMODEM A variant of the XMODEM protocol which give better throughput performance over packet switched networks. This protocol is quite popular on the PeopleLink information service. YMODEM This is TRUE YMODEM, which is a batch transfer protocol. The filename, date and file size are transferred in a separate header block at the beginning of each file that is transferred. This protocol also preserves the correct file size, the XMODEM and derivative protocols above pad characters at the end of the file. YMODEM-g This variation of YMODEM is intended for error correcting modems, like those that use MNP error correction. Because this protocol does no error correcting, the file is transferred with little delay and can achieve some of the highest throughput of any of the protocols listed here. If an error is detected, the transfer will be aborted, hence the need for an error-free connection in order to use this protocol with confidence. - 31 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 ZMODEM This is one of the newest and most powerful protocols available. It is capable of batch transfers, automatically initiated downloads, 32 bit CRC error checking, and a unique ability to resume a transfer that had been partially completed. JR-Comm supports one of the most complete implementations of the ZMODEM protocol as defined by the specification document written by ZMODEM's author, Chuck Forsberg. 7.1.1 Some notes on flow control ZMODEM and YMODEM-g are known as full-flow protocols due to their ability to send data without interruption. Unfortunately, if the target of the incoming data is that blazingly fast Amiga floppy disk, there is going to be trouble. For ZMODEM transfers, all that is necessary is to activate the XON/XOFF handshake in the serial parameters requester. Not to worry though, unlike most Amiga comm programs, JR-Comm will not lock itself up permanently when you use this feature. YMODEM-g is a different problem though. If you're downloading to a floppy disk and are using the internal serial port you cannot use this protocol, period, or you WILL lose data and therefore, abort the transfer since this protocol only does error checking and not error correction. It also requires full 256 byte transparency so XON/XOFF handshaking is always disabled when using it. If you're using a multi-port add-on board that supports the dropping of the RTS signal when the internal serial buffer is almost full (you must have CTS/RTS handshake enabled for this to work) then you will be able to use YMODEM-g to floppy disk. It goes without saying that if you have ample memory to spare, you would do much better by transferring files to and from ram disk. 7.2 ASCII send parameters 7.2.1 Expand blanks gadget When this feature is selected, JR-Comm will send one space character for lines which contain only an end-of-line character. Use this option when the on-line text editors you're using exits input mode when a blank line is received. - 32 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 7.2.2 Prompt char string gadget Instructs JR-Comm to wait for a specific character after transmitting a line of text. If blank then the text will be sent without breaks. 7.2.3 Char delay string gadget A numeric value describing hundredths of seconds to wait between sending characters. 7.2.4 Line delay string gadget Like char delay above, tenths of seconds to wait between sending lines of text. 7.3 Miscellaneous parameters 7.3.1 Binary mode gadget Binary mode sends the file as a binary image. Text mode is implied if this gadget is not selected and will send a file with end-of-line conversion according to the settings in the terminal requester. 7.3.2 Save aborted gadget Determines if a partially received file is saved or deleted whenever a download is aborted. 7.3.3 Relaxed timing gadget Set this gadget if a file transfer fails or gets an excessive number of timeouts. Useful for packet switched networks. 7.3.4 Auto chop gadget File transfers using the XMODEM, XMODEM-1k & WXMODEM protocols pad data to the end of the file if it is not an even multiple of 128. The Amiga operating system will not run a program that has been modified in this way. This feature will attempt to remove this data from a binary file transfer to enable it to be used by your Amiga. - 33 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 7.3.5 Overdrive gadget This gadget enables overdrive mode for ZMODEM and YMODEM-g uploads. Double-buffered transfers are used which greatly increases transfer throughput. At baud rates below 9600bps you may experience increased error recovery times. It is recommended that you not use this mode for slow baud rates or over phone lines that have a high probability of noise occurring. 7.4 ZMODEM options 7.4.1 Resume transfer gadget If the requested file already exists, JR-Comm will make an attempt to resume the file transfer. A check is made between JR-Comm and the remote system that the receiver has a file that is shorter than the one the sender has. If the file is not shorter, the transfer will be aborted. 7.4.2 Auto download gadget When this gadget is active it allows JR-Comm to start a ZMODEM download automatically when a ZMODEM auto-d/l header is received. 7.4.3 Auto d/l challenge gadget This feature, when selected, instructs JR-Comm to perform a challenge to the remote system so that it can determine if the remote really intended to initiate an automatic download. This gadget is activated when the auto-download gadget is selected, but may be independently de-selected in case a certain remote system does not support the challenge option. 7.4.4 Escape ctrl chars gadget Instructs JR-Comm to do an escape of all control characters to prevent interference with the operation of packet- switched networks. 7.4.5 32 bit CRC gadget Instructs JR-Comm to use the newer 32 bit CRC mode of error detection if possible. A 16 bit CRC will be used if the remote system does not support 32 bit CRC. - 34 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 7.5 ZMODEM send modes The following modes are applicable to a ZMODEM upload from JR- Comm only. They have no effect on a download, regardless of protocol used. All comparisons reference the file on the remote system with the file on your system. 7.5.1 Skip if absent gadget Instructs the remote system to skip any files that are not present. 7.5.2 Newer gadget Transfer if file date is newer or not present. 7.5.3 Newer/longer gadget Transfer if the file is newer, longer or not present. 7.5.4 CRC different gadget Transfer if the file has a different CRC or is not present. 7.5.5 Append files gadget Append data only if remote file is shorter than the file locally. If the file is not present, create it. 7.5.6 Overwrite files gadget Overwrite any files that are present. Also known as clobber mode. 7.5.7 Protect all files gadget Protect all files unconditionally. Will not receive files of the same name as a file already on your system. 7.5.8 Don't care gadget Disables send checking for use with problematic ZMODEM implementations. If a file that already exists on your system is sent, JR-Comm will query you on if you want to overwrite it or not. It will create a unique file otherwise. - 35 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 8 SERIAL PARAMETERS REQUESTER The serial port parameters are located in this requester. Options available are listed below. Baud rates from 300 to 57,600bps are supported. Data lengths of 7 and 8 bits. Stop bits of 1 or 2. Parity types available are: NONE, EVEN, ODD, MARK and SPACE. Duplex modes of FULL, HALF and ECHO. Enable and disable XON/XOFF flow control. Remember that the <CTRL><HELP> keyboard sequence will release XOFF freeze-ups. Break length in microseconds. Hardware or CTS/RTS flow control and alternate serial device parameters are located in the general requester. - 36 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 9 MODEM PARAMETERS REQUESTER This requester contains all the necessary items needed to enable JR- Comm's intelligent dialer to interact with your modem properly. All strings default to standard Hayes compatible modem commands and responses. 9.1 Modem commands Modem commands are sent to the modem for initialization, hanging up and dial prefixes/postfixes. Control codes are inserted in the command by proceeding the desired control character with a '^'. A "^M" sequence would send the equivalent of a carriage return. The '~' character will insert a one-half second delay before sending the rest of the string. 9.1.1 Init command string gadget Sent to the modem when JR-Comm is first started, but only if a carrier signal is not present. Defaults to "ATZ^M~~~ATE1 Q0 V1 X4^M" (excluding quotes). 9.1.2 Hangup command string gadget Used to hangup the modem if the DTR gadget is not active. Defaults to the string "~~~+++~~~ATH^M". 9.1.3 Dial prefix string gadget This is the default dialing prefix that is sent to the modem before the phone number is sent. It defaults to "ATDT". 9.1.4 Dial postfix string gadget This prefix is sent after the phone number has been sent. Defaults to a carriage return, "^M". 9.2 Alternate dial prefixes JR-Comm provides you with three alternate dialing prefixes that can be used instead of the default dialing prefix described above. This is useful for enabling/disabling MNP modes and for alternate phone services. - 37 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 9.3 Response code string gadgets The eight response codes and their Hayes defaults are: OK The usual modem response to a command. BUSY Sent when a busy signal is detected. RING Sent when the modem detects a ring signal. ERROR Sent when the modem detects an error. VOICE Not all modems are capable of sending this. CONNECT The modem has connected to another modem. NO CARRIER The remote system did not respond. NO DIALTONE Sent if no dialtone signal was present. 9.4 Dialer parameters 9.4.1 Redial delay string gadget Indicates how many seconds JR-Comm will wait before re- starting after it has dialed the last selected entry. 9.4.2 # of retries string gadget How many times JR-Comm will loop through the list of selected entries before exiting the dialer. 9.4.3 Dial timeout string gadget How many seconds JR-Comm will wait for a carrier after dialing the phone number for the current entry. 9.5 Miscellaneous options 9.5.1 Ignore Carrier Detect gadget Set this gadget if your modem does not have a functional carrier detect signal. The connect timer will be turned off since it is no longer functional. 9.5.2 Hang up on dialer exit gadget Set this if you wish to have JR-Comm hang-up the modem when you exit the dialer via the <ESC> key or close-window gadget. - 38 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 9.5.3 Dialer auto-baud gadget If your modem is capable of indicating connected baud rate by sending a numeric string after the CONNECT message and you wish to have JR-Comm adjust itself automatically, set this gadget. 9.5.4 Drop DTR to hangup gadget Select this option if your modem is capable of disconnecting when the DTR signal is dropped. 9.5.5 Flush with a BREAK gadget Some MNP modems, the HST is one, are able to clear its internal data buffer when a BREAK signal is sent to the modem. This shortens the time needed to recover from an error during a file transfer. 9.6 Screen type options Select the type of screen you wish to use. Defaults vary depending on the type of terminal emulation selected. Interlace is not available when using the Workbench screen, JR-Comm will inherit the current Workbench screen parameters when it opens its terminal window. 9.7 Font size When using interlace you can select normal or small font sizes. Non-interlace displays can only use the normal font size. 9.8 Terminal type Select one of TTY, Amiga ANSI, IBM color, IBM mono, VT100 or SkyPix terminal emulations. 9.9 EOL out option gadgets Select either a carriage return, linefeed or CR/LF pair to be output when you press the return key. - 39 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 9.10 Capture filters 9.10.1 ANSI codes gadget Turn this filter on if you do not want ANSI control code sequences captured. The codes will still affect the screen though. No sequences will be in the review buffer either. 9.10.2 CTRL chars gadget Removes all control characters except for carriage returns, line feeds, form feeds, tabs and backspaces. 9.10.3 Backspaces gadget If this filter is active then any backspace received will remove the previous character received from the capture file too. This results in the capture function operating in the same manner as the display. 9.11 Miscellaneous options 9.11.1 Strip high bit gadget Use this option if you want the high bit of each character reset that is received when using 8N1. 9.11.2 Custom palette gadget Use the custom palette instead of the default palette for the selected terminal emulation. See the discussion about the palette requester for more information about the palettes used in JR-Comm. 9.11.3 Destructive BS gadget Causes JR-Comm to delete any text that is backspaced over when set. Leaves text on screen otherwise. 9.11.4 Swap DEL & BS gadget When this gadget is selected JR-Comm will reverse the action of the <DEL> and <BACKSPACE> keys. - 40 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 9.11.5 Smooth scroll gadget This option will scroll the screen smoothly, rather than in one line chunks. 9.11.6 Chat line on gadget The chat line is a 256 character line displayed along the left side of the status line. The line will automatically scroll left as data is entered into the line. See the discussion on the display above for details on the chat mode. 9.11.7 Wrap lines gadget Set this gadget and JR-Comm will force a carriage return/linefeed whenever text reaches the right most column. 9.11.8 IBM Doorway mode gadget JR-Comm will mimic an IBM keyboard when this gadget is selected. 9.11.9 Cursor blink gadget Enable and disable the blinking characteristic via this gadget. 9.11.10 Optimized scroll gadget When this mode is active JR-Comm will try to reduce all display scrolls to a minimum screen width and number of bit- planes in order to accomplish the scroll in less time then brute force scrolling. Quite helpful for VT100 with smooth scroll in effect or when using the IBM 16 color emulation. 9.11.11 Add linefeeds Select this gadget when linefeeds are not sent by the remote system. 9.12 Answerback message string gadget This is used with the VT100 emulation. The string contained within this gadget will be sent whenever a <CTRL><E> (decimal 5) is received. - 41 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 9.13 Color string gadgets 9.13.1 Text color string gadget Set this to the color you wish to use for the display. The number will correspond to those displayed in the palette requester. 9.13.2 Background string gadget Sets the background color of the display. 9.13.3 Cursor string gadget Sets the color of the underline cursor. - 42 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 10 MACROS REQUESTER Up to 40 macros of 160 characters can be defined for each macros file. Select the appropriate modifier gadget in order to edit a desired macro. 10.1 Macro escape codes A simple set of escape codes are included. They are listed as follows. ~ Pause one half second. ^^ The '^' character itself. ^~ The '~' character itself. ^! The '!' character itself. ^char (A-Z) Send char as a control character. !%decimal Character pacing, in decimal tenths of seconds. !@filename Load a new macros file from the default directory. !*filename Load a new phonebook file from the default directory. !$hex Send a hex character. !#decimal Chain to macro where decimal equals: 0-9 Function keys 1-10 alone. 10-19 " " " w/CTRL 20-29 " " " w/SHIFT 30-39 " " " w/ALT For example, a macro such as "~~^mHello !%2There!$d!#4" would wait one second then send a carriage return. The string "Hello There" is then sent with the characters in "There" each paced by two tenths of a second. Another carriage return is sent and it will finally chain to the macro defined for <F5>. - 43 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 11 PALETTE REQUESTER Works like most any color palette requester found in other Amiga applications. 11.1 Red Green and Blue proportional gadgets These sliders adjust the associated color component of the selected color. 11.2 Color select gadgets Depending on the screen type, there can be from 2 to 16 color selection gadgets available on the right hand side of the requester. Select the color you wish to adjust. 11.3 RESET gadget This gadget will reset the palette to the default for the active terminal emulation. If you are familiar with the IBM color palette you will notice that the colors do not follow normal IBM ordering. A color index is used by JR-Comm so that the terminal emulation displays the correct color while still presenting a consistent color scheme for all requesters in any type screen. 11.4 UNDO gadget Restores palette to initial setting when the requester was first opened. 11.5 Palette usage 11.5.1 Default palettes JR-Comm has four default color palettes built-in for use with the various terminal emulations. Three of them are hard-coded. One for the TTY, Amiga ANSI and IBM color emulations, one for the IBM mono and VT100 emulations and one for SkyPix. When the IBM mono or VT100 emulation is selected, the palette will behave somewhat differently. This was done so that the hi/lo intensity and blink attributes are properly maintained. In this palette colors 0, 2, 4, & 6 are tied together, as are colors 1 & 5 and 3 & 7. So, just concern yourself with colors 0 (background), 1 (lo intensity) and 3 (hi intensity). - 44 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 The last palette is the custom default palette. The very first time you run JR-Comm, or when it is started without a defaults file present, this palette is set to the same values as the IBM color palette. It is then saved in your defaults file from then on. 11.5.2 Phonebook entry palettes Each phonebook entry contains its own palette. When the entry is created, or whenever its terminal emulation type is changed thereafter, this palette gets set to the appropriate palette as described above. Set the custom palette gadget in the terminal requester if you modify this palette, this prevents JR-Comm from over-writing it. In order to set the palette in a phonebook entry to the custom default palette you must have the custom palette gadget set before adding the entry to the phonebook. - 45 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 12 GENERAL PARAMETERS REQUESTER 12.1 Status line options 12.1.1 Status line active gadget Toggles the status line on and off. 12.1.2 Time of day clock gadget Turn on or off the time-of-day clock. 12.1.3 Connect timer gadget The connect timer is displayed when this gadget is selected. 12.1.4 24 hour mode gadget Enables 24 hour mode for the time-of-day clock when selected. 12.2 Miscellaneous options 12.2.1 CTS/RTS handshake gadget Activates hardware handshaking when selected. Your modem must have DSR active, or JR-Comm will disable this mode automatically. 12.2.2 Immediate exit gadget If selected, this option will disable the query requester when exiting JR-Comm, allowing you to quit immediately. No check to see if you're still online is made, so be careful with this one. 12.2.3 Logfile active gadget This option allows JR-Comm to log transfer and session activity, the following actions are presently recorded. - JR-Comm session start and end. - Connection to a system via the dialer. - Modem hangup command. - Carrier drop if the ignore carrier detect button in the modem requester is not active. - Successful downloads with file size, total error count and cps rate. - 46 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 12.2.4 Split review gadget Activates split review buffer mode when selected. This mode allows you to review the contents of the buffer while still being able to converse with the system you're connected to. 12.2.5 File saver gadget When it is enabled, this feature closes and then re-opens a file being downloaded each time the transfer buffer is written to disk. This prevents the total loss of a file if a system crash occurs during the transfer. This option is not recommended for use with floppy disks due to the time required to seek to the end of the file every time it is re-opened. 12.2.6 Sound beep gadget This gadget, when selected, will cause JR-Comm to sound a beep whenever an action occurs that the user should be informed about. If this gadget is not selected, the default, JR-Comm will use the Amiga Intuition system function of DisplayBeep(). This allows JR-Comm to either flash the display or to use the beep defined by one of many available install beep programs. 12.3 String gadgets 12.3.1 GMT offset string gadget This value is used for YMODEM and ZMODEM file protocols so that the true file date can be preserved. To do this requires that the filedate be converted to Greenwich Mean Time by the sender and then modified again for the timezone the receiver is located in. Offset values of -5 for North American Eastern Standard Time (EST) and -8 for Pacific Standard Time (PST) are typical. 12.3.2 Task priority string gadget JR-Comm will adjust its task priority to this value when non-zero. Valid priorities range from -5 through 15. - 47 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 12.3.3 Chat history size string gadget This value determines how many lines of chat history are available. It defaults to 50 and permissible values are from 10 to 100. 12.3.4 Review buffer size string gadget Size of the review buffer in blocks of 2,048 bytes. Defaults to 8 with valid values are from 2 to 250. 12.3.5 Transfer buffer size string gadget Size of the transfer buffer in blocks of 2,048 bytes. Used for file transfers and for ASCII sends. Defaults to 8 with valid values of 4 to 16. 12.4 Default filename string gadgets There are four default filenames used by JR-Comm to load a phonebook and macros file when first started and for the capture and log files. All four default to the string "jrcomm" with appropriate postfixes. 12.5 Paths string gadgets JR-Comm uses these three pathnames to locate and place files as necessary. The pathname defined in the JR-Comm files string gadget is initially set to S: or JRCOMM: when the program is run for the first time, but it can be set to a different path to give you re-direction capabilities. See the discussion on the paths in the installation section. 12.6 Font string gadgets This pair of string gadgets enables you to set JR-Comm to a font of your choosing. JR-Comm will only look in the FONTS: directory for this font. 12.7 Serial device string gadgets These string gadgets allow you to use a custom serial device. Set the strings to their appropriate values, when the requester is closed JR-Comm will attempt to open the new serial device you have entered. - 48 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 13 MISC MENU ITEMS 13.1 Timer reset This item will reset the online timer. 13.2 Send break Causes the serial.device to send a break signal of the length specified in the serial parameters requester. 13.3 Hangup modem JR-Comm will hangup the modem, either by dropping DTR or by sending the hangup command string as defined in the modem parameters requester. 13.4 Clear screen JR-Comm will clear the screen and home the cursor. In Amiga ANSI emulation mode it will also reset the alternate character set. In VT100 emulation it will reset both character sets. 13.5 Print screen This item will send each line of text on the screen to the printer, this is not a graphics type of print, so it is disabled in SkyPix emulation mode due to the ability of this emulation to change fonts on the fly. 13.6 Registration Opens the registration ID requester first, if no ID is entered it then opens the registration information requester. All information must be entered in order to proceed to the print registration query requester. - 49 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 14 MODES MENU ITEMS 14.1 Printer Turns printer output on or off, this is a checkmarked item when active. An asterisk will be placed to the left of the protocol indicator if the status line is on too. 14.2 Chat line Enables and disables the chat line, checkmarked when active. 14.3 HEX output Displays input from the modem as lines of hexadecimal bytes with text to the right. Checkmarked when active. 14.4 IBM Doorway Enables IBM Doorway mode. Keys will be sent as IBM scan codes instead of ASCII. Checkmarked when active. 14.5 Screen title Turns on the screen title, checkmarked when active. - 50 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 15 INFORMATIONAL MESSAGES 15.1 Directory not found The file requester couldn't find the requested directory. 15.2 User font not found The font requested by the user was not located, check fontname and font height. 15.3 Can't load file, wrong version JR-Comm located a file, but it was created by a different version of JR-Comm, so it refused to load it. Valid for jrcomm.def and jrcomm.phones files only. 15.4 Can't open log file JR-Comm couldn't open the log file, check for disk full condition. 15.5 File already exists, resume d/l? Posted during the start of a ZMODEM or CIS B+ download due to finding a file of the same name as the one the sender is attempting to download to you. A no response will cause JR-Comm to start the transfer from the beginning of the file. 15.6 File already exists, overwrite? Also posted during a download where a file already exists, a no resonse will cause JR-Comm to create a filename of the same name, but will also postfix a numeric to it. 15.7 Really quit JR-Comm? If the immediate exit option is not set, JR-Comm will post this query to ensure that you really wanted to exit JR-Comm. 15.8 Unable to open printer JR-Comm could not open the printer device. - 51 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 15.9 Review buffer is empty Review mode cannot be entered if there is nothing in the review buffer. 15.10 Print registration form? Self explanatory. 15.11 File jrcomm is missing In order to insert a registration ID number, the jrcomm file must be in the current directory when JR-Comm is started. - 52 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 16 WARNING MESSAGES 16.1 Directory read error An AmigaDOS read error has occured while attempting to read the directory list into the file requester. 16.2 Could not open screen JR-Comm could not open the requested screen, check free memory. 16.3 Could not open window Same as for screen above. 16.4 Capture file currently open! Two capture files cannot be open simultaneously, close the current one in order to open a new one. 16.5 Protocol requires handshaking File transfer protocol requires hardware handshaking in order to prevent unrecoverable errors from occuring. YMODEM-g. 16.6 Couldn't open capture file Self explantory. 16.7 CTS disabled, no CTS present CTS handshaking is disabled. A CTS signal from the modem is required in order to activate this handshaking mode. 16.8 CTS disabled, no DSR present CTS handshaking disabled due to a lack of a DSR signal being active from the modem. 16.9 CTS disabled, shared mode CTS handshaking can only be active if JR-Comm is able to open the device in exclusive access mode, do not have anything else running that is using the serial.device. - 53 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 16.10 Session will expire in 5 mins Posted at the end of the 3 hour session limit. - 54 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 17 FATAL ABORT MESSAGES The following messages are posted prior to JR-Comm terminating, these are all fatal aborts. - Out of memory. - Serial device error. - Need newer OS. - Timer device error. - Couldn't start child task. - Console device error. - 55 - JR-Comm Users Manual (preliminary) Electronic Edition Version 0.99n (non-public gamma) Printed 04/04/90 18 SUPPORT INFORMATION Support for JR-Comm is available through: Atlantic County Amiga BBS Fidonet address 1:266/61 (24hr mailer) (609)625-2453 - 3/12/24/96/14400 HST 24 hrs/day - 7 days/wk It is an open system available to anyone. If you are calling with a problem about JR-Comm please be specific and post your request in a public message. This will help future callers who may find the information they're searching for by reading previously posted messages. The most current release of JR-Comm will always be available on the BBS. Likewise, there will be new versions simultaneously posted on CompuServe, People Link and GEnie. - 56 -