home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / comprgs / ncomm20.lzh / NComm / Doc / NComm.doc < prev    next >
Encoding:
Text File  |  1992-03-09  |  101.5 KB  |  2,221 lines
  1.             NComm 2.0 - released the 9th of Mars, 1992
  2.  
  3.                                              //
  4.                 A terminal program for the \X/ AMIGA
  5.  
  6. ======================================================================
  7.  
  8. --- INDEX ---
  9.  
  10. 1.  INTRODUCTION
  11.  
  12.     1.1  ShareWare info        1.7  Manual info
  13.     1.2  Version Number        1.8  How to contact the authors
  14.     1.3  Development info      1.9  Future expansion
  15.     1.4  History               1.10 Disclaimer
  16.     1.5  Credits               1.11 Summary of functions
  17.     1.6  Programming info
  18.  
  19. 2.  SETUP AND FILES USED
  20.  
  21.     2.1  Files included
  22.     2.2  Information about NComm Host Script
  23.     2.3  Change in file formats (upgrade info)
  24.     2.4  How to install new files
  25.     2.5  How to setup NComm: assignment
  26.     2.6  Using your own NewCLI command
  27.     2.7  Sharing the serial port
  28.     2.8  Startup and command line option
  29.     2.9  Single-drive note
  30.     2.10 How to configure NComm for use with MBBS
  31.     2.11 A note about Ymodem-G and high speed modems
  32.     2.12 How to obtain high transfer rates with HST modems
  33.     2.13 Init string for TBK 9600+
  34.     2.14 Icon stack size
  35.  
  36. 3.  COMMANDS IN SYSTEM MENU
  37.  
  38.     3.1   Commands available   3.7.2 Load Macrokeys
  39.     3.2   About NComm          3.7.3 Save Macrokeys
  40.     3.3   Status window        3.7.4 Leaving things unchanged
  41.     3.3.1 Send delay           3.7.5 Installing new macrokeys
  42.     3.3.2 Scrollback buffer    3.8   Output to printer
  43.     3.4   Load configuration   3.9   Starting a new CLI
  44.     3.5   Save configuration   3.10  Logging calls
  45.     3.6   Execute script       3.11  Setting Priority
  46.     3.7   Macrokeys window     3.12  ARexx Script
  47.     3.7.1 Control characters   3.13  Quit NComm
  48.  
  49. 4.  COMMANDS IN FILE MENU
  50.  
  51.     4.1   Commands available   4.8.1 Kermit Finish
  52.     4.2   ASCII capture        4.8.2 Kermit Bye
  53.     4.3   ASCII send           4.8.3 Kermit CD
  54.     4.4   Message upload       4.9   Protocol
  55.     4.5   Download             4.9.1 Xmodem
  56.     4.6   Upload               4.9.2 Ymodem
  57.     4.7   Options              4.9.3 Ymodem-Batch
  58.     4.7.1 CRC                  4.9.4 Ymodem-G
  59.     4.7.2 Chop files           4.9.5 Zmodem
  60.     4.7.3 G&R protocol         4.9.6 Kermit
  61.     4.7.4 G&R host mode        4.9.7 External XPR
  62.     4.7.5 Zmodem resume        4.9.8 Compuserve-B
  63.     4.7.6 Zmodem autodl        4.9.9 Jmodem
  64.     4.7.7 Zmodem autoul        4.10  Default directory
  65.     4.7.8 Zmodem ack           4.11  Load scrollback buffer
  66.     4.7.9 Zmodem bufsize       4.12  Save scrollback buffer
  67.     4.7.10 Kermit host         4.13  View scrollback buffer
  68.     4.7.11 Kermit 1k blocks    4.14  Search in buffer
  69.     4.7.12 External XPR setup  4.15  Save marked block
  70.     4.7.13 Create icons        4.16  Send marked block
  71.     4.7.14 File comments       4.17  Disable adding
  72.     4.7.15 Transfer bar        4.18  Clear scrollback
  73.     4.8   Server Commands
  74.  
  75. 5.  COMMANDS IN SERIAL MENU
  76.  
  77.     5.1   Commands available   5.7.2 Xon / Xoff
  78.     5.2   Baud                 5.7.3 RTS / CTS
  79.     5.3   Data length          5.8   Set Device
  80.     5.4   Parity               5.9   Set Unit
  81.     5.5   Stop bits            5.10  Set Adjust Factor
  82.     5.6   Duplex               5.11  Shared Mode
  83.     5.6.1 Full duplex          5.12  Send Break
  84.     5.6.2 Half duplex          5.13  Lock Serial
  85.     5.7   Handshaking          5.14  Set 75bps Delay
  86.     5.7.1 None
  87.  
  88. 6.  COMMANDS IN TRANSLATE MENU
  89.  
  90.     6.1    Commands available  6.3.9  FR7
  91.     6.2    End of line         6.3.10 SP7
  92.     6.3    Character set       6.3.11 IT7
  93.     6.3.1  ISO                 6.3.12 SF7
  94.     6.3.2  IBM                 6.3.13 DE7
  95.     6.3.3  IBN                 6.4    Del <-> BS
  96.     6.3.4  IBP                 6.5    Show HEX chars
  97.     6.3.5  NO7                 6.6    ANSI mouse
  98.     6.3.6  US7                 6.7    ANSI capture
  99.     6.3.7  UK7                 6.8    Destructive backspace
  100.     6.3.8  GE7                 6.9    Pad out blank lines
  101.  
  102. 7.  COMMANDS IN SCREEN MENU
  103.  
  104.     7.1    Commands available  7.10   Reset
  105.     7.2    Title bar           7.11   Workbench screen
  106.     7.3    Interlace           7.12   Close Workbench screen
  107.     7.4    Colours             7.13   OS 2.0 snapping
  108.     7.5    Palette             7.14   Force 80 x 24
  109.     7.6    Split screen        7.15   Flashing text
  110.     7.7    Style               7.16   Line wrap
  111.     7.8    Bell                7.17   Window Gadgets
  112.     7.9    Cursor blink        7.18   Overscan Support
  113.  
  114. 8.  COMMANDS IN PHONE MENU
  115.  
  116.     8.1    Commands available  8.6.13 No answer string
  117.     8.2    Phonebook           8.6.14 Remote ring string
  118.     8.2.1  Dial                8.6.15 Redial delay
  119.     8.2.2  Edit                8.6.16 Locked rate
  120.     8.2.3  New                 8.6.17 DTR hangup
  121.     8.2.4  Swap                8.6.18 Loop delay
  122.     8.2.5  Load                8.6.19 Hardware CD Checking
  123.     8.2.6  Save                8.6.20 Ignore echo
  124.     8.2.7  Delete              8.6.21 Accepting the edit
  125.     8.2.8  Sort                8.7    Redial at logoff
  126.     8.2.9  Print               8.8    Phonebook edit window
  127.     8.2.10 Clr/Mark            8.8.1  Name
  128.     8.3    Dial #              8.8.2  Phone #
  129.     8.4    Hang up             8.8.3  Comment
  130.     8.5    Redial              8.8.4  Config
  131.     8.6    Modem setup         8.8.5  Macros
  132.     8.6.1  Init string         8.8.6  Script
  133.     8.6.2  Exit string         8.8.7  ARexx
  134.     8.6.3  Dial prefix         8.8.8  Password
  135.     8.6.4  Dial suffix         8.8.9  Baud rate
  136.     8.6.5  Hang-up string      8.8.10 Data length
  137.     8.6.7  Connect string      8.8.11 Parity
  138.     8.6.6  Disconnect string   8.8.12 Stop bits
  139.     8.6.8  Busy string         8.8.13 Duplex mode
  140.     8.6.9  Voice string        8.8.14 Character set
  141.     8.6.10 No dialtone string  8.8.15 Swap Del/Backspace
  142.     8.6.11 Error string        8.8.16 Transfer protocol
  143.     8.6.12 Ringing string      8.8.17 Last dialled info
  144.  
  145. 9. INFORMATION ABOUT DIAL MENU
  146.  
  147. 10. HOT KEYS AVAILABLE
  148.  
  149. ======================================================================
  150.  
  151.  
  152.  
  153. CHAPTER 1: INTRODUCTION
  154.  
  155. 1.1  NComm  V2.0  is  Shareware  -  it isn't free, and all rights
  156.      are reserved.  You are not allowed to sell this program, and
  157.      you  may  only copy it for non-commercial purposes.  You may
  158.      take  a look at the program for free, but if you like it (or
  159.      use it), please send 215 NOK or $35 by cheque or money order
  160.      made  payable  to the address below.  If you live in Europe,
  161.      you may also use my bank or PostGiro account.  You will then
  162.      become  a  registered  user,  and  automatically  receive  a
  163.      registered  version.  The  irritating  requesters  have been
  164.      removed.  Send  35  NOK  or  $6  to  the  same  address  for
  165.      receiving  an update (this will  hopefully  cover  my postal
  166.      expences), or call the NComm Support BBS for a free upgrade.
  167.      Please also include  the name of the person to register this
  168.      copy of NComm on. The name will be installed in the program.
  169.  
  170.      NComm  is  copyrighted,  including  copies  which  have been
  171.      modified.   Any change to the executable or documentation is
  172.      prohibited.   You  may not modify, adapt, translate, reverse
  173.      engineer, disassemble, or decompile this program.  If hacked
  174.      or  registered  versions  of  the NComm executable appear on
  175.      bulletin boards, I won't make any new version of the program
  176.      - it's as simple as that.
  177.  
  178.      If  you want to distribute NComm, the program must be in its
  179.      original archive  format, including all documentation files,
  180.      icons, scriptfiles, fonts, commands and libraries.
  181.  
  182.      The   registered   versions  of  NComm  are  commercial  and
  183.      strictly  personal  to the person who has registered his/her
  184.      copy.   They  are  not  shareware  and must not be spread or
  185.      copied to other persons.  Persons who break these terms will
  186.      be  held responsible for the economical damage they cause by
  187.      spreading  the  registered  versions.   Any contravention of
  188.      this  agreement,  either  by  will  or  by accident, will be
  189.      followed by a prosecution before norwegian court.
  190.  
  191.      Keep  developers  developing - future development depends on
  192.      you...  The NComm development depends on ShareWare royalties
  193.      and stops as soon as we don't get any money for it.
  194.  
  195.                           Torkel Lodberg
  196.                           Pilotveien 10
  197.                           N-0384 OSLO 3
  198.                              NORWAY
  199.  
  200.      Union Bank of Norway (SpB NOR) account number; 1607.26.26595
  201.                   European postgiro account number;  0824 0884667
  202.  
  203.      (PLEASE use my postgiro account if possible. Sparebanken NOR
  204.       charge 40 NOK for transferring the money...)
  205.  
  206.      NOTE:  The  money that I get for NComm  will  off  course be
  207.      shared just between Daniel Bloch, Trym Hansen and myself.
  208.  
  209. 1.2  NComm  version  2.0  was written by Torkel Lodberg.  It was built
  210.      on  NComm  1.9  by  Daniel  Bloch  & co.
  211.  
  212. 1.3  This  program  was  developed  using  Lattice  C 5.x,  and is the
  213.      result  of a project started in Oslo in 1988, using the Rodel°kka
  214.      (M)BBS to coordinate the initial efforts.
  215.  
  216. 1.4  History
  217.      =================================================================
  218.      Many  of  the  communication  programs on the market today *look*
  219.      nice,  but after testing them for a few minutes you find out that
  220.      they  are  so bug-ridden that even the old Basic-program you used
  221.      on the Commodore 64 would be preferable.
  222.  
  223.      We  thought  that  no  Amiga  communication program fulfilled our
  224.      needs,  and  figured  out that the only way to get a program that
  225.      did  everything we wanted, was to make it ourselves!  Luckily the
  226.      source  for  Comm  1.34  was  available.   It  had  all the basic
  227.      functions,  so  we  could  concentrate  on  what  we  thought was
  228.      missing.
  229.  
  230.      Our  goal  wasn't  to  make a program with a lot of functions you
  231.      never  use,  but with the functions that we needed - and they had
  232.      to   work!    Our  national  characters  have  been  ignored  and
  233.      mistreated, but NComm puts an end to that.
  234.  
  235. 1.5  The  project  was  led by Daniel Bloch, and chief contributors to
  236.      the design so far, apart from Daniel, have been:
  237.  
  238.      Trym Hansen         Conrad Helgeland      Torkel Lodberg
  239.      J°rn Lok°y          Per Hansen            Geir Atle Storhaug
  240.      Arvid Johansen      Geir Inge H°steng     Anders Herbj°rnsen
  241.      Bj°rn Melbye        Eric Wheatley         Marek Rzewuski
  242.      Heiko Schlichting   Miguel Casteleiro     ╪yvind Harboe
  243.      Thomas Baetzler     Nils-Arne Dahlberg    Roger Nordin
  244.  
  245.      Thanks   go   to  Mike  Robertson  (who  gave  us  the  necessary
  246.      information  for  the  G&R protocol, and helped us out with a few
  247.      other  things)  and Dj James (for the source to Comm 1.34).  Also
  248.      thanks  to  all the Beta-testers.  Feedback from the users is the
  249.      most important thing when developing a program!
  250.  
  251.      The  XPR spec. was  created  by Willy Langeveld. NComm would have
  252.      been nothing without it...
  253.  
  254.      Phone icon created by Bj°rn Rybakken.  He also made the new NComm
  255.      fonts - thanks!
  256.  
  257. 1.6  All  changes  since  V1.9  were made by Torkel Lodberg, so please
  258.      don't  flame  Daniel  Bloch  if you find any bugs or simply don't
  259.      like the new version :-)
  260.  
  261. 1.7  This  manual  was  written  by  Torkel  Lodberg,  with  help from
  262.      Conrad Helgeland and Eric Wheatley.
  263.  
  264. 1.8  We  welcome  bug  reports  and  comments  about  NComm  and   the
  265.      documentation.  Send your comments to this address:
  266.  
  267.         Torkel Lodberg, Pilotveien 10, N-0384 Oslo 3, Norway.
  268.             Email: torkell@ifi.uio.no     (Internet)
  269.                 Torkel Lodberg @ 2:502/15 (Fidonet)
  270.  
  271.      Or call: The NComm Support BBS, 24 hours.
  272.  
  273.               Phone # +47 2 493210 (international) (V32/MNP5)
  274.                        (02) 493210 (Norway)
  275.  
  276.               =====================================================
  277.  
  278.               Rodel°kka (M)BBS at 300-19200 baud, 24hrs, two nodes.
  279.  
  280.               Phone # +47 2 380949 (international) (V32/V42bis/PEP)
  281.                        (02) 380949 (Norway)
  282.  
  283. 1.9  A  probable  future expansion is the addition of more  protocols.
  284.      We  welcome  debugged and documented C-source of other protocols,
  285.      as  lack  of time prevents us from writing them ourselves...
  286.      XPR libraries are especially welcome!
  287.  
  288.      A  final  note:  Please read this documentation carefully.  Most
  289.      things should be explained here.
  290.  
  291. 1.10 Disclaimer:
  292.      -----------
  293.      We  have  made  every  effort  possible to ensure that NComm will
  294.      function  as described, but no warranty of any kind, expressed or
  295.      implied, is  made by us.  We will not be liable for any direct or
  296.      indirect  damages  to  either machinal equipment or mental health
  297.      arising  from  a  failure of the program to operate in the manner
  298.      desired  by the user.  In no event will we be liable for any loss
  299.      of profits or savings.
  300.  
  301. 1.11 Summary of functions:
  302.  
  303.         o Works on any Amiga with 512K RAM or more. Menu driven.
  304.         o ANSI / VT100 terminal emulation with full 8 colour text
  305.           support. IBM graphics (optional). Optional translation of
  306.           styles. Interlaced screen (optional). PAL, NTSC and overscan
  307.           support. Can be run on WB screen. OS 2.0 support. Flashing text.
  308.           80 x 24 option. Automatic ANSI detection. Optional line wrap.
  309.         o Full support for all European languages (both character-
  310.           sets and keymaps). Thirteen translation modes.
  311.         o Baud rates up to 115200 baud supported (31250 baud on a M68000-
  312.           Amiga). Xon/Xoff and CTS/RTS handshaking. Fast screen I/O.
  313.           Optional shared mode. Adjust option. DTR hangup option.
  314.           1200/75 support. LockSerial support. All paritys supported.
  315.           Half duplex option. User settable device and unit number.
  316.         o Fast file transfer protocols:  ASCII, Xmodem, Xmodem-CRC,
  317.           Ymodem, Ymodem-Batch, Ymodem-G (for error correcting modems).
  318.           Fast Zmodem and Kermit, Jmodem and Compuserve Quick-B protocols
  319.           using external libraries. Full support for custom XPR libraries.
  320.           Autochop on receive files - disabled for ARC, ZOO, PAK, ZIP.
  321.           Optional translation. Batch uploads and downloads. Optional icon
  322.           creation. Filenote option.
  323.         o Autodownload feature for MBBS or systems with G&R protocol.
  324.           G&R host mode. Zmodem autodownload and autoupload features
  325.           for use with any system.
  326.         o A very powerful inbuilt script language - simple text language
  327.           automates sessions. Advanced Host-Mode script follows program.
  328.         o An ARexx interface with access to all script and menu commands.
  329.         o Optional scrollback buffer - view, save or paste text that
  330.           previously has been displayed on screen. Block functions.
  331.           Real-time scrolling. Search function. Settable scrollback size
  332.           from 8K to 1/2 MB.
  333.         o Hot Keys for most program functions, including dialing of
  334.           up to 10 phone numbers.
  335.         o Split screen mode for conferencing.
  336.         o Dialing directory, queued dial, redial until carrier
  337.           received. Redial at logoff. Support for all kind of modems.
  338.         o 46 entry fast phonemenu. Advanced phone requester with
  339.           unlimited entries.
  340.         o 24 keyboard macros using function and cursor keys.
  341.         o Optional real time printing of incoming text.
  342.         o Log writes. Automatically records when you were last on system.
  343.         o Nodelist support via traplist.library.
  344.         o Clipboard support. NComm sends the contents of the clipboard
  345.           (unit 0) to the serial port when the escape code sent by the
  346.           "conclip" program is received ("\x9b" "0 v")
  347.         o Internal multitasking.
  348.  
  349. CHAPTER 2: PREPARATION
  350.  
  351. 2.1  The following files should be included in this package:
  352.  
  353.      Work:NComm
  354.      d----rwxd   Feb 12 15:50     0        0 CpuBlit
  355.      d----rwxd   Mar  3 21:28     0        0 Doc
  356.      d----rwxd   Feb 12 15:05     0        0 fonts
  357.      d----rwxd   Mar  3 20:28     0        0 Host
  358.      d----rwxd   Feb 18 10:34     0        0 libs
  359.      d----rwxd   Mar  3 20:30     0        0 PbView
  360.      d----rwxd   Feb 13 11:20     0        0 Scripts
  361.      -----rwxd   Feb 12 15:58     2      977 Install
  362.      -----rwxd   Mar  3 21:32   381   192244 NComm
  363.      -----rwxd   Feb 12 15:36     4     1617 NComm.config
  364.      -----rwxd   Feb 12 15:29     1       17 NComm.keys
  365.      -----rwxd   Mar  3 21:03   100    50771 NComm.news
  366.      -----rwxd   Feb 12 15:36     2      685 NComm.phone
  367.      Dirs:7    Files:6    Blocks:490   Bytes:246221
  368.  
  369.      Work:NComm/CpuBlit
  370.      -----rwxd   Aug  8  1991    15     7232 CpuBlit
  371.      Dirs:0    Files:1    Blocks:15    Bytes:7232
  372.  
  373.      Work:NComm/Doc
  374.      -----rwxd   Mar  3 21:03    31    15428 ARexx.doc
  375.      -----rwxd   Aug  8  1991    28    14030 CpuBlit.doc
  376.      -----rwxd   Aug  8  1991    36    18388 Host.doc
  377.      -----rwxd   Mar  3 21:28   197   103958 NComm.doc
  378.      -----rwxd   Mar  3 21:06    54    27251 Script.doc
  379.      Dirs:0    Files:5    Blocks:346   Bytes:174701
  380.  
  381.      Work:NComm/fonts
  382.      d----rwxd   Feb 12 15:05     0        0 NComm1
  383.      d----rwxd   Feb 12 15:05     0        0 NComm2
  384.      -----rwxd   Feb 12 15:05     1      264 NComm1.font
  385.      -----rwxd   Feb 12 15:05     1      264 NComm2.font
  386.      Dirs:2    Files:2    Blocks:2     Bytes:528
  387.  
  388.      Work:NComm/fonts/NComm1
  389.      -----rwxd   Feb 12 15:05     6     2616 8
  390.      Dirs:0    Files:1    Blocks:6     Bytes:2616
  391.  
  392.      Work:NComm/fonts/NComm2
  393.      -----rwxd   Feb 12 15:05     2      572 8
  394.      Dirs:0    Files:1    Blocks:2     Bytes:572
  395.  
  396.      Work:NComm/Host
  397.      d----rwxd   Feb 29 10:34     0        0 Bulletins
  398.      d----rwxd   Feb 29 10:34     0        0 Ckomm
  399.      d----rwxd   Feb 29 10:34     0        0 Files
  400.      d----rwxd   Mar  1 14:43     0        0 Hold
  401.      d----rwxd   Feb 29 10:34     0        0 Menus
  402.      d----rwxd   Feb 29 10:34     0        0 Msgs
  403.      -----rwxd   Feb 29 10:34     1      191 a.script
  404.      -----rwxd   Feb 29 10:34     1       53 CharSets
  405.      -----rwxd   Feb 29 10:34     1      326 FirstUser
  406.      -----rwxd   Feb 29 10:34     3     1297 host.config
  407.      -----rwxd   Mar  3 20:28    91    45604 host.script
  408.      -----rwxd   Feb 29 10:34     1      237 logout
  409.      -----rwxd   Feb 29 10:34     1      134 newuser
  410.      -----rwxd   Feb 29 10:34     1      206 postlog
  411.      -----rwxd   Feb 29 10:34     1      432 prelog
  412.      -----rwxd   Feb 29 10:34     1       62 TransProtos
  413.      -----rwxd   Feb 29 10:34     1       11 TransProtosS
  414.      Dirs:6    Files:11   Blocks:103   Bytes:48553
  415.  
  416.      Work:NComm/Host/Bulletins
  417.      -----rwxd   Feb 29 10:34     1       53 bull0
  418.      -----rwxd   Feb 29 10:34     4     1835 Bull1
  419.      -----rwxd   Feb 29 10:34     1       46 Bull2
  420.      Dirs:0    Files:3    Blocks:6     Bytes:1934
  421.  
  422.      Work:NComm/Host/Ckomm
  423.      -----rwxd   Feb 29 10:34     1       58 README
  424.      Dirs:0    Files:1    Blocks:1     Bytes:58
  425.  
  426.      Work:NComm/Host/Files
  427.      -----rwxd   Feb 29 10:34     1       43 Readme
  428.      Dirs:0    Files:1    Blocks:1     Bytes:43
  429.  
  430.      Work:NComm/Host/Hold
  431.      -----rwxd   Mar  1 14:43     1       58 Boringtown BBS
  432.      Dirs:0    Files:1    Blocks:1     Bytes:58
  433.  
  434.      Work:NComm/Host/Menus
  435.      -----rwxd   Feb 29 10:34     4     1568 allmenu
  436.      -----rwxd   Feb 29 10:34     1      297 menu0
  437.      -----rwxd   Feb 29 10:34     1      410 menu1
  438.      -----rwxd   Feb 29 10:34     1      198 menu2
  439.      -----rwxd   Feb 29 10:34     1      304 menu3
  440.      -----rwxd   Feb 29 10:34     1      186 menu4
  441.      -----rwxd   Feb 29 10:34     1      208 menu5
  442.      Dirs:0    Files:7    Blocks:10    Bytes:3171
  443.  
  444.      Work:NComm/Host/Msgs
  445.      -----rwxd   Feb 29 10:34     1      286 Messages1
  446.      -----rwxd   Feb 29 10:34     0        0 Messages2
  447.      -----rwxd   Feb 29 10:34     1      144 README
  448.      Dirs:0    Files:3    Blocks:2     Bytes:430
  449.  
  450.      Work:NComm/libs
  451.      -----rwxd   Aug  8  1991    36    18012 req.library
  452.      -----rwxd   Aug  8  1991    38    19104 xprkermit.library
  453.      -----rwxd   Feb 18 10:34    40    20172 xprzmodem.library
  454.      Dirs:0    Files:3    Blocks:114   Bytes:57288
  455.  
  456.      Work:NComm/PbView
  457.      -----rwxd   Feb 13 00:50    19     9248 PbView
  458.      -----rwxd   Mar  3 20:30     7     3152 PbView.c
  459.      -----rwxd   Feb 13 00:48     1       66 PbView.lnk
  460.      Dirs:0    Files:3    Blocks:27    Bytes:12466
  461.  
  462.      Work:NComm/Scripts
  463.      -----rwxd   Aug  8  1991     2      838 mbbs.script
  464.      -----rwxd   Feb 12 10:59     1      434 rxread1.ncomm
  465.      -----rwxd   Feb 12 11:00     2      700 rxread2.ncomm
  466.      -----rwxd   Feb 13 11:20     2      877 rxread3.ncomm
  467.      -----rwxd   Feb 10 20:51     2      682 testrx.ncomm
  468.      Dirs:0    Files:5    Blocks:9     Bytes:3531
  469.  
  470.      Be  careful  not  to  mix these files with old Comm 1.34 or NComm
  471.      1.01  files   that  may  be  lying  around.   The  datafiles  are
  472.      incompatible.
  473.  
  474. 2.2  Read  the  file  'host.doc'  for information about the NComm Host
  475.      Script.
  476.  
  477. 2.3  The NComm.config format has been changed since NComm 1.8.  If you
  478.      haven't  used  V1.9,  all  configuration files should be deleted!
  479.      The same thing goes for V1.8 phonebooks.
  480.  
  481. 2.4  NComm  uses  two  fonts  for  emulating  IBM graphics.  They must
  482.      reside  in  the  directory  named  FONTS:.   NComm  also uses two
  483.      external  protocol libraries for supporting Kermit and Zmodem.  A
  484.      Requester  Library is being used for many of the requesters.  All
  485.      of these files must be installed before NComm can be used.
  486.  
  487.      To install NComm, enter the following command in CLI;
  488.      (or just click on the Install icon from WorkBench)
  489.  
  490.      1> Execute Install
  491.  
  492.      This  batchfile  will  copy  the  font files used by NComm to the
  493.      FONTS:   directory.  First  (of course) you have to assign FONTS:
  494.      to  the  directory  where you keep your fonts.  Unless you assign
  495.      these  fonts correctly, the IBM graphics emulation will not work!
  496.  
  497.      Important!
  498.      ----------
  499.      Users  of  NComm V1.9 should reinstall the fonts, since they have
  500.      been redesigned by Bj°rn Rybakken!  Users  of V1.8 MUST reinstall
  501.      the fonts since they had a bug.
  502.  
  503.      The  batchfile  will also copy the XPRZmodem.library to the LIBS:
  504.      directory.   This  is  a  public  domain  Zmodem library that was
  505.      created  by  Rick  Huebner  -  thanks  a  lot!  The file  MUST be
  506.      present,  or  the Zmodem protocol won't work!  The version number
  507.      included  is  2.5.
  508.  
  509.      The  XPRKermit.library  will also be copied, and is necessary for
  510.      Kermit to work. It was made by Stephen Walton. The version number
  511.      included is 1.5.  This  version  is told to contain several bugs,
  512.      and  Stephen  is  working hard on a new release which is expected
  513.      soon.  I  highly  recommend  switching to the new version when it
  514.      arrives.
  515.  
  516.      Finally,  the  batchfile  file  will copy the Req.library V2.5 to
  517.      LIBS:  and set up an NComm assignment to the current directory.
  518.  
  519.      NOTE: the  "xprjmodem"  and  "xprquickb"  libraries have not been
  520.      included. You have to get them from somewhere else.
  521.  
  522. 2.5  Data files
  523.      ----------
  524.      It  is  important  for  NComm  to know where it can find its data
  525.      files,  and  we must help it on its way.  If NComm was unarced in
  526.      the  ROOT  directory  of  a  floppy  disk,  relabel  the  disk as
  527.      "NComm".   This  can  be done with the following command if NComm
  528.      resides on df1:
  529.  
  530.          1> Relabel drive df1: name "NComm"
  531.  
  532.      If  the  files  were unarced within a directory or on a harddisk,
  533.      you  must  assign "NComm:" to the directory that NComm resides in
  534.      including full device and path names.
  535.  
  536.      Examples:
  537.  
  538.          1> Assign NComm: "df1:"
  539.  
  540.      ...expects NComm to reside in the ROOT directory of drive "df1:"
  541.  
  542.          1> Assign NComm: "dh0:NComm_2.0"
  543.  
  544.      ...expects NComm to reside in directory "NComm_2.0" on "dh0:"
  545.  
  546.      If  you  do  not  wish  to  name  the  disk that NComm resides on
  547.      'NComm',   it   is   probably   a   good   idea   to   edit   the
  548.      "s:startup-sequence"  file  and  add  the assign command that you
  549.      just entered.
  550.  
  551. 2.6  NComm  has  an  inbuilt  command  for opening a new CLI. If NComm
  552.      should  not  use the normal "NewCLI" command for opening the CLI,
  553.      this  can  be  done  by  using  the SetEnv command in WB1.3.  For
  554.      example:
  555.  
  556.         1> setenv NEWCLI "NewSHELL *"newcon:0/11/640/245/NCommShell*""
  557.  
  558. 2.7  NComm  normally  opens the serial.device in "exclusive" mode.  If
  559.      the  serial device  could  not be opened, the message "Can't open
  560.      serial device"  will  be displayed (workbench users will notice a
  561.      flash on the workbench screen if NComm of some reason can't run).
  562.      If  another  program  is using the serial port, NComm will not be
  563.      able  to  run  in  "exclusive"  mode.  The internal "shared" mode
  564.      option must then be stored in your configuration file if you want
  565.      to use the two programs simultaneously.
  566.  
  567. 2.8  NComm has the following synopsis when started from CLI:
  568.  
  569.         1> NComm [SCRIPTFILE]  [-cCONFIGFILE] [-mMACROFILE]
  570.                  [-pPHONEBOOK] [-sSCROLLBACK] [-d(ISABLE ADDING)]
  571.                  [-e(NABLE DSR/CTS ERROR MESSAGES)]
  572.                  [-rAREXXSCRIPT] [-u(SERNAME)]
  573.  
  574.      The CLI '-u' option shows who owns this copy. Hopefully YOUR name
  575.      is displayed,  if not you had better report this to me as soon as
  576.      possible.
  577.  
  578.      Note: The -r option must be the last one if specified.
  579.  
  580.      From WorkBench, just click on the NComm icon.
  581.  
  582. 2.9  Note:
  583.      -----
  584.      Single-drive  users  have  to  execute  these  commands  in a bit
  585.      different  manner.  Either  you can copy the needed commands into
  586.      RAM:   and  assign  c:   to  RAM:,  or  you may enter the desired
  587.      commands  with   just  a question mark as command-line.  You will
  588.      then  be  given  a  long  prompt,  at  which you should enter the
  589.      normal   command-line"  with  drive  specified  as  df0:.  As  an
  590.      example, here is how to relabel a disk...
  591.  
  592.      Boot your AmigaDOS disk in df0: and enter this at the prompt:
  593.  
  594.         1> Relabel ?
  595.  
  596.      "DRIVE/A,NAME/A"  now  appears  on the screen.   Now put your new
  597.      NComm disk in df0:  and enter this:
  598.  
  599.         drive df0: name "NComm"
  600.  
  601. 2.10 How to configure NComm for use with MBBS.
  602.      -----------------------------------------
  603.  
  604.      To   get  the  most  from  NComm when using the MBBS program, you
  605.      should   log  in at the MBBS boards you are going to use.  In the
  606.      utility   menu,  there are several options that have to be turned
  607.      on.    Walk  to  the utility menu with the (U)tility command, and
  608.      select  (M)ode  changes.   Answer  'YES'  at  all  prompts.   The
  609.      message  'User  profile  updated'  will  be  displayed.  Now,  if
  610.      you're  using  a  PAL  machine, you probably want to  configure a
  611.      larger number of lines per page than what has been  configured by
  612.      MBBS.  Select  (L)ines  per page, and enter '29' at  the  prompt.
  613.      Finally, select  IBM  graphics by using the (S)et  character  set
  614.      command. Enter 'IBN' at the prompt.
  615.  
  616.      Some   options  must  now  be  turned  on  in NComm.  Walk to the
  617.      'Transfer'  menu, and turn  on the 'G&R Protocol'.  Configure the
  618.      default  directories for these transfers if you don't have enough
  619.      memory  to  use the RAM DISK.  Now, examine that your 'Com' setup
  620.      is  8N1.   Always  use this setup when connecting to MBBS boards,
  621.      otherwise  high  bits  will be stripped.  Turn the 'IBN character
  622.      set'  on in the 'Translate' menu.  Turn the '8 Colour' mode on in
  623.      the  screen menu, and 'Reset' the colours by opening the palette.
  624.      You  now  have  true ANSI graphics!  Remember to save the present
  625.      configuration.
  626.  
  627. 2.11 A note about using NComm with Ymodem-G and High Speed modems
  628.      ------------------------------------------------------------
  629.  
  630.      Characters   may  sometimes  disappear when using NComm with baud
  631.      rates   above  9600 baud.  This is not due to a bug in NComm, but
  632.      is   caused  by  a  problem  with either the serial.device or the
  633.      Amiga   hardware.
  634.  
  635.      If   you  want  to  perform file transfer with modems like the US
  636.      Robotics  HST,  we   recommend  using  the  Zmodem error checking
  637.      protocol.   It  is  not safe to use the Ymodem-G protocol at high
  638.      baud  rates  even  if the  modem is having MNP available - errors
  639.      may occur!.
  640.  
  641.      We   apologize  for this, and hope this will be fixed in a future
  642.      version  of  the  Amiga  software  or hardware!  We have tried to
  643.      shorten   down  the  cable  between the modem and the machine but
  644.      that   didn't  seem  to  help.  We have checked every other Amiga
  645.      comms  program available, and the same thing seems to happen with
  646.      them.
  647.  
  648. 2.12 How to obtain high transfer rates with HST modems
  649.      -------------------------------------------------
  650.  
  651.      Some  people  have reported that they are not able to obtain high
  652.      transfer  rates  with  the Zmodem protocol.  I personally have no
  653.      problems  reaching  1700  CPS with NComm on a standard Amiga 2000
  654.      with many programs waiting in the background.  Please read trough
  655.      this list of possible faults before sending any more complaints.
  656.  
  657.      *  Some  versions of the serial.device miscalculate the baud rate
  658.         by 1.1% and may therefore either slow transfers down, or cause
  659.         errors. If  you  experience  such problems,  try  setting  the
  660.         adjust factor to -11 (it should normally be set to zero!)
  661.  
  662.      *  Use  the newest version of serial.device, i.e 34.104 or above.
  663.         Test your version number with the following command...
  664.  
  665.         1> version serial.device
  666.  
  667.      *  The sending  protocol and the hardware used by the BBS is also
  668.         very important, as well as noise on the telephone line. If you
  669.         have  problems  with  reaching  high baud rates, this may be a
  670.         problem with the BBS program or the telephone line.
  671.  
  672.      *  With  the standard Amiga serial.device you should NOT lock the
  673.         baud  rate  at anything more than 19200 baud  (unless  you are
  674.         using  a  machine  equipped  with  a  68020  or 68030 card). A
  675.         standard  Amiga  does  only  handle transfers at a  maximum of
  676.         31250 baud...
  677.  
  678.      *  When  using  the  ASDG Dual Serial Board, you must remember to
  679.         lock  the baud  rate at 38400 baud. Otherwise the buffer might
  680.         overflow.
  681.  
  682.      *  Check  the  cabling.  The  RS232  cable  should be as short as
  683.         possible,  and  protected against electrical interference. The
  684.         same  thing  goes for the telephone cable. The cabling is very
  685.         important for obtaining high transfer rates.
  686.  
  687.      *  Your  modem  must  be set up correctly.  These US Robotics HST
  688.         settings have been tested and work very well:
  689.  
  690.         Courier HST (non-V32/V42 version)
  691.         ---------------------------------
  692.         AT &F B1 X4 &B1&C1&D2&G0&H1&I0 <cr>
  693.         AT &J0&K0&L0&M4&N8&P0&R2&S0&X1&Y1 &W <cr>
  694.  
  695.         Courier HST Dual Standard (V32/V42 version)
  696.         -------------------------------------------
  697.         AT &F B0X4 &A3&B1&H1&K3&R2&S0S28=20 &W <cr>
  698.  
  699.      *  Don't  multitask,  i.e  don't  have  anything  running  in the
  700.         background  since this will slow things down and cause errors.
  701.         Even a simple operation like bringing another screen or window
  702.         to front,  may cause errors!
  703.  
  704.      *  Utility Programs  like  PopCLI, QMouse, VirusX, Mach and so on,
  705.         may be quite cruel to the  system, especially if they run at a
  706.         high priority - try removing them if you experience problems.
  707.  
  708.      *  Use  TWO  colours, NO interlace, NO overscan.  Everything else
  709.         will slow transfers down and cause errors.
  710.  
  711.      *  Turn  on CTS/RTS handshaking in NComm.  To be able to use this
  712.         hardware   handshaking,   your  modem  must  also  be  set  up
  713.         correctly!   You  will  have  to use a cable with pins 4 and 5
  714.         connected.   The  CTS  and  DSR  signal  must be constantly on
  715.         before  starting  NComm.   See  your modem users manual if you
  716.         don't know how to configure it correctly.
  717.  
  718.      *  Zmodem ACKknowledge should be turned OFF. Transfers should  go
  719.         to  RAM:  or  a fast  harddisk. Otherwise, Zmodem will HAVE to
  720.         acknowledge for every 16th block received.
  721.  
  722.      *  Setting  the priority of  NComm to one or higher will normally
  723.         give  best  results.  We  recommend setting the priority to at
  724.         least  one.  Setting  the  priority  to  16  or  higher is NOT
  725.         recommended.
  726.  
  727.      *  Transfer  to  RAM:  or  a fast  harddisk. Floppy drives do not
  728.         handle  transfers  at  anything  more  than  9600  baud!  Some
  729.         harddisks  hog the CPU when reading or writing. This can cause
  730.         errors  during  transfers.  If you experience such problems, I
  731.         recommend   that   you  use  RAM:  as  your  default  download
  732.         directory,  and  transfer the files to a permanent media after
  733.         having logged off the bulletin board.
  734.  
  735. 2.13 There  has  been  some  problems  with  setting  up the TBK 9600+
  736.      auto-dialling modem for use with NComm. I recommend the following
  737.      initialization, which has been tested and works very well:
  738.  
  739.      Modem should be used with 19200 baud constant local speed.
  740.  
  741.      -----------------------------------------------------------------
  742.      AT &F                        Reset modem to factory configuration
  743.      -----------------------------------------------------------------
  744.      AT B0 &C1 &D2                 CCITT, DCD track on, DTR hang-up on
  745.      AT &S0                      (Very important!) Constant DSR signal
  746.      -----------------------------------------------------------------
  747.      AT &G0 M0 (M1)?              Guard tone off, Loudspeaker off (on)
  748.      -----------------------------------------------------------------
  749.      AT %C0 +C1 +D0              MNP5 off, Constant speed, 1300 Hz off
  750.      AT \N3 \Q3                      Auto-MNP on, RTS/CTS flow control
  751.      AT +Q3 +T1                         Extra result codes, Trellis on
  752.      -----------------------------------------------------------------
  753.      AT &W0 &W1                        Store new config in both setups
  754.      AT Z                                And reset modem to new config
  755.      -----------------------------------------------------------------
  756.  
  757.      And now, remember to turn on CTS/RTS in NComm.
  758.  
  759. 2.14 If you want to use another icon than the one supplied with NComm,
  760.      remember to set the stack size to 10000 bytes. Otherwise, you may
  761.      experience  that  NComm gives you a software failure from time to
  762.      time - not funny at all.
  763.  
  764.  
  765. CHAPTER 3: COMMANDS IN SYSTEM MENU
  766.  
  767. 3.1  Here  you  control  all system functions.  From here you can load
  768.      and  save  settings, view the status, edit the macrokeys, turn on
  769.      and  off  the  printer, and start a new CLI.  You can also choose
  770.      whether  NComm should add entries to the logfile when you connect
  771.      with  a  board.   You  may  also exit NComm from here, as well as
  772.      execute script-files.
  773.  
  774. 3.2  About NComm
  775.         Will tell you a few things about NComm and the author.  Simply
  776.         click in the window to close it...
  777.  
  778. 3.3  Status
  779.         This  will  bring  up  a  status display showing the amount of
  780.         memory  available, the state of the printer and capture buffer
  781.         toggles.  If  the  capture  buffer  has  been  turned  on, the
  782.         filename will also be displayed.
  783.  
  784.         Here  you  will  also  find  a  slider gadget for use with the
  785.         "ASCII  send"  and  "message  send"  functions.  Some Bulletin
  786.         Board  Systems  lose  data  if is being sent too fast, so this
  787.         function can be very useful.
  788.  
  789. 3.3.1   You  can  select  a  time  to  delay  after  transmitting each
  790.         character  by  using  this  slider  gadget.  The gadget can be
  791.         adjusted from approx  20ms  (Fast)  to  300  ms  (Slow)  delay
  792.         between  transmitted  characters.   The slider can be adjusted
  793.         while a file is being sent to allow for fine tuning.
  794.  
  795.         With  the  slider in the (default) far left position, there is
  796.         no delay.
  797.  
  798. 3.3.2   A  scrollback buffer can be set with the second slider gadget.
  799.         This  can  be useful if you often loose CARRIER while entering
  800.         messages  or if you are bothered by pages often scrolling past
  801.         your screen.  Here you can set the buffer size, i.e.  how much
  802.         NComm  at  all  times shall remember of the incoming data.  If
  803.         you are using a 512K Amiga, it may be wise to use only a small
  804.         scrollback  buffer.   Set the scrollback buffer to '0K' if you
  805.         want to turn off this option, or want to clear the buffer.
  806.  
  807. 3.4 Load config
  808.         Will load a new NComm configuration.  All menu options and the
  809.         status  window  settings  are  covered  by this function.  The
  810.         macrokeys and the phonebook must be loaded separately.  A file
  811.         input requester will appear in the center of the screen.  Only
  812.         files with a ".config" suffix will be shown.
  813.  
  814. 3.5 Save config
  815.         Will  save  the current NComm configuration.  All menu options
  816.         and  the  status window settings are covered by this function.
  817.         The  macrokeys  and the phonebook must be saved separately.  A
  818.         file  input requester will appear in the center of the screen.
  819.  
  820. 3.6 Script
  821.         This  function  will  execute  a  scriptfile.   A  file  input
  822.         requester will appear in the center of the screen.  Select the
  823.         script  you  want  to run.  The text SCR' will be displayed on
  824.         the  status  line.  To stop a script, select this entry again.
  825.         See the file "Script.doc" for detailed information on scripts.
  826.  
  827. 3.7 Macrokeys
  828.         This  will  bring  up  a  requester  that  lets  you  edit the
  829.         macrokeys.   Here  you  may  also load new macros and save the
  830.         text  stored  on  the  different macrokeys.  The function keys
  831.         definable  are  F1  to  F10 and SHIFT F1 to F10.  You may also
  832.         define what the cursor keys should send when shifted.  A macro
  833.         definiton  can  be 512 bytes maximum.  Not all keys have to be
  834.         defined.   To  edit a macro just click in one of the requester
  835.         text  input  boxes  and enter your definition.  The macros can
  836.         contain  control  characters  which  can be represented in two
  837.         ways.   These  characters  can also be used in the modem setup
  838.         requester or in scripts when using the SEND commands.
  839.  
  840. 3.7.1           1.    C-style   slash   conventions.    The  following
  841.                       sequences are supported:
  842.  
  843.                     \n, \r      Carriage Return
  844.                     \t          Tabulator
  845.                     \f          Form Feed
  846.                     \b          BackSpace
  847.                     \v          Vertical Tabulator
  848.                     \e          Escape
  849.                     \\          Backslash
  850.                     \"          Quote
  851.                     \p          Phonebook Password
  852.                     \w          .5 second Delay
  853.                     \l          250 ms Line Break
  854.                     \m          Macro
  855.                     \i          Send modem init string
  856.                     \xHEXNUMBER Send ASCII hex-character f.ex. \x1b
  857.                     \NUMBER     Send ASCII character f.ex \32 (space)
  858.  
  859.                 2.    The   caret   followed   by  a  letter,  meaning
  860.                       CTRL+letter.    If   you   need  the  line  feed
  861.                       character, for example, use  ^J.  '^^' will send
  862.                       the caret itself.
  863.  
  864.         A scriptfile may be started  from a macro by entering {script}
  865.         followed  by  the  name and path of the scriptfile you want to
  866.         execute. Example: {script}RAM:test.script
  867.  
  868.         An  arexx  scriptfile  may be started from a macro by entering
  869.         {arexx} followed by the name, path and optional parameters for
  870.         the arexx scriptfile.  Example:  {arexx}ncomm:testrx.ncomm
  871.  
  872.         You  can have nested macros by using the \m## option, where ##
  873.         is a number from 1 to 20 - with 1 representing macro F1 and 11
  874.         and 20 representing Shift F1 and Shift F20 respectively.
  875.  
  876.         Examples:
  877.  
  878.         commodore            ;Will not add a carriage return.
  879.         at \\N3\n            ;AT \N3 plus a carriage return.
  880.         ^pread               ;The control-P code, followed by 'read'.
  881.         \m1\m2run testfile\r ;The text stored on macro F1 and F2, plus
  882.                              ;the text 'run testfile' and a CR.
  883.  
  884. 3.7.2   Selecting  the 'Load' gadget will bring up a file requester in
  885.         the  center  of  the  screen.   From  here  you  may  load new
  886.         macrokeys.   Remember  to  save  the  current macrokeys if any
  887.         changes  have  been made.  Entering "NComm.keys" will load the
  888.         macrokeys that are normally loaded at startup.
  889.  
  890. 3.7.3   Selecting  the 'Save' gadget will bring up a file requester in
  891.         the  center of the screen.  From here you may save the current
  892.         macrokeys.   Enter  the  name  "NComm.keys"  if  you  want the
  893.         macrokeys to be loaded on startup.
  894.  
  895. 3.7.4   Selecting  the 'Cancel' gadget will leave everything unchanged
  896.         and remove the macrokeys window.
  897.  
  898. 3.7.5   Selecting  the  'OK'  gadget will close the window and install
  899.         the new macros.
  900.  
  901. 3.8 Printer
  902.         Toggles  the  printer ON/OFF.  When ON, text received from the
  903.         serial  port  will  also  go to the device you specify  in the
  904.         requester  (PRT:  is  recommended).  The  text  'PRT'  will be
  905.         displayed on the status line.
  906.  
  907. 3.9 New CLI
  908.         Works  like the "NewCli" command, which must be present in the
  909.         C:  directory together with the 'RUN' command.  Will open up a
  910.         command line interface on the Workbench screen.  Type 'EndCli'
  911.         to exit the CLI and return to NComm.
  912.  
  913. 3.10 Log Calls
  914.         When  this  option is turned on, NComm will log all calls made
  915.         within  NComm.  The  information  will  be added to a textfile
  916.         called  "NComm.log". Also, the phonebook will automatically be
  917.         saved  at CONNECT so that we can keep track on when the boards
  918.         were last dialled.
  919.  
  920. 3.11 Set Priority
  921.         This  option  allows  you  to  increase  or decrease the NComm
  922.         priority a bit. Bumping the priority is especially recommended
  923.         when using high speed modems. This will decrease the number of
  924.         errors and also increases the transfer rate.
  925.  
  926. 3.12 ARexx Script
  927.         This  function will execute an arexx scriptfile.  A file input
  928.         requester will appear in the center of the screen.  Select the
  929.         arexx  script  that you want to run.  See the file "ARexx.doc"
  930.         for  detailed  information  on  arexx  scripts  and  available
  931.         commands.
  932.  
  933. 3.13 Quit NComm
  934.         Selecting this entry will close all open files and windows and
  935.         exit back to the operating system.
  936.  
  937.  
  938. CHAPTER 4: COMMANDS IN FILE MENU
  939.  
  940. 4.1  This  is  the  file  transfer  menu.   From  here you can start a
  941.      transfer  and select the different transfer options i.e protocol,
  942.      handshaking etc.
  943.  
  944.      When  the  upload  or download function is selected, a file input
  945.      requester  will  appear, that is if you have not selected the G&R
  946.      mode. Click on the "Ok" gadget when you have selected a file.
  947.  
  948. 4.2 Start ASCII Capture
  949.         All  data received from the serial port is also saved into the
  950.         named  file.   The text is buffered and written to the disk in
  951.         8K blocks.  If you are using a translation table, the incoming
  952.         data  will  be  translated.  Select the 'ISO' character set to
  953.         avoid this.
  954.  
  955.         When  this  mode  is  selected,  the text in the MENU entry is
  956.         changed  to  "Stop  ASCII Capture".  Selecting this entry will
  957.         flush the data buffer to the disk and close the file.
  958.  
  959.         When  capturing  is enabled, the word "CAP" will be visible on
  960.         the status line.
  961.  
  962.         When entering a filename for data capture, NComm will check to
  963.         see if this file already exists.  If it does, a requester will
  964.         appear  informing  you  of  that fact.  You may then choose to
  965.         CONTINUE  using  the  filename  entered  or  CANCEL  and enter
  966.         another  filename.   If  you  choose  to CONTINUE, you will be
  967.         presented  with another requester.  You can APPEND data to the
  968.         existing  file  or  DELETE  the existing data and start with a
  969.         fresh file.
  970.  
  971. 4.3 Start ASCII Send
  972.         The  named  file will be read and sent to the serial port.  If
  973.         the  file  does  not  exist,  a message to that effect will be
  974.         printed.   If  you are using a translation table, the outgoing
  975.         data  will  be  translated.   Select  the 'ISO' translation to
  976.         avoid this.
  977.  
  978.         When  this  mode  is  selected,  the text in the MENU entry is
  979.         changed  to "Stop ASCII Send".  Selecting this entry will stop
  980.         the transfer and close the disk file.
  981.  
  982. 4.4 Message upload
  983.         The  named  file will be read and sent to the serial port.  If
  984.         the  file  does  not exist, a warning message will be printed.
  985.         If  you  are using a translation table, the outgoing data will
  986.         be translated.  Select the 'ISO' translation to avoid this.
  987.  
  988.         This function will perform almost like "Start ASCII send", but
  989.         the  message  will  be packed.  Blank lines will be translated
  990.         into  spaces.   This  can  be useful when uploading to systems
  991.         with  a  certain  pagewidth, or if your message contains blank
  992.         lines  (usually  you  will  exit  the editor when a blank line
  993.         occurs in a message you upload with the ASCII send function.)
  994.  
  995.         Select  this  entry  again  to stop the transfer and close the
  996.         disk file.
  997.  
  998. 4.5 Download
  999.         The  named  file  will be created on the disk and the transfer
  1000.         will  be  started  using the protocol you have selected in the
  1001.         TRANSFER menu.
  1002.  
  1003.         If the specified file already exists, a requester will appear;
  1004.         asking  if  you  want  to  CONTINUE  or CANCEL the use of that
  1005.         filename.   Selecting CONTINUE will overwrite the old existing
  1006.         file  with  the  new  one.  Selecting CANCEL will bring up the
  1007.         INPUT WINDOW allowing you to enter another file name.
  1008.  
  1009.         A  window will pop up that among other things will display the
  1010.         name  of  the  file  being transferred, a running total of the
  1011.         bytes  received,  the  number of NAKs and the last block to be
  1012.         NAKed.  The transfer can be aborted by hitting the ESC key, or
  1013.         by pressing the upper left-hand close gadget. The current file
  1014.         can be skipped by pressing the gadget marked "Skip File".
  1015.  
  1016.         The  serial  port  parameters  will  be saved and changed to 8
  1017.         bits,   no   parity,  1  stop  bit  for  the  transfer.   Upon
  1018.         completion, the old settings will be restored.
  1019.  
  1020. 4.6 Upload
  1021.         Use  this selection to transmit a file to a system.  The named
  1022.         file  will  be  opened  on  the  disk and the transfer will be
  1023.         started  using  the  error  checking  method (CRC or Checksum)
  1024.         selected by the receiving end.
  1025.  
  1026.         Ymodem-Batch/G  and  Zmodem support batch uploading. Hold down
  1027.         the  SHIFT key  if  you  want  to select multiple files in the
  1028.         file requester.
  1029.  
  1030.         If  the specified file does not exist, a requester will appear
  1031.         informing  you  of  this  fact.   You  only have the option to
  1032.         CONTINUE, which will bring up the INPUT WINDOW allowing you to
  1033.         re-enter the filename or CANCEL the upload.
  1034.  
  1035.         A  window will pop up that among other things will display the
  1036.         name  of  the  file  being transferred, a running total of the
  1037.         bytes  sent,  the  number of NAKs and the  last  block  to  be
  1038.         NAKed.  The transfer can be aborted by hitting the ESC key, or
  1039.         by pressing the upper left-hand close gadget. The current file
  1040.         can be skipped by pressing the gadget marked "Skip File".
  1041.  
  1042.         As   described  in  the  Download  section,  the  serial  port
  1043.         parameters  are  temporarily  changed to 8N1 for the transfer.
  1044.  
  1045. 4.7 Options
  1046.  
  1047. 4.7.1           CRC
  1048.         This  function  selects the type of error checking to be used
  1049.         during  Xmodem  transfers.  If  CRC  is  not  turned  on, the
  1050.         checksum method will be used.
  1051.  
  1052.         The  original  Christensen protocol used an 8 bit checksum for
  1053.         error checking.  It is about 97% effective in catching errors.
  1054.         All  implementations  of  XMODEM  can use the checksum method.
  1055.         Only  use  the cheksum method when in doubt, the CRC method is
  1056.         much more secure.
  1057.  
  1058.         A  later  addition  to  the protocol was the 16 bit (two byte)
  1059.         Cyclic  Redundancy  Check  (  CRC  )  which  is  about 99.997%
  1060.         effective  in  detecting  errors.   Not all implementations of
  1061.         XMODEM  can  use  the CRC method.
  1062.  
  1063. 4.7.2           Chop Files
  1064.         File  transfers  will  increase the size of a file to the next
  1065.         largest  multiple  of  128 bytes for XModem transfers and 1024
  1066.         bytes  for  YModem.   The  CHOP  FILES  option will remove the
  1067.         padding  on the end of the file.  This is always required when
  1068.         transferring   executable  binary  files.   CHOPing  files  is
  1069.         therefore desired.
  1070.  
  1071.         Note:
  1072.         It is not desireable to CHOP an .ARC, .ZOO, .PAK or .ZIP file.
  1073.         As  it  is  very  easy to forget to turn off the CHOP mode for
  1074.         these files, NComm will check the receive-filename for such an
  1075.         extension.   If  this  is  found,  it will temporarily disable
  1076.         CHOPing  for  this file and on completion of transfer the CHOP
  1077.         flag will be reset to its previous value.
  1078.  
  1079. 4.7.3           G & R Protocol
  1080.         This  is  an  auto  up/download protocol for use with the MBBS
  1081.         system.   You  must  remember to also turn on G&R in your MBBS
  1082.         user  account to make it work.  By using this protocol, you no
  1083.         longer  have  to  enter  the  desired protocol and filename in
  1084.         NComm  when  transferring  files  to  and from an MBBS system.
  1085.         This  means that you do not have to deal with the tedious file
  1086.         requester.
  1087.  
  1088. 4.7.4           G & R Host Mode
  1089.         This  feature  is meant to be used when two NComm programs (or
  1090.         one  NComm and one GLink program) are connected to each other.
  1091.         You  may  use a nullmodem cable or two modems. When one of the
  1092.         programs  have  been  set  to  utilize  this feature, the file
  1093.         transfer  can be controlled from that machine. All you have to
  1094.         specify is protocol, filename and up/download.
  1095.  
  1096. 4.7.5           Zmodem RESUME
  1097.         If  this  feature  has  been turned on, NComm will not discard
  1098.         existing  data  when  using  Zmodem  download.   Data  will be
  1099.         appended  to  the  file  until  the  filesize  is correct.  No
  1100.         requester  will  appear.   Turn  this  feature  on  if you for
  1101.         example loose carrier during a Zmodem download - you will then
  1102.         only have to transfer the bytes that are missing.
  1103.  
  1104. 4.7.6           Zmodem AUTODL
  1105.         If  this  feature has been turned on, NComm will automatically
  1106.         jump into receive mode when the string '**^XB00' is  received.
  1107.         This  means  that  you  won't have to select Download from the
  1108.         menu when transferring with Zmodem.
  1109.  
  1110. 4.7.7           Zmodem AUTOUL
  1111.         If  this  feature has been turned on, NComm will pop up with a
  1112.         file  requester  when  the string '**^XB01' is  received. This
  1113.         means  that you won't have to select Upload from the menu when
  1114.         transferring with Zmodem.
  1115.  
  1116. 4.7.8           Zmodem ACK
  1117.         This  option  turns  on  Zmodem  ACK, and will force Zmodem to
  1118.         acknowledge  each  16th  block  received.  This will of course
  1119.         slow   transfers  down  so  only  turn  ACK   on  if  you  are
  1120.         transferring  to  a very slow device (errors may then occur if
  1121.         this feature has NOT been turned on). NComm will automatically
  1122.         turn Zmodem ACK on when transferring to DFx: at speeds greater
  1123.         than 9600 baud.
  1124.  
  1125. 4.7.9           Zmodem BufSize
  1126.         This  option  sets  the size of XPRZmodem's file I/O buffer in
  1127.         kilobytes.  The minimum size is 1KB, the maximum value is 1024
  1128.         KB  (1MB). I recommend entering a value of 16.
  1129.  
  1130. 4.7.10          Kermit host
  1131.         If this option is turned on, the host  Kermit is assumed to be
  1132.         in server mode. You will be prompted  for file names  when you
  1133.         request a Kermit receive, and  this  file  name  will  be sent
  1134.         to the server in form of a Kermit GET command.
  1135.  
  1136. 4.7.11          Kermit 1k blocks
  1137.         Will set the Kermit packet length to 1024 bytes and set 16-bit
  1138.         CRC block checking.  This should increase the transfer speed a
  1139.         bit.   A  packet  length of 94 will be used if this feature is
  1140.         turned  off.   Not  all  Kermit  implementations  support long
  1141.         packets.
  1142.  
  1143. 4.7.12          External XPR setup
  1144.         Select  this function if you want to change the parameters for
  1145.         the  External XPR library.  Answers yes if you want to enter a
  1146.         init  string  with options that should be used by the External
  1147.         XPR   library.    Please   refer   to   the  external  library
  1148.         documentation  for a list of valid commands or parameters.  If
  1149.         you answer no, this function asks the External XPR library for
  1150.         a  "query".   The  library  will  then  display  the different
  1151.         options  that  can  be  set and their default values.  You may
  1152.         of course change the options as you like.
  1153.  
  1154. 4.7.13          Create icons
  1155.         Turn  this  option  on if you want NComm to create an icon for
  1156.         all files that you download.
  1157.  
  1158. 4.7.14          File comments
  1159.        If  this option has been selected, NComm will add a filenote to
  1160.        the  file after a download. The filenote consists of either the
  1161.        boardname  or  the telephone-number to the board where the file
  1162.        was  collected  from. The filenote may for example be displayed
  1163.        with the CLI "list" command.
  1164.  
  1165. 4.7.15          Transfer bar
  1166.         Turn  this  option  on  if  NComm  should  display a download/
  1167.         upload bar when transferring files.
  1168.  
  1169. 4.8 Server Commands
  1170.         These  commands  are  only  valid when the Kermit protocol has
  1171.         been selected. XPRKermit.library must be present in LIBS:
  1172.  
  1173. 4.8.1           Kermit Finish
  1174.         Tells  a  Kermit  server  that you are done. The remote server
  1175.         will stop being a server.
  1176.  
  1177. 4.8.2           Kermit Bye
  1178.         Tells  a Kermit server that you are done; the server will exit
  1179.         and log you off the remote machine.
  1180.  
  1181. 4.8.3           Kermit CD
  1182.         Changes  the  default  directory for files sent or received by
  1183.         the  Kermit  server.  Examples  of the directory name would be
  1184.         '/bin' or 'user:[username.amiga]'.
  1185.  
  1186. 4.9 Protocol
  1187.         Here  you select the protocol you want used for the upload and
  1188.         download functions.
  1189.  
  1190. 4.9.1           XMODEM
  1191.         This  is  the protocol originally written by Ward Christensen.
  1192.         It is used by almost every type of personal computer.  This is
  1193.         a  good  protocol  to  use  if  the line quality is poor.  Its
  1194.         biggest  drawback is that it transfers data in 128 byte blocks
  1195.         making it slower than YMODEM.
  1196.  
  1197. 4.9.2           YMODEM
  1198.         This  is  basically  XModem-CRC  with  1024 byte blocks.  This
  1199.         means  that  there  is less  handshaking,  which  saves  time.
  1200.         YMODEM is faster than  XMODEM  as  long as the line quality is
  1201.         acceptable.
  1202.  
  1203. 4.9.3           YMODEM-BATCH
  1204.         This  is  a  more  intelligent version of the YMODEM protocol.
  1205.         Multiple  files  may  be  sent  as  a packet, and the protocol
  1206.         automatically sends information about filename and filesize.
  1207.  
  1208. 4.9.4           YMODEM-G
  1209.         This is basically YMODEM-BATCH without error checking.  It may
  1210.         only   be   used   when   two   error  correcting  modems  are
  1211.         communicating  with  each  other.   Configure this with boards
  1212.         supporting MNP or ARQ. Please see above for a note about using
  1213.         this protocol with high speed modems.
  1214.  
  1215. 4.9.5           ZMODEM
  1216.         This  is  currently  one of the fastest file transfer protocol
  1217.         available.  With the Zmodem protocol, you may reach a transfer
  1218.         rate  around  1700  CPS  with  the  HST.   It  depends  on the
  1219.         XPRZmodem.library,  which  should  be  situated  in  the LIBS:
  1220.         directory.   A  file is normally sent in 1024 byte blocks, but
  1221.         this  changes  depending  on  the  system performance and line
  1222.         quality.   The  reason for its outstanding performance is that
  1223.         it  uses continuous data-streaming, and doesn't wait for an OK
  1224.         from the remote system before sending the next block.  This is
  1225.         not only a fast method to transfer data, but is also necessary
  1226.         on packet networks.
  1227.  
  1228. 4.9.6           KERMIT
  1229.         This  is  a  protocol that is widely used on many old machines
  1230.         and  network  systems.   It  depends on the XPRKermit.library,
  1231.         which  should be situated in the LIBS:  directory.  Due to the
  1232.         small  blocks  sent/received,  kermit is a quite slow protocol
  1233.         but  is  *very*  reliable and works with just about any system
  1234.         configuration,  independent  of handshaking and number of data
  1235.         bits.   Some  implementations of Kermit support compression of
  1236.         the transferred data.
  1237.  
  1238. 4.9.7           EXTERNAL XPR
  1239.         Use  this  function for selecting an external XPR protocol.  A
  1240.         file  requester  will  list  the libraries that are available.
  1241.         Simply double-click on the library name to select it.
  1242.  
  1243. 4.9.8           COMPUSERVE-B
  1244.        This  command  selects the external Compuserve Quick-B library.
  1245.        The library "xprquickb.library" must exist in your libs: dir.
  1246.  
  1247. 4.9.9           JMODEM
  1248.        This  command  selects the external Jmodem library. The library
  1249.        "xprjmodem.library" must exist in your libs: directory.
  1250.  
  1251. 4.10 Default directory
  1252.         Here  you  may  specify  the default paths and directories for
  1253.         uploading  and  downloading,  or  change  the path for the log
  1254.         file.   A  file  requester  will  appear,  select  a  path and
  1255.         directory  and  click  on the OK gadget when you are satisfied
  1256.         with your selection.  NComm will default to these directories,
  1257.         but  as  long as you are not using the G & R protocol, you may
  1258.         change  the  path  and  directory yourself before an upload or
  1259.         download.
  1260.  
  1261.         It  may be wise to set these directories to RAM: for fast file
  1262.         transfers, since transferring to disk causes a delay.
  1263.  
  1264.         NOTE: The  "Trap List" option tells the traplist.library where
  1265.         your FIDO traplist is situated  (the trap list is a version of
  1266.         the  standard nodelist that has been processed by the traplist
  1267.         program). It will default to "NODELIST:".
  1268.  
  1269. 4.11 Load scrollback buffer
  1270.         Use  this  function  if you want to load a text file into the
  1271.         scrollback buffer.  A file requester will appear on screen.
  1272.  
  1273. 4.12 Save scrollback buffer
  1274.         Use  this  function  if you want to save what is stored in the
  1275.         scrollback buffer.  A file requester will appear on screen.
  1276.  
  1277. 4.13 View scrollback buffer
  1278.  
  1279.         This   function   will   bring  up  a  window  containing  two
  1280.         proportional  gadgets  and two line-by-line gadgets.  By using
  1281.         these  gadgets,  you may view what is stored in the scrollback
  1282.         buffer  and perhaps see if it is worth saving.  The scrollback
  1283.         bytesize  will  be  displayed in the window header, as well as
  1284.         the  current  buffer position and number of lines.  The cursor
  1285.         keys may also be used for moving around;
  1286.  
  1287.                   Up - One line up
  1288.                 Down - One line down
  1289.                 Left - Move half a page to the left
  1290.                Right - Move half a page to the right
  1291.  
  1292.             Shift-Up - Step one page up
  1293.           Shift-Down - Step one page down
  1294.           Shift-Left - Beginning of buffer
  1295.          Shift-Right - End of buffer
  1296.  
  1297.         Text  may  be  marked by first clicking on the first character
  1298.         that you want to mark and then clicking on the last character.
  1299.         Click twice at the same character to remove all marks.
  1300.  
  1301.         Some hotkeys are supported;
  1302.  
  1303.                 "F" - Search in buffer
  1304.                 "N" - Next occurence of string
  1305.                 "L" - Load scrollback
  1306.                 "S" - Save scrollback
  1307.                 "B" - Save block
  1308.                 "Z" - Zoom/expand window
  1309.  
  1310.           Space bar - Paste block to serial port
  1311.  
  1312.         Press the CloseGadget or ESCape to close  the  window.  Please
  1313.         note  that  the scrollback will slow down when using a 8 or 16
  1314.         colour screen.
  1315.  
  1316. 4.14 Search in buffer
  1317.         This  function  search  for a string in the scrollback buffer,
  1318.         and  marks  the  line  if  found. Enter the string you want to
  1319.         search for in the string requester that pops up.
  1320.  
  1321. 4.15 Save marked block
  1322.         Select  this  function  if  you want to save the contents of a
  1323.         marked  block  onto  a  file.  A file requester will appear on
  1324.         screen, asking you for path and filename.
  1325.  
  1326. 4.16 Send marked block
  1327.         Select  this  function  if  you want to send the contents of a
  1328.         marked block in the scrollback to the serial port.
  1329.  
  1330. 4.17 Disable adding
  1331.         By  turning this option on, you temporarily disable the adding
  1332.         of  characters  to the scrollback. Turn the adding on again by
  1333.         selecting this function once again.
  1334.  
  1335. 4.18 Clear Scrollback
  1336.         This  command  will  clear  the scrollback buffer. Use it with
  1337.         great care as it will not ask for confirmation.
  1338.  
  1339. CHAPTER 5: COMMANDS IN SERIAL MENU
  1340.  
  1341. 5.1  Serial  device  parameters  are changed here. The serial settings
  1342.      are completely independent of the settings in preferences.
  1343.  
  1344. 5.2 Baud
  1345.         Baud  rates  from  300  to 115200  baud can be selected.  This
  1346.         entry,  however, may be overridden by the default baud rate in
  1347.         the phonebook.
  1348.  
  1349.         IMPORTANT !!!  Do  NOT  use baud rates above 31500 baud with a
  1350.         standard Amiga (68000/10 processor). The processor is too slow
  1351.         for  handling  these  speeds,  and  the  serial  hardware will
  1352.         therefore  discard  most  of  the  characters received via the
  1353.         serial  port.  Some  68020  cards  also  have  problems   when
  1354.         operating at high speeds.
  1355.  
  1356.         Note:
  1357.         This  selects  the  serial  speed of the port, the actual data
  1358.         throughput  rate  depends  upon  whether the capture buffer is
  1359.         active,  if  printer  capture  is selected, if a scrollback is
  1360.         used  and  upon the screen I/O speed.
  1361.  
  1362.         With  no printer or file capture,  the throughput rate depends
  1363.         on  the  screen I/O speed. If you select a baud  rate  greater
  1364.         than  2400  baud,  you  may lose characters unless handshaking
  1365.         is being used.
  1366.  
  1367.         If  you  own  a  68030  machine and use the program CpuBlit by
  1368.         Eddy Carroll,  the screen I/O will stick with much higher baud
  1369.         rates. CpuBlit  also  removes the flashing seen when scrolling
  1370.         color text. It is highly recommended that you use CpuBlit.
  1371.  
  1372.         Also  note:  the  1200/75  baud option will only work with the
  1373.         internal serial port since it jumps directly on the hardware.
  1374.  
  1375. 5.3 Data Length
  1376.         Selects  the  length  of  a  data  word  as 7 or 8 bits.  Most
  1377.         computer systems today will operate with 8 bits.
  1378.  
  1379.         Note  that during binary transfers, serial port data length is
  1380.         set   to  8  bits  and  restored  to  the  previous  value  on
  1381.         completion.
  1382.  
  1383. 5.4 Parity
  1384.         Selects  NO, ODD,  EVEN, MARK or SPACE parity. Most computer
  1385.         systems today will operate with NO parity.
  1386.  
  1387.         Note  that  during binary transfers, serial port parity is set
  1388.         to NO parity and restored to the previous value on completion.
  1389.  
  1390. 5.5 Stop Bits
  1391.         Selects  the  number  of stop bits transmitted as 1 or 2 bits.
  1392.         Most computer systems today will operate with 1 stop bit.
  1393.  
  1394.         Note that during binary transfers, serial port stop bit length
  1395.         is  set  to  1  bit  and  restored  to  the  previous value on
  1396.         completion.
  1397.  
  1398.         The  Amiga hardware does not allow 2 stop bits to be used with
  1399.         an 8 bit data word length.
  1400.  
  1401. 5.6 Duplex
  1402.         Selects  whether  NComm  or  the remote system should echo key
  1403.         strokes to the screen.
  1404.  
  1405. 5.6.1   Select  FULL duplex when the remote machine will echo your key
  1406.         strokes.  You will normally be using this option.
  1407.  
  1408. 5.6.2   Select  HALF  duplex when the remote system does not echo your
  1409.         key  strokes.   That  is  when  the  remote system seems to be
  1410.         responding  to  your commands, but you cannot see what you are
  1411.         typing.
  1412.  
  1413. 5.7 Handshaking
  1414.         Enables  or  disables the serial driver check for flow control
  1415.         characters.
  1416.  
  1417. 5.7.1   Select 'None' when you do not wish to use flow control.
  1418.  
  1419. 5.7.2   Select 'XON/XOFF' when you wish the driver to use the XON/XOFF
  1420.         type  of  flow  control.   Normally this is used at baud rates
  1421.         greater than 2400 baud to avoid losing characters.
  1422.  
  1423. 5.7.3   Select  'RTS/CTS' when you wish the driver to use the hardware
  1424.         RTS/CTS  type  of flow control.  This should only be used with
  1425.         modems which support it.
  1426.  
  1427.         Note:
  1428.         In  some  cases, when the XON/XOFF mode is selected, NComm may
  1429.         receive an XOFF character ( noise or otherwise ) and appear to
  1430.         be hung -- that is, no characters appear on the screen yet the
  1431.         menus  still  function properly.  Whenever NComm appears to be
  1432.         hung,  typing  a Ctrl-Q will re-start the serial line.  If the
  1433.         problem  was  due  to  an  XOFF  character received, this will
  1434.         restore everything to normal.
  1435.  
  1436. 5.8 Set Device
  1437.         If  you are using something else than the inbuilt serial port,
  1438.         this  function  makes it possible to change the type of serial
  1439.         device  used  for  this  port. A string requester will pop up,
  1440.         asking you for the name of the new device.
  1441.  
  1442. 5.9 Set Unit
  1443.         If  you are using something else than the inbuilt serial port,
  1444.         this  function  makes it possible to change the number of the
  1445.         unit   used  for  this  port.  A number requester will pop up,
  1446.         asking you for the number of the new unit.
  1447.  
  1448. 5.10 Set Adjust Factor
  1449.         Some  versions of the serial.device miscalculate the baud rate
  1450.         by 1.1% and may therefore either slow transfers down, or cause
  1451.         errors. If  you  experience  such problems,  try  setting  the
  1452.         adjust factor to -11 (it should normally be set to zero)
  1453.  
  1454. 5.11 Shared Mode
  1455.         If another program is using the serial port, NComm will not be
  1456.         able  to  open  the  serial.device.  Setting the "Shared mode"
  1457.         option   allows  NComm  to  share the serial port with another
  1458.         program.  The disadvantage is that CTS/RTS handshaking can not
  1459.         be used when sharing the serial port.
  1460.  
  1461. 5.12 Send Break
  1462.         Sends a 250 ms break signal.
  1463.  
  1464. 5.13 Lock Serial
  1465.         This  function  is  meant  to  be  used with the UUCP function
  1466.         "getty".  If selected, this function will lock the serial port
  1467.         when  starting  NComm and unlock the port when quitting.  This
  1468.         tells "getty" that the port is busy and not available.
  1469.  
  1470. 5.14 Set 75bps delay
  1471.         This function sets the delay between bits that are sent to the
  1472.         serial  port when using the 1200/75 baud (split speed) option.
  1473.         12100  uS  is known to work well with an A3000/25 and AmigaDOS
  1474.         2.0,  while  10700  uS  is  probably the preferred value for a
  1475.         stock Amiga 500/1000/2000.
  1476.  
  1477. CHAPTER 6: COMMANDS IN TRANSLATE MENU
  1478.  
  1479. 6.1  This is where you define the translation of out- and ingoing data
  1480.      and the special keyboard keys.
  1481.  
  1482. 6.2  End of Line
  1483.         You  can  select how End of Line characters are handled on the
  1484.         screen  and when sent out the serial port.  By default, EOL is
  1485.         just  a  CARRIAGE RETURN character, but you can change this to
  1486.         CR  and  LINEFEED pairs.  Use this option if all text seems to
  1487.         be printed on one line.
  1488.  
  1489. 6.3  Character set
  1490.         NComm offers twelve different translation tables, and they can
  1491.         be  selected  here.  Please  observe  that you have to use the
  1492.         'CLI'  SETMAP  command  to  be  able  to  write  your national
  1493.         characters correctly.
  1494.  
  1495. 6.3.1           ISO
  1496.         NComm  will  use the standard Amiga character set, without any
  1497.         translation.  This  should  be  used when using Amiga systems,
  1498.         and will only work in 8N1.
  1499.  
  1500.         Please  note;  if no translation of the in or outgoing data is
  1501.         wanted  when  using  the  ASCII  capture or ASCII send option,
  1502.         switch to ISO before transfer.
  1503.  
  1504. 6.3.2           IBM
  1505.         Should  be  used  with  bulletin  boards  running on PC/MS-DOS
  1506.         machines  that use the IBM extended character set.  NComm will
  1507.         utilize  a  special  IBM  font  containg  all  the IBM graphic
  1508.         characters. This will only work in 8N1.
  1509.  
  1510. 6.3.3           IBN
  1511.         Should  be  used  with  Norwegian  bulletin  boards running on
  1512.         PC/MS-DOS  machines  that  use the IBM extended character set.
  1513.         This  is  a  version  of  the  character set that contains two
  1514.         norwegian   characters  that  are  missing  in  IBMs  original
  1515.         character   set.   NComm  will  utilize  a  special  IBM  font
  1516.         containing  all  the  IBM  graphic characters.  This will only
  1517.         work in 8N1.
  1518.  
  1519. 6.3.4           IBP
  1520.         Should  be  used  with  Portuguese bulletin  boards running on
  1521.         PC/MS-DOS  machines  that  use the IBM extended character set.
  1522.         This  is  a  version  of  the character set that contains some
  1523.         special   Portuguese  characters  that  are  missing  in  IBMs
  1524.         original character set.  NComm will utilize a special IBM font
  1525.         containing  all  the  IBM  graphic characters.  This will only
  1526.         work in 8N1.
  1527.  
  1528. 6.3.5           NO7
  1529.         Use this option when the host uses
  1530.         the Norwegian ISO 7 bit standard.
  1531.  
  1532. 6.3.6           US7
  1533.         Use this option when the host uses
  1534.         the American ISO 7 bit standard.
  1535.  
  1536. 6.3.7           UK7
  1537.         Use this option when the host uses
  1538.         the English ISO 7 bit standard.
  1539.  
  1540. 6.3.8           GE7
  1541.         Use this option when the host uses
  1542.         the German ISO 7 bit standard.
  1543.  
  1544. 6.3.9           FR7
  1545.         Use this option when the host uses
  1546.         the French ISO 7 bit standard.
  1547.  
  1548. 6.3.10          SP7
  1549.         Use this option when the host uses
  1550.         the Spanish ISO 7 bit standard.
  1551.  
  1552. 6.3.11          IT7
  1553.         Use this option when the host uses
  1554.         the Italian ISO 7 bit standard.
  1555.  
  1556. 6.3.12          SF7
  1557.         Use  this  option when the host uses
  1558.         the Swedish/Finnish ISO 7 bit standard.
  1559.  
  1560. 6.3.13          DE7
  1561.         Use this option when the host uses
  1562.         the Danish ISO 7 bit standard.
  1563.  
  1564. 6.4 DEL <-> BS
  1565.         Here  you may configure whether the backspace and del keys are
  1566.         to be exchanged.  This can be useful when communicating with a
  1567.         machine that runs Unix, VMS or Tops-20, amongst others.
  1568.  
  1569. 6.5 Show HEX chars
  1570.         This  option  will translate all incoming text to HEX numbers,
  1571.         as  well  as  displaying  the  text to the right.  Perfect for
  1572.         debugging.
  1573.  
  1574. 6.6 ANSI mouse
  1575.         If  this  option is turned on, mouse clicks will be translated
  1576.         into  ANSI  codes that move you to the current mouse position.
  1577.         The codes will be sent out to the serial port.
  1578.  
  1579.         If you only want to activate the NComm window without sending
  1580.         any ANSI codes, click in the NComm status window.
  1581.  
  1582. 6.7 ANSI capture
  1583.         ANSI escape codes will normally be filtered out when using the
  1584.         "ASCII capture" function.  Turn  this option on if you want to
  1585.         leave these codes untouched when doing an ASCII capture.
  1586.  
  1587. 6.8 Destructive Backspace
  1588.         Incoming  "backspace" codes will normally just move the cursor
  1589.         one  position  to  the  left.  Turn this option on if you want
  1590.         NComm to delete the character to the left of the cursor.
  1591.  
  1592. 6.9 Pad out blank lines
  1593.         Most  line editors used by bulletin boards enter the "command"
  1594.         prompt  when  RETURN  is  pressed  on  a  blank  line. This is
  1595.         normally not desirable when doing an "ASCII send".  By turning
  1596.         this option on,  NComm will always send a blank (SPACE) before
  1597.         sending  RETURN  on  a  new  line  when using the "ASCII send"
  1598.         function.
  1599.  
  1600. CHAPTER 7: COMMANDS IN SCREEN MENU
  1601.  
  1602. 7.1  This  is  where  you  may  configure what your screen should look
  1603.      like.
  1604.  
  1605. 7.2  Title bar
  1606.         Toggles the title bar on and off
  1607.  
  1608. 7.3  Interlace
  1609.         This  option  will  make NComm use an interlaced screen, which
  1610.         will double the vertical resolution but cause a lot of flicker
  1611.         if   you  haven't  invested  in  a  flicker-fixer  card  or  a
  1612.         long-persistance monitor.
  1613.  
  1614. 7.4  Colours
  1615.         From here you may choose whether NComm shall use a 2, 4, 8  or
  1616.         16  colour  screen.  If  you  choose  the  eight  colour mode,
  1617.         you  will  get  full ANSI colour emulation.  The 16 color mode
  1618.         will  set  up  NComm  for  extended  ANSI  emulation, but will
  1619.         slow  down  the  program  a  lot.  See  chapter  5.2  for more
  1620.         information about this.  Choose the two or four colour mode if
  1621.         you prefer faster screen updates.
  1622.  
  1623. 7.5  Palette
  1624.         This  will  bring  up  a requester that lets you configure the
  1625.         colours for the current screen mode.  Each screen mode has its
  1626.         own  palette.  Click 'RESET' to use the colours that NComm was
  1627.         shipped with.  To edit a color, click in the color box and use
  1628.         the slider gadgets.
  1629.  
  1630. 7.6  Split Screen
  1631.         This function will divide the screen into two windows, a small
  1632.         one  (  4 lines ) for your typed characters and a larger one (
  1633.         19  lines  when  using  NTSC) for characters received from the
  1634.         modem.
  1635.  
  1636.         You  should  select the half-duplex mode on the host system to
  1637.         prevent  your typed characters from being echoed back into the
  1638.         receive  window.  To exit the split screen mode, select 'Split
  1639.         Screen' from the menu again.
  1640.  
  1641.         Split  screen  mode requires at least 1MB of memory to operate
  1642.         in interlaced mode.
  1643.  
  1644.         Caution:
  1645.         If  you login to a system while in the split screen mode, your
  1646.         password will be echoed in the TX window.  It is best to login
  1647.         in the single screen mode.
  1648.  
  1649. 7.7  Style
  1650.         This  function allows you to turn on or off the translation of
  1651.         the  different  styles (boldface, italics and underline).  The
  1652.         reason  why  this function was included is that the styles are
  1653.         misused  by many bulletin board systems.  The text will appear
  1654.         clearer, and this will also reduce flashing when the screen is
  1655.         scrolling.
  1656.  
  1657. 7.8  Bell
  1658.         From  here  you  can  configure  what  NComm should do when it
  1659.         receives  the  ASCII  "bell"  code.   You can have an ordinary
  1660.         audible   bell   or   a   visible   bell.  You may even select
  1661.         'ScreenToFront',  which  will  bring the NComm screen to front
  1662.         when  the  "bell"  code  is  received.  You may freely mix the
  1663.         three or turn bell off.
  1664.  
  1665. 7.9  Cursor blink
  1666.         Some  people  prefer  having  a blinking cursor, especially if
  1667.         they are used to the IBM Personal Computer. This function will
  1668.         try to emulate cursor blinking.
  1669.  
  1670. 7.10 Reset
  1671.         This  function  will  clear  the  screen,  turn  off all style
  1672.         settings and reset the colours.
  1673.  
  1674.  
  1675. 7.11 Workbench screen
  1676.         Use  this  function for placing NComm on the Workbench screen.
  1677.         This  will  also save a small amount of memory.  OS 2.0 gadget
  1678.         flags will be set if used.
  1679.  
  1680. 7.12 Close Workbench screen.
  1681.          If you want to save a small amount of memory,  you may choose
  1682.          to close the Workbench screen with this function. Please note
  1683.          that no programs or CLI's can be open on the Workbench screen
  1684.          when this function is selected.
  1685.  
  1686. 7.13 OS 2.0 snapping
  1687.          (Only selectable if using OS 2.0) This function lets you snap
  1688.          text  from  the NComm terminal screen using the Right-Amiga-C
  1689.          key  combination.  Use  Right-Amiga-V for pasting text to the
  1690.          terminal screen.
  1691.  
  1692. 7.14 Force 80 x 24
  1693.         This option that forces a window that is 80 character wide and
  1694.         24  characters  high  (80  x 24).  Some bulletin board systems
  1695.         seem to require such a display.
  1696.  
  1697. 7.15 Flashing text
  1698.         If  this  option has been turned on, text will be displayed as
  1699.         "flashing"  if  ESC[5m  is  received.  If this option has been
  1700.         turned off, the text will be displayed in italics if the style
  1701.         command  has  been  turned  on.   This  function uses an extra
  1702.         bitplane  for  flashing the text so the text display will slow
  1703.         down a little when this function has been enabled.
  1704.  
  1705. 7.16 Line Wrap
  1706.         If  this option has been turned off, text will not move to the
  1707.         next  line when hitting the right edge of the window.  This is
  1708.         according to the VT220 specs, so normally this function should
  1709.         be turned off.
  1710.  
  1711. 7.17            Window Gadgets
  1712.                 --------------
  1713.      The  screen contains hidden gadgets for depth arranging the NComm
  1714.      window.  The depth gadgets are in the upper right hand corner.
  1715.  
  1716. 7.18 NComm  supports  OverScan.  If  you  are  using  OverScan  on the
  1717.      WorkBench  screen,  NComm  will  automatically open the screen in
  1718.      overscan mode when starting NComm.
  1719.  
  1720. CHAPTER 8: COMMANDS IN PHONE MENU
  1721.  
  1722. 8.1  From   here  you  may  dial  phonenumbers,  edit  the  phonebook,
  1723.      configure the modem and redial, or hang up the phone.
  1724.  
  1725. 8.2 Phonebook
  1726.         This  entry  will bring up the phonebook window, where you may
  1727.         load  or  save  phonebooks,  as  well  as edit, delete and add
  1728.         entries.  The  entries can also be sorted, dialled or printed.
  1729.  
  1730.         When   loaded,   NComm   first   looks   for   a  file  called
  1731.         NComm:NComm.phone.  If not found, the phonebook will be blank.
  1732.  
  1733.         The  phonebook  can consist of an unlimited number of entries,
  1734.         but  only the first 46 will be displayed in the DIAL menu, and
  1735.         only the first 10 can be dialled using hot keys.
  1736.  
  1737.         Only 15 entries can be displayed simultaneously in the window.
  1738.         To scroll through the phonebook, use the right drag bar.
  1739.  
  1740.         You  may select an entry by positioning the  pointer  over  it
  1741.         and then clicking  on the  left mouse button. When an entry is
  1742.         selected,  it  will show up in reverse video.  Several entries
  1743.         can be selected at the same time.
  1744.  
  1745. 8.2.1   Selecting  the  'Dial!'  gadget will dial the entries that are
  1746.         selected,  starting  at  the  top.  This will bring up a small
  1747.         window telling you which board you are calling, and eventually
  1748.         which  is  the  next  to  go.   The  phonebook  window will be
  1749.         removed.    More  entries  can  be  added  while  dialling  by
  1750.         selecting  them  from  the  DIAL  menu,  or by bringing up the
  1751.         phonebook again.
  1752.  
  1753.         If  a  number is busy, the program will continue with the next
  1754.         number  on the list.  If redial has been turned on, NComm will
  1755.         start  over  again if no connection has been established or an
  1756.         "invalid"  result  code is received (this depends on the 'Max'
  1757.         settings  in  the  modem setup menu.  The default action is to
  1758.         abort when an error code is received.)
  1759.  
  1760.         Abort  the  dialling  by  pressing  the ESC key or closing the
  1761.         window  by  clicking  in the upper lefthand gadget.  To remove
  1762.         the  current entry, press the DEL key.  Press the SPACE key if
  1763.         you would like to go on with the  next  entry.  You  may  also
  1764.         click within the window gadgets.
  1765.  
  1766. 8.2.2   Selecting  the  'Edit'  gadget  will bring up the edit window,
  1767.         containing  the  information  about  the first entry selected.
  1768.         This  information  can  then  be  edited.   See below for more
  1769.         information  about  how  to use the edit window.  Pressing the
  1770.         'OK'  gadget  will  accept the edit and display the next entry
  1771.         that  is  selected  (if  any),  'Cancel' will leave everything
  1772.         unchanged.
  1773.  
  1774. 8.2.3   Selecting  the  'New'  gadget will add a new entry in front of
  1775.         the  first  entry  selected.   However,  if  no entry has been
  1776.         selected,  the entry will be placed at the bottom of the list.
  1777.         This  will bring up a special edit window  that  contains  the
  1778.         current  NComm settings.  See below for more information about
  1779.         how to use the edit window.  Pressing the 'OK' gadget will add
  1780.         the  current  entry,  'Cancel' will abort the edit and not add
  1781.         the entry.
  1782.  
  1783. 8.2.4   The 'Swap' command  swaps to entries. Click on two entries and
  1784.         then on 'Swap' if you want them to change place.
  1785.  
  1786. 8.2.5   Selecting  the 'Load' gadget will bring up a file requester in
  1787.         the  center  of  the  screen.   For instructions on how to use
  1788.         this, see "The file input-requester" above.  From here you may
  1789.         load  a new phonebook.  Remember to save the current phonebook
  1790.         if  any  changes  have been made.  Entering "NComm.phone" will
  1791.         load the phonebook that is normally loaded at startup.
  1792.  
  1793. 8.2.6   Selecting  the 'Save' gadget will bring up a file requester in
  1794.         the  center  of  the  screen.   For instructions on how to use
  1795.         this, see "The file input-requester" above.  From here you may
  1796.         save  the  current phonebook.  Enter the name "NComm.phone" if
  1797.         you want the phonebook to be loaded at startup.
  1798.  
  1799. 8.2.7   Selecting the 'Delete' gadget will delete the entries that are
  1800.         currently selected.
  1801.  
  1802. 8.2.8   Selecting  the  'Sort'  gadget  will sort the phonebook.  If a
  1803.         entry  has  been  selected,  the  function  will only sort the
  1804.         entries between this entry and down.  If multiple entries have
  1805.         been selected, the function will only sort the entries between
  1806.         the top and lower entry.
  1807.  
  1808.         This  can  be handy if you are using hot keys to dial numbers,
  1809.         and  don't  want the upper entries mixed with entries that are
  1810.         lower  on  the  list, or if you prefer using the DIAL menu for
  1811.         dialling  entries and don't want entry 45 and down to be mixed
  1812.         with the upper entries.
  1813.  
  1814. 8.2.9   Selecting  the  'Print' gadget will print the phonebook. Enter
  1815.         the name of the file in the  righthand  text  gadget,  or  use
  1816.         "PRT:" if you want output sent to the printer. If  no  entries
  1817.         are selected, the whole phonebook will be printed. Else,  only
  1818.         the entries selected will be printed.
  1819.  
  1820. 8.2.10  The  'Clr/Mark'  gadget is a combined "Mark All" / "Clear All"
  1821.         function.   If  any  entries have been selected, this function
  1822.         will  deselect all entries.  If no entries have been selected,
  1823.         this function will mark all entries.
  1824.  
  1825. 8.3 Dial #
  1826.         This  requester  will dial a number which is not listed in the
  1827.         phonebook.  If redial has been turned on, the program will try
  1828.         reaching  the  number until connection has been established or
  1829.         an  "invalid"  result  code  is  received (this depends on the
  1830.         'Max' settings in the modem setup menu.  The default action is
  1831.         to abort when an error code is received.) This function can be
  1832.         used  together with the dial queue.  If you want to enter more
  1833.         than one number, seperate the numbers with a '|'...
  1834.  
  1835.         If the traplist.library is available in your LIBS:  directory,
  1836.         you  may  enter  a  nodenumber  f.ex.  "2:502/15" instead of a
  1837.         number.   NComm will automatically look for the number in your
  1838.         traplist file.
  1839.  
  1840. 8.4 Hang up
  1841.         Selecting  this  entry  will send the HANGUP command string to
  1842.         the modem (or lower DTR if DTR-hangup has been selected).
  1843.  
  1844. 8.5 Redial
  1845.         By configuring this option, NComm will try over and over again
  1846.         when a board you are calling is busy. This setting may however
  1847.         be overridden by the 'Max Busy' field in the modem setup menu.
  1848.         NComm  will  then abort the redial if it reaches the specified
  1849.         number of 'Busy' messages.
  1850.  
  1851. 8.6 Modem setup
  1852.         Within  this  requester  you may configure the things that are
  1853.         sent and received by the modem, and how long NComm should wait
  1854.         before  redialling.   Simply click in the text gadgets to edit
  1855.         them. The  setup  strings  can  contain the control characters
  1856.         listed under the explanation of 'macrokeys'. Most text gadgets
  1857.         have  a  "Max"  field  that  adjusts NComm's toleranse for the
  1858.         codes.
  1859.  
  1860. 8.6.1   The  'initialization  string'  will  be sent to the modem soon
  1861.         after  NComm opens the serial device and before keyboard input
  1862.         is  accepted.   It  can be left blank, but remember that NComm
  1863.         requires  'echo'  from  the  modem,  so  it  can  be clever to
  1864.         configure  this here.  This can be accomplished by the 'AT E1'
  1865.         command if your modem is Hayes compatible.
  1866.  
  1867.         You  must  also set your modem to detect the BUSY signal if it
  1868.         has got such a feature.  If you have problems configuring your
  1869.         modem,  the 'AT &F\n' line will load the factory configuration
  1870.         on  Hayes compatibles.  This configuration is usually accepted
  1871.         by NComm.
  1872.  
  1873. 8.6.2   The  'exit  string'  is  sent just before the serial device is
  1874.         closed, when exiting NComm.  It is normally left blank.
  1875.  
  1876. 8.6.3   'Dial  prefix'  is  the  command  to  be  inserted  before the
  1877.         phonenumber.   For  Hayestype  modems, this should be ATDT (or
  1878.         ATDP  for  pulse  dial).  NOTE:  NComm  does  not  yet support
  1879.         multiple dial strings but this problem can easily be solved by
  1880.         using  'AT'  as the dial prefix and entering the modem options
  1881.         followed by 'DT' in front of the phonebook telephone numbers.
  1882.  
  1883. 8.6.4   'Dial suffix' is the string to be added after the phonenumber.
  1884.         For  Hayestype  modems, this should be '\n', which will send a
  1885.         carriage return.
  1886.  
  1887. 8.6.5   'Hang-up  string' is the string to be sent when you choose the
  1888.         Hangup   function.   For  Hayestype  modems,  this  should  be
  1889.         '\w\w+++\w\w\w\wATH\n'  (Wait  1 sec  +++  Wait 2 sec ATH CR).
  1890.         This code is ignored if you are using the DTR-hangup option.
  1891.  
  1892. 8.6.6   The  'connect  string'  is the string sent from the modem when
  1893.         you  get  connected  to  a  board.  For Hayestype modems, this
  1894.         string  should  be  'CONNECT'. This code is ignored if you are
  1895.         using hardware CARRIER detection.
  1896.  
  1897. 8.6.7   The 'disconnect string' is the string sent from the modem when
  1898.         a  call  has ended.  This string is also sent if the modem was
  1899.         not able to establish a connection with the remote modem.  For
  1900.         Hayestype modems, this should be 'NO CARRIER'.
  1901.  
  1902.         The "Max NoCarrier" field defines how many NO CARRIER messages
  1903.         that  are  accepted  by NComm before it removes the entry from
  1904.         the  dial  queue.   If  the max field is set to zero (0) NComm
  1905.         will  not  remove  the  entry from the list but dials the next
  1906.         number  instead.   Otherwise  NComm will remove the entry from
  1907.         the  dial  queue after  x NO CARRIER messages (x is the number
  1908.         specified in the gadget).
  1909.  
  1910. 8.6.8   The  'busy  string' is the string sent from the modem when the
  1911.         phone  is  busy.   For  Hayestype modems this string should be
  1912.         'BUSY',  but  if  your  modem is having problems detecting the
  1913.         busy signal, enter this as 'NO CARRIER'.
  1914.  
  1915.         The  "Max  Busy" field defines how many BUSY messages that are
  1916.         accepted  by  NComm  before aborting the dialling.  If the max
  1917.         field  is  set to zero (0) NComm will always continue and dial
  1918.         the  next  entry.   Otherwise  NComm will abort redial after x
  1919.         BUSY messages (x is the number specified in the gadget).
  1920.  
  1921. 8.6.9   The  'voice  string'  is the string sent from the modem when a
  1922.         voice  answers  the  phone  in  the  other end.  For hayestype
  1923.         modems this string should be 'VOICE'.
  1924.  
  1925.         The "Max Voice" field defines how many VOICE messages that are
  1926.         accepted  by  NComm  before  it aborts dialling or removes the
  1927.         entry  from  the  list.   If  the max field is set to zero (0)
  1928.         NComm will abort immediately.  Otherwise NComm will remove the
  1929.         entry  from  the  dial  queue after x VOICE messages (x is the
  1930.         number specified in the gadget).
  1931.  
  1932. 8.6.10  The  'no  dialtone  string'  is the string sent from the modem
  1933.         when  the  modem  is  not  able  to  call out due to a missing
  1934.         dialtone.   For  hayestype  modems  this  string should be 'NO
  1935.         DIALTONE' but some modems return 'NO DIAL TONE' instead.
  1936.  
  1937.         The  "Max  NoDialtone"  field  defines  how  many  NO DIALTONE
  1938.         messages that are accepted by NComm before it aborts dialling.
  1939.         If  the  max  field  is  set  to  zero  (0)  NComm  will abort
  1940.         immediately.   Otherwise  NComm will abort dialling after x NO
  1941.         DIALTONE messages (x is the number specified in the gadget).
  1942.  
  1943. 8.6.11  The  'error  string' is the string sent from the modem when it
  1944.         receives an invalid command.  For hayestype modems this string
  1945.         should be 'ERROR'.
  1946.  
  1947.         The "Max Error" field defines how many ERROR messages that are
  1948.         accepted by NComm before it aborts dialling.  If the max field
  1949.         is  set  to  zero (0) NComm will abort immediately.  Otherwise
  1950.         NComm  will  abort  dialling  after x ERROR messages (x is the
  1951.         number specified in the gadget).
  1952.  
  1953. 8.6.12  The  'ringing  string'  is the string sent from the modem when
  1954.         the  phone  in  the  other  end  of  the line is ringing.  For
  1955.         Hayestype  modems  this  string  should  be 'RINGING' but some
  1956.         modems  also  return  'RING'  when the phone is ringing in the
  1957.         other end.
  1958.  
  1959.         The "Max Ringing" field defines how many RINGING messages that
  1960.         are  accepted by NComm before it dials the next entry.  If the
  1961.         max  field is set to zero (0) NComm will wait continuously for
  1962.         CONNECT.   Otherwise  NComm  will  dial the next entry after x
  1963.         RINGING messages (x is the number specified in the gadget).
  1964.  
  1965. 8.6.13  The  'no answer string' is the string sent from the modem when
  1966.         the  modem  in  the  other  end did not answer the phone.  For
  1967.         hayestype modems this string should be 'NO ANSWER'.
  1968.  
  1969.         The  "Max  NoAnswer" field defines how many NO ANSWER messages
  1970.         that  are  accepted  by NComm before it removes the entry from
  1971.         the  dial  queue.   If  the max field is set to zero (0) NComm
  1972.         will  not  remove  the  entry from the list but dials the next
  1973.         number  instead.   Otherwise  NComm will remove the entry from
  1974.         the  dial  queue  after  x NO ANSWER messages (x is the number
  1975.         specified in the gadget).
  1976.  
  1977. 8.6.14  The  'remote  ring  string'  is the string sent from the modem
  1978.         when  a person in the other end is calling you.  For hayestype
  1979.         modems   this  string  should  be  'RING\r\n'.   NComm  aborts
  1980.         dialling immediately when this message is received.
  1981.  
  1982. 8.6.15  In  the  'delay'  box  you  may specify how many seconds NComm
  1983.         should  wait  before  dialling the next number.  This delay is
  1984.         normally  set  to  '3',  but  enter  '0'  if  you have entered
  1985.         'NO CARRIER' as a BUSY string.
  1986.  
  1987. 8.6.16  If the locked baud-rate option has been turned off, NComm will
  1988.         look  for  the  number  specified  right  after  the 'CONNECT'
  1989.         message,  and  will  switch  to  that  speed.  Turn the locked
  1990.         baud-rate  option  on if you have set a constant speed between
  1991.         the  modem  and  the  machine,  or if you are certain that the
  1992.         hostmodem  supports  the  speed that you are calling at.
  1993.  
  1994.         I.e,  turn  the locked rate option on if you are using a modem
  1995.         that  has  been  set  up for use with locked baud rates (speed
  1996.         buffering).   If  you  have  turned  locked  rate  off,  it is
  1997.         important that you have told your modem to report the baudrate
  1998.         sent  after  the  'CONNECT'  message.   This is done, again on
  1999.         Hayes, with the command 'AT V1 X2'.
  2000.  
  2001. 8.6.17  DTR-hangup  will  cause  a  drop  of  the DTR signal for a few
  2002.         seconds when the hangup function is selected. This function is
  2003.         meant  to  be  used  with dumb modems (modems that do not have
  2004.         some sort of a command language).
  2005.  
  2006. 8.6.18  In the 'loop delay' box you may specify how many seconds NComm
  2007.         should  wait  before  repeating  the  dial  loop.  This  delay
  2008.         should normally be set to '0'.
  2009.  
  2010. 8.6.19  The  'CD checking' option switches the hardware CARRIER detect
  2011.         option  on  or off.  The hardware method is more reliable than
  2012.         just  looking  for  the NO CARRIER string (if it shows up in a
  2013.         message, NComm will assume that the call has ended).
  2014.  
  2015.         NOTE:   Your  modem  must track TRUE CARRIER.  This means that
  2016.         the DCD signal must be "low" (off) in command state and should
  2017.         not go "high" (on) until a connection has been established.
  2018.  
  2019. 8.6.20  The  'ignore echo' option turns off the "Modem not responding"
  2020.         checking.   Note:   Normally  this  is a fatal error and means
  2021.         that  your  modem did not respond to the command that was sent
  2022.         by  NComm.  Please check your complete modem setup rather than
  2023.         just turning off this option.
  2024.  
  2025. 8.6.21  Pressing  the  'OK' gadget will accept the edit, 'Cancel' will
  2026.         leave everything unchanged.
  2027.  
  2028. 8.7     Redial at logoff
  2029.         ----------------
  2030.         If  this  option  if  turned on, NComm will start dialling the
  2031.         rest  of  the  boards that are selected in the phonebook after
  2032.         logging  out  from  the  current  system.  NComm automatically
  2033.         deselects boards in the PhoneBook when you connect to them.
  2034.  
  2035. 8.8     Edit window
  2036.         -----------
  2037.         The  edit  window  contains seven text  input  boxes and eight
  2038.         gadgets.
  2039.  
  2040. 8.8.1   In  the  text  input  box marked 'Name', enter the name of the
  2041.         board.
  2042.  
  2043.         The  name  can  be up to 40 characters long, however, only the
  2044.         first  17  characters  will  be displayed in the dial menu and
  2045.         window, and in the logfile.  You can not leave this empty.
  2046.  
  2047. 8.8.2   In  the text input box marked 'Phone #', enter the phonenumber
  2048.         to  the current board.  The phonenumber can be up to 60 digits
  2049.         long.   If  a board has multiple numbers, enter them separated
  2050.         by  the  '|' character, for example "416588|410403".  Only the
  2051.         first  17 characters will be displayed in the dial window, and
  2052.         in the logfile.  This field can not be omitted.
  2053.  
  2054.         If  traplist.library  is available in your LIBS: directory you
  2055.         may enter a FIDO nodenumber instead of the phonenumber.
  2056.  
  2057. 8.8.3   In  the  text  input  box  marked 'Comment', enter an optional
  2058.         comment,  like  when  the board is open, what the main purpose
  2059.         with  the  board  is,  if MNP is available or which speeds are
  2060.         available.  The comment can be 40 characters long.
  2061.  
  2062. 8.8.4   In  the  text  input  box marked 'Config', you may specify the
  2063.         name  of  an  optional  configuration  file.   The filename is
  2064.         relative  to  the  current  directory.  It will be loaded just
  2065.         after  dialling.   The  colors,  screen mode and menu settings
  2066.         will   be   changed  back  to  the  way  they  were  when  the
  2067.         configuration  file  was  saved.   The phonebook settings have
  2068.         higher  priority  than the settings found in the configuration
  2069.         file.
  2070.  
  2071. 8.8.5   In  the  text  input  box marked 'Macros', you may specify the
  2072.         name  of an optional macrokeys file.  The filename is relative
  2073.         to  the  current  directory.   It  will  be  loaded just after
  2074.         dialling.
  2075.  
  2076. 8.8.6   In  the  text  input  box marked 'Script', you may specify the
  2077.         name  of  an optional scriptfile.  The filename is relative to
  2078.         the  current  directory.   It will be loaded and executed just
  2079.         after  dialling,  which  means  that the scriptfile should NOT
  2080.         contain the 'dial' command as the first entry.
  2081.  
  2082. 8.8.7   In  the  text  input  box  marked 'ARexx', you may specify the
  2083.         name  of  an  optional arexxfile.  The filename is relative to
  2084.         the  current  directory.   It will be loaded and executed just
  2085.         after  dialling,  which  means  that the scriptfile should NOT
  2086.         contain the 'dial' command as the first entry.
  2087.  
  2088. 8.8.8   In  the  text input box marked 'Password', you may specify the
  2089.         name of an optional password.  This can be handy if you prefer
  2090.         only using one scriptfile for multiple boards.  The scriptfile
  2091.         can  then  contain a 'SEND "\p\n"' command line that sends the
  2092.         password  configured  for the current board.  The password can
  2093.         also be sent by configuring '\p\n' on one of the macrokeys.
  2094.  
  2095.         Pressing  'return'  in  one of the text input boxes will bring
  2096.         the  cursor  to the text input box below the current box.  The
  2097.         cursor  will  be  brought to the top if 'return' is pressed in
  2098.         the bottom box.
  2099.  
  2100. 8.8.9   Pressing the gadget marked 'Baud rate' will multiply the board
  2101.         rate which is to be used for the board by two.  However, since
  2102.         NComm only  supports  board  rates up to 115200 baud, the baud
  2103.         rate will revert to 300 baud when this baudrate is present.
  2104.  
  2105. 8.8.10  Pressing the gadget marked 'Data length' will switch between 7
  2106.         and  8  bits  data length.  This data length will be used when
  2107.         NComm dials the board.
  2108.  
  2109. 8.8.11  Pressing  the gadget marked 'Parity' will switch between Even,
  2110.         Odd,  Mark,  Space  and None parity.  This parity will be used
  2111.         when NComm dials the board.
  2112.  
  2113. 8.8.12  Pressing  the  gadget marked 'Stop bits' will switch between 1
  2114.         and  2  stop bits.  This number of stop bits will be used when
  2115.         NComm dials the board.
  2116.  
  2117. 8.8.13  Pressing  the  gadget marked 'Duplex mode' will switch between
  2118.         Full  and  Half  duplex.   This  duplex mode will be used when
  2119.         connection is established.
  2120.  
  2121. 8.8.14  Pressing the gadget marked 'Character set' will switch between
  2122.         IBN, IBP, US7, UK7, GE7, FR7, SP7, IT7, DE7, NO7, SF7, ISO and
  2123.         IBM  translation.   If  the  IBM or IBN character set has been
  2124.         chosen,  a special IBM graphics font will be used.  ISO should
  2125.         be  used  for  Amiga  boards  only.   The other character sets
  2126.         should  be  used on machines only having a 7-bit character set
  2127.         available.    By   watching  the  first  two  letters  in  the
  2128.         translation  name,  you may easily find out which one is to be
  2129.         used  for  your country.  This character set will be used when
  2130.         connection is established.
  2131.  
  2132. 8.8.15  The 'Swap Del/BS' option will (when turned on) swap the Delete
  2133.         and Backspace key as soon as you connect to this board.
  2134.  
  2135. 8.8.16  Pressing the gadget marked 'Xfer protocol' lets you choose the
  2136.         protocol  for  use  with  this board.  Available protocols are
  2137.         Xmodem,   Ymodem,   Ymodem-Batch,  Y modem-G,  Zmodem, Kermit,
  2138.         "External XPR"  (as configured  in  the  configuration  file),
  2139.         Compuserve-B or Jmodem.
  2140.  
  2141. 8.8.17  The date at the bottom of the window shows when the board was
  2142.         last dialled.
  2143.  
  2144. CHAPTER 9: INFORMATION ABOUT DIAL MENU
  2145.  
  2146.      Use  this  menu  for  fast  dialling of entries in the phonebook.
  2147.      Simply choose the board you would like to dial from the menu.
  2148.  
  2149.      Choosing  a  entry will bring up a small window telling you which
  2150.      board  you  are calling.  From here you may add more entries from
  2151.      the  menu, and set up a dial queue.  The window will at all times
  2152.      tell  you  which board is the next to dial. Boards that are added
  2153.      to  the   queue  will  automatically  become  "selected"  in  the
  2154.      phonebook.
  2155.  
  2156.      If  a  number  is  busy,  the program will continue with the next
  2157.      board  on  the  list.   If  redial has been turned on, NComm will
  2158.      start  over  again if no connection has been established with any
  2159.      of  the  boards  in  the  queue.  It will not stop until either a
  2160.      connection  has  been  established or an "invalid" result code is
  2161.      received  (this  depends on the 'Max' settings in the modem setup
  2162.      menu.   The  default  action  is  to  abort when an error code is
  2163.      received.)
  2164.  
  2165.      NComm  will  abort  the dialling if it receives any text from the
  2166.      modem during the redial delay.
  2167.  
  2168.      Abort  the dialling by pressing the ESC key or closing the window
  2169.      by  clicking  in  the  upper lefthand closegadget.  To remove the
  2170.      current  entry,  press  the  DEL key.  Press the SPACE key if you
  2171.      would  like  to  go  on  with the next entry.  You may also click
  2172.      within the window gadgets.
  2173.  
  2174. CHAPTER 10: HOT KEYS AVAILABLE
  2175.  
  2176.      Are  you  fed  up  with  menus and mice and want to use something
  2177.      quicker  instead?   Look  no  further - NComm offers hot keys for
  2178.      most important functions.
  2179.  
  2180.      Hot Key                 Function
  2181.      -------                 --------
  2182.  
  2183.      Right Amiga A          About NComm
  2184.      Right Amiga B          Sends a 250ms break signal
  2185.      Right Amiga D          Download
  2186.      Right Amiga E          Enter phonebook
  2187.      Right Amiga F          Execute script file on/off
  2188.      Right Amiga G          Palette
  2189.      Right Amiga H          Hang up phone
  2190.      Right Amiga I          Toggle interlace
  2191.      Right Amiga J          Start/end ASCII Capture
  2192.      Right Amiga K          Split screen
  2193.      Right Amiga L          Load configuration
  2194.      Right Amiga M          Macrokeys
  2195.      Right Amiga N          Dial number
  2196.      Right Amiga O          Modem set-up
  2197.      Right Amiga P          Printer on/off
  2198.      Right Amiga Q          Quit NComm
  2199.      Right Amiga R          Reset
  2200.      Right Amiga S          Start/end ASCII Send
  2201.      Right Amiga T          Toggle title bar
  2202.      Right Amiga U          Upload
  2203.      Right Amiga W          Save configuration
  2204.      Right Amiga Y          Message upload
  2205.      Right Amiga Z          New Cli
  2206.      Right Amiga $          Run ARexx Script
  2207.  
  2208.      Right Amiga `          View scrollback
  2209.      Right Amiga !          Save scrollback
  2210.  
  2211.      Right Amiga #          (# is one of the keys 1,2,3,4,5,6,7,8,9,0)
  2212.                             This  sequence  will dial one of the first
  2213.                             10 entries in the phone directory.
  2214.  
  2215.      HELP key               Status
  2216.  
  2217.      The  CONTINUE  and  APPEND  options can be answered with the LEFT
  2218.      AMIGA  V key.  The CANCEL and DELETE options can be answered with
  2219.      the  LEFT  AMIGA  B  key.  You can of course click the left mouse
  2220.      button over these selections as well.
  2221.