home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Fred Fish Collection 1.5
/
ffcollection-1-5-1992-11.iso
/
ff_disks
/
200-299
/
ff246.lzh
/
NComm
/
NComm.doc
< prev
next >
Wrap
Text File
|
1989-09-14
|
52KB
|
1,199 lines
NComm 1.8 - released 1 July 1989
//
A terminal program for the \X/ AMIGA
This program is FreeWare. It is freely distributable and is intended
for personal use only. Sale of this program except for REASONABLE
media costs is prohibited.
NComm 1.8 written by Daniel Bloch. Based on Comm 1.34 by Dj James.
======================================================================
This program was developed using Lattice C, and is the result of a
project started in Oslo in 1988, using the Rodeløkka (M)BBS to
coordinate the initial efforts.
Many of the communication programs on the market today *look* nice,
but after testing them for a few minutes you find out that they are so
bug-ridden that even the old Basic-program you used on the Commodore
64 would be preferable.
We thought that no Amiga communication program fulfilled our needs,
and figured out that the only way to get a program that did everything
we wanted, was to make it ourselves! Luckily the source for Comm 1.34
was available. It had all the basic functions, so we could
concentrate on what we thought was missing.
Our goal wasn't to make a program with a lot of functions you never
use, but with the functions that we needed - and they had to work!
Our national characters have been ignored and mistreated, but NComm
puts an end to that.
The project was led by Daniel Bloch, and chief contributors to the
design so far, apart from Daniel, have been:
Trym Hansen Conrad Helgeland Torkel Lodberg
Jørn Lokøy Per Hansen Geir Atle Storhaug
Arvid Johansen Geir Inge Høsteng Anders Herbjørnsen
Bjørn Melbye Eric Wheatley Marek Rzewuski
Thanks go to Mike Robertson (who gave us the necessary information for
the G&R protocol, and helped us out with a few other things), Dj James
(for the source to Comm 1.34) and to Carolyn Scheppner (for the colour
palette source).
Also thanks to all the Beta-testers. Feedback from the users is the
most important thing when developing a program!
All programming by Daniel Bloch, with help from Torkel Lodberg.
Phonebook made by Trym Hansen. File requester enhanced by Daniel
Bloch and Torkel Lodberg.
This manual is based on the original Comm manual. It was written by
Torkel Lodberg, with help from Conrad Helgeland and Eric Wheatley.
Phone icon by Bjørn Rybakken. Doc icons from the Swilling collection,
courtesy of Frank Swilling (Minotaur). File Input requester from C.
Heath. Palette from C. Scheppner.
We welcome bug reports and comments about NComm and the documentation.
Send your comments to this address:
Daniel Bloch, Fyrstikkbakken 9, N-0667 Oslo 6, Norway.
Email: d_bloch_d@inger.uio.no (internet)
Or call Rodeløkka (M)BBS at 300-2400 baud, 24hrs, two nodes.
Phone # +47 2 380949 (international)
(02) 380949 (Norway)
A probable future expansion is the addition of more protocols. We
welcome debugged and documented C-source of other protocols, as lack
of time prevents us from writing them ourselves...
A final note: Please read this documentation carefully. Most things
should be explained here.
Disclaimer:
-----------
We have made every effort possible to ensure that NComm will function
as described, but no warranty of any kind, expressed or implied, is
made by us. We will not be liable for any direct or indirect damages
to either machinal equipment or mental health arising from a failure
of the program to operate in the manner desired by the user. In no
event will we be liable for any loss of profits or savings.
Summary of functions:
* Works on any Amiga with 512K RAM or more. Menu driven.
* Hot Keys for most program functions, including dialling of
up to 10 phone numbers.
* Interlaced screen (optional). PAL and NTSC support.
* Screen I/O greater than 2400 baud.
* ANSI / VT100 terminal emulation with full 8 colour text
support. IBM graphics (optional). Optional translation of
styles.
* Split screen mode for conferencing.
* Full user control of colour palette.
* Full support for all European languages (both character-
sets and keymaps). Twelve translation modes.
* Serial port parity, word-length, stop bit, full/half duplex,
line-break and control of End-Of-Line characters. Baud rates
up to 19200 baud supported.
* Xon/Xoff and CTS/RTS handshaking.
* Script language - simple text language automates sessions.
* File transfer protocols: ASCII, Xmodem, Xmodem-CRC, Ymodem.
Autochop on receive files - disabled for ARC, ZOO,
PAK. Optional translation. View transfer option.
* Autodownload feature for MBBS or systems with G&R protocol.
* Dialling directory, queued dial, redial until carrier
received.
* Support for non-Hayes type modems.
* 46 entry fast phonemenu. Phone requester with unlimited
entries. Sort and print from phonebook.
* 20 keyboard macros using function keys. Macrokey requester.
* Print function for printing incoming text.
* Optional remapping of Del/BS keys.
* View Hex Chars option.
* Statusline. Log writes.
* Internal multitasking.
Preparation
------------
The following files should be included in this package:
.info ExampleI.script
ExampleII.script Execute.me
NComm NComm.config
NComm.doc NComm.doc.info
NComm.info NComm.keys
NComm.news NComm.phone
NComm1.8 NComm1.font
NComm2.8 NComm2.font
Script.doc Script.doc.info
Be careful not to mix these files with old Comm 1.34 or NComm 1.01
files that may be lying around. The datafiles are incompatible.
NComm uses two fonts to emulate IBM graphics. They must reside in the
directory named fonts:
If this copy of NComm was downloaded as an archive file, enter the
following command in CLI:
1> Execute execute.me
This batchfile will copy the font files used by NComm to the fonts:
directory. First (of course) you have to assign fonts: to the
directory where you keep your fonts. Unless you assign these fonts
correctly, the IBM graphics emulation will not work!
Data files
----------
It is important for NComm to know where it can find its data files,
and we must help it on its way. If NComm was unarced in the ROOT
directory of a floppy disk, relabel the disk as "NComm". This can be
done by the following command if NComm resides on df1:
1> Relabel drive df1: name "NComm"
If the files were unarced within a directory or on a harddisk, you
must assign "NComm:" to the directory that NComm resides in including
full device and path names.
Examples:
1> Assign NComm: "df1:NComm 1.8"
...expects NComm to reside in directory "NComm 1.8" on drive "df1:"
1> Assign NComm: dh0:
...expects NComm to reside in the ROOT directory of drive "dh0:"
If you do not wish to name the disk that NComm resides on 'NComm', it
is probably a good idea to edit the "s:startup-sequence" file and add
the assign command that you just entered.
NComm has an inbuilt command for opening a new CLI. If NComm should
not use the normal "NewCLI" command for opening the CLI, this can be
done by using the SetEnv command in WB1.3. For example:
1> setenv NEWCLI "NewSHELL *"newcon:0/11/640/245/NCommShell*""
To start up NComm, enter the following command in AmigaDOS:
1> NComm [filename]
...where filename is the name of an optional script file.
From WorkBench, just click on the NComm icon.
Users of boards with multiple serial ports should notice that NComm
opens the serial.device in "exclusive" mode. If the serial.device
could not be opened, the message "Can't open serial.device" will be
displayed (workbench users will notice a flash on the workbench screen
if NComm of some reason can't run). It is therefore possible to patch
NComm to make it work with other devices, i.e; multiple copies of
NComm may run simultaneosly.
Note:
-----
Single-drive users have to execute these commands in a bit different
manner. Either you can copy the needed commands into RAM: and assign
c: to RAM:, or you may enter the desired commands with just a
question mark as command-line. You will then be given a long prompt,
at which you should enter the "normal command-line" with drive
specified as df0:. As an example, here is how to relabel a disk...
Boot your AmigaDOS disk in df0: and enter this at the prompt:
1> Relabel ?
"DRIVE/A,NAME/A" now appears on the screen. Now put your new NComm
disk in df0: and enter this:
drive df0: name "NComm"
How to configure NComm for use with MBBS.
-----------------------------------------
To get the most from NComm when using the MBBS program, you should log
in at the MBBS boards you are going to use. In the utility menu,
there are several options that have to be turned on. Walk to the
utility menu with the (U)tility command, and select (M)ode changes.
Answer 'YES' at all prompts. The message 'User profile updated' will
be displayed. Now, if you're using a PAL machine, you probably want
to configure a larger number of lines per page than what has been
configured by MBBS. Select (L)ines per page, and enter '29' at the
prompt. Finally, select IBM graphics by using the (S)et character set
command. Enter 'IBN' at the prompt.
Some options must now be turned on in NComm. Walk to the 'Transfer'
menu, and turn on the 'G&R Protocol'. Configure the default
directories for these transfers if you don't have enough memory to use
the RAM DISK. Now, examine that your 'Com' setup is 8N1. Always use
this setup when connecting to MBBS boards, otherwise high bits will be
stripped. Turn the 'IBN character set' on in the 'Translate' menu.
Turn the '8 Colour' mode on in the screen menu, and 'Reset' the
colours by opening the palette. You now have true ANSI graphics!
Remember to save the present configuration.
When in NComm, the following menu items are available:
1. SYSTEM:
Here you control all the system functions. From here you can load and
save settings, view the status, edit the macrokeys, turn on and off
the printer, and start a new CLI. You can also choose whether NComm
should add entries to the logfile when you connect with a board. You
may also exit NComm from here, as well as execute script-files.
The sub-entries of the SYSTEM menu are:
About NComm
Will tell you a few things about NComm and the author. Simply
click in the window to close it...
Status
This will bring up a status display showing the amount of
memory available, the state of the printer and capture buffer
toggles. If the capture buffer has been turned on, the
filename will also be displayed.
Here you will also find a slider gadget for use with the
"ASCII send" and "message send" functions. Some Bulletin
Board Systems lose data if is being sent too fast, so this
function can be very useful.
You can select a time to delay after transmitting each
character by using this slider gadget. The gadget can be
adjusted from approx 20ms (Fast) to 300 ms (Slow) delay
between transmitted characters. The slider can be adjusted
while a file is being sent to allow for fine tuning.
With the slider in the (default) far left position, there is
no delay.
Load config
Will load a new NComm configuration. All menu options and the
"text send delay" function are covered by this function. The
macrokeys and the phonebook must be loaded separately. A file
input equester will appear in the center of the screen. Only
files with a ".config" suffix will be shown.
For instructions on how to use the file requester, see "The
file input requester" below.
Save config
Will save the current NComm configuration. All menu options
and the "text send delay" function are covered by this
function. The macrokeys and the phonebook must be saved
separately. A file input requester will appear in the center
of the screen. For instructions on how to use this, see "The
file inputrequester" below.
Script
This function will execute a scriptfile. A file input
requester will appear in the center of the screen. For
instructions on how to use this, see "The file input
requester" below. Select the script you want to run. The text
'SCR' will be displayed on the status line. To stop a script,
select this entry again. See the file "Script.doc" for
detailed information on scripts.
Macrokeys
This will bring up a requester that lets you edit the
macrokeys. Here you may also load new macros and save the
text stored on the different macrokeys. The function keys
definable are F1 to F10 and SHIFT F1 to F10. A macro
definiton can be 127 bytes maximum. Not all keys have to be
defined. To edit a macro just click in one of the requester
text input boxes and enter your definition. The macros can
contain control characters which can be represented in two
ways. These characters can also be used in the modem setup
requester.
1. C-style slash conventions. The following
sequences are supported:
\n, \r Carriage Return
\t Tabulator
\f Form Feed
\b BackSpace
\v Vertical Tabulator
\e Escape
\\ Backslash
\" Quote
\p Phonebook Password
\w .5 second Delay
\l 250 ms Line Break
\m Macro
2. The caret followed by a letter, meaning
CTRL+letter. If you need the line feed
character, for example, use ^J.
You can have nested macros by using the \m## option, where ##
is a number from 1 to 20 - with 1 representing macro F1 and 11
and 20 representing Shift F1 and Shift F20 respectively.
Examples:
commodore ;Will not add a carriage return.
at \\N3\n ;AT \N3 plus a carriage return.
^pread ;The control-P code, followed by 'read'.
\m1\m2run testfile\r ;The text stored on macro F1 and F2, plus
;the text 'run testfile' and a CR.
Selecting the 'Load' gadget will bring up a file requester in
the center of the screen. For instructions on how to use
this, see "The file input-requester" below. From here you may
load new macrokeys. Remember to save the current macrokeys if
any changes have been made. Entering "NComm.keys" will load
the macrokeys that are normally loaded at startup.
Selecting the 'Save' gadget will bring up a file requester in
the center of the screen. For instructions on how to use
this, see "The file input-requester" below. From here you may
save the current macrokeys. Enter the name "NComm.keys" if
you want the macrokeys to be loaded on startup.
Selecting the 'Cancel' gadget will leave everything unchanged
and remove the macrokeys window.
Selecting the 'OK' gadget will close the window and install
the new macros.
Printer
Toggles the printer ON/OFF. When ON, text received from the
serial port will also go to the printer via the PRT: device.
The text 'PRT' will be displayed on the status line.
New CLI
Works like the "NewCli" command. Will open up a command line
interface on the Workbench screen. Type 'EndCli' to exit the
CLI and return to NComm.
Log Calls
When this option is turned on, NComm will log all calls made
within NComm. The information will be added to a textfile
called "NComm.log".
Quit NComm
Selecting this entry will close all open files and windows and
exit back to the operating system.
The File Input Requester
------------------------
Many functions call upon a file name. The file input requester then
appears on the screen with a sorted directory listing of the current
directory in the window.
At the bottom of the requester, eight devices are displayed. To
change the current device, click in one of these boxes - the device
must be available on your system (i.e not ghosted) for you to chose
it.
To enter a directory, position the pointer over the directory name and
click once or enter the directory name in the 'Directory' string
gadget.
The 'PARENT' gadget will move you back one directory - i.e. this will
cause the parent directory to be displayed, if such a directory
exists.
You may select a filename by positioning the pointer over it. Open
the file by doubleclicking, or by first clicking on the filename and
afterwards on the 'OK' gadget. Alternatively, type the name of the
desired file in the requester marked 'File' and press Return.
In the 'Type' string gadget, enter an optional extension. This will
display only the files with that suffix. For example, entering ".TXT"
will display only the textfiles.
The window only has room for 10 entries. To scroll through the
directory, use the dragbar.
The number of bytes free on the current device will be displayed in
the middle of the two gadgets. Always check if there is enough space
on the current device before downloading files.
The 'Directory' string gadget will be active when the window opens.
Pressing Return will move the cursor directly to the 'File' gadget.
This can be handy if you don't want to mouse around.
Use the upper right depth-arrangers to move the window in front or in
back of other windows.
Selecting 'CANCEL' will abort the operation.
Note:
When the file requester is on screen (active), you can still send and
receive data. Sorting and displaying the files on a disk takes some
time; you may want to bring up the requester early, and continue
talking to the remote system while this is being done.
2. FILE:
This is the file transfer menu. From here you can start a transfer
and select the different transfer options i.e protocol, handshaking
etc.
When the upload or download function is selected, a file input
requester will appear, that is if you have not selected the G&R mode.
Again, turn to "The File Input Requester" for instructions on how to
use this...
The sub-entries of the FILE menu are:
Start ASCII Capture
All data received from the serial port is also saved into the
named file. The text is buffered and written to the disk in
8K blocks. If you are using a translation table, the incoming
data will be translated. Select the 'ISO' character set to
avoid this.
When this mode is selected, the text in the MENU entry is
changed to "Stop ASCII Capture". Selecting this entry will
flush the data buffer to the disk and close the file.
When capturing is enabled, the word "CAP" will be visible on
the status line.
When entering a filename for data capture, NComm will check to
see if this file already exists. If it does, a requester will
appear informing you of that fact. You may then choose to
CONTINUE using the filename entered or CANCEL and enter
another filename. If you choose to CONTINUE, you will be
presented with another requester. You can APPEND data to the
existing file or DELETE the existing data and start with a
fresh file.
Start ASCII Send
The named file will be read and sent to the serial port. If
the file does not exist, a message to that effect will be
printed. If you are using a translation table, the outgoing
data will be translated. Select the 'ISO' translation to
avoid this.
When this mode is selected, the text in the MENU entry is
changed to "Stop ASCII Send". Selecting this entry will stop
the transfer and close the disk file.
Message upload
The named file will be read and sent to the serial port. If
the file does not exist, a warning message will be printed.
If you are using a translation table, the outgoing data will
be translated. Select the 'ISO' translation to avoid this.
This function will perform almost like "Start ASCII send", but
the message will be packed. Blank lines will be translated
into spaces. This can be useful when uploading to systems
with a certain pagewidth, or if your message contains blank
lines (usually you will exit the editor when a blank line
occurs in a message you upload with the ASCII send function.)
Select this entry again to stop the transfer and close the
disk file.
Download
The named file will be created on the disk and the transfer
will be started using the protocol you have selected in the
TRANSFER menu.
If the specified file already exists, a requester will appear;
asking if you want to CONTINUE or CANCEL the use of that
filename. Selecting CONTINUE will overwrite the old existing
file with the new one. Selecting CANCEL will bring up the
INPUT WINDOW allowing you to enter another file name.
A window will pop up that among other things will display the
name of the file being transferred, a running total of the
bytes received, the number of NAKs and the last block to be
NAKed. The transfer can be aborted by hitting the ESC key, or
by pressing the upper left-hand close gadgget.
The serial port parameters will be saved and changed to 8
bits, no parity, 1 stop bit for the transfer. Upon
completion, the old settings will be restored.
Upload
Use this selection to transmit a file to a system. The named
file will be opened on the disk and the transfer will be
started using the error checking method (CRC or Checksum)
selected by the receiving end.
If the specified file does not exist, a requester will appear
informing you of this fact. You only have the option to
CONTINUE, which will bring up the INPUT WINDOW allowing you to
re-enter the filename or CANCEL the upload.
A window will pop up that among other things will display the
name of the file being transferred, a running total of the
bytes sent, the number of NAKs and the last block to be
NAKed. The transfer can be aborted by hitting the ESC key, or
by pressing the upper left-hand close gadgget.
As described in the Download section, the serial port
parameters are temporarily changed to 8N1 for the transfer.
Protocol
Here you select the protocol you want used for the upload and
download functions.
YMODEM
This is basically XModem-CRC with 1024 byte blocks. This
means that there is less handshaking, which saves time.
YMODEM is faster than XMODEM as long as the line quality is
acceptable.
XMODEM
This is the protocol originally written by Ward Christensen.
It is used by almost every type of personal computer. This is
a good protocol to use if the line quality is poor. Its
biggest drawback is that it transfers data in 128 byte blocks
making it slower than YMODEM.
Options
This function selects the type of error checking to be used.
If CRC is not turned on, the checksum method will be used.
CHECKSUM
The original Christensen protocol used an 8 bit checksum for
error checking. It is about 97% effective in catching errors.
All implementations of XMODEM can use the checksum method.
Only use the cheksum method when in doubt, the CRC method is
much more secure.
CRC
A later addition to the protocol was the 16 bit (two byte)
Cyclic Redundancy Check ( CRC ) which is about 99.997%
effective in detecting errors. Not all implementations of
XMODEM can use the CRC method. If you select this mode and
the sending computer is unable to transmit in CRC mode, NComm
will detect this after 5 timeouts ( about 50 seconds ) and
switch to the Checksum method.
View Transfers
This option will output the file data to a view window while
transferring data. It is wise only to view files you know to
be ASCII because binary files will look like Greek. However,
no harm will be done.
Chop Files
File transfers will increase the size of a file to the next
largest multiple of 128 bytes for XModem transfers and 1024
bytes for YModem. The CHOP FILES option will remove the
padding on the end of the file. This is always required when
transferring executable binary files. CHOPing files is
therefore desired.
Note:
It is not desireable to CHOP an .ARC, .ZOO or .PAK file. As
it is very easy to forget to turn off the CHOP mode for these
files, NComm will check the receive-filename for such an
extension. If this is found, it will temporarily disable
CHOPing for this file and on completion of transfer the CHOP
flag will be reset to its previous value.
G & R Protocol
This is an auto up/download protocol for use with the MBBS
system. You must remember to also turn on G&R in your MBBS
user account to make it work. By using this protocol, you no
longer have to enter the desired protocol and filename in
NComm when transferring files to and from an MBBS system.
This means that you do not have to deal with the tedious file
requester.
Default directory
Here you may specify the default paths and directories for
uploading and downloading. A file requester will appear,
select a path and directory and click on the OK gadget when
you are satisfied with your selection. NComm will default to
these directories, but as long as you are not using the G & R
protocol, you may change the path and directory yourself
before an upload or download.
3. COM:
Serial device parameters are changed here.
Baud
Baud rates from 300 to 19200 baud can be selected. This
entry, however, may be overridden by the default baud rate in
the phonebook.
Note:
This selects the serial speed of the port, the actual data
throughput rate depends upon whether the capture buffer is
active, if printer capture is selected and upon the screen I/O
speed. With no printer or file capture, the throughput rate
depends on the screen I/O speed. This will be around 2400
baud if you are using a 8 colour screen. If a 2 colour screen
is being used, the screen I/O speed will be greater than 4800
baud, but less than 9600 baud in this release of NComm. This
means, that if you select a baud rate greater than 2400 baud,
you may lose characters unless the XON/XOFF feature has been
selected from the SERIAL menu.
Data Length
Selects the length of a data word as 7 or 8 bits. Most
computer systems today will operate with 8 bits.
Note that during binary transfers, serial port data length is
set to 8 bits and restored to the previous value on
completion.
Parity
Selects ODD, EVEN or NO parity. Most computer systems today
will operate with NO parity.
Note that during binary transfers, serial port parity is set
to NO parity and restored to the previous value on completion.
Stop Bits
Selects the number of stop bits transmitted as 1 or 2 bits.
Most computer systems today will operate with 1 stop bit.
Note that during binary transfers, serial port stop bit length
is set to 1 bit and restored to the previous value on
completion.
The Amiga hardware does not allow 2 stop bits to be used with
an 8 bit data word length.
Duplex
Selects whether NComm or the remote system should echo key
strokes to the screen.
Select FULL duplex when the remote machine will echo your key
strokes. You will normally be using this option.
Select HALF duplex when the remote system does not echo your
key strokes. That is when the remote system seems to be
responding to your commands, but you cannot see what you are
typing.
Handshaking
Enables or disables the serial driver check for flow control
characters.
Select 'None' when you do not wish to use flow control.
Select 'XON/XOFF' when you wish the driver to use the XON/XOFF
type of flow control. Normally this is used at baud rates
greater than 2400 baud to avoid losing characters.
Select 'RTS/CTS' when you wish the driver to use the hardware
RTS/CTS type of flow control. This should only be used with
modems which support it.
Note:
In some cases, when the XON/XOFF mode is selected, NComm may
receive an XOFF character ( noise or otherwise ) and appear to
be hung -- that is, no characters appear on the screen yet the
menus still function properly. Whenever NComm appears to be
hung, typing a Ctrl-Q will re-start the serial line. If the
problem was due to an XOFF character received, this will
restore everything to normal.
Send Break
Sends a 250 ms break signal.
4. TRANSLATE:
This is where you define the translation of out- and ingoing data and
the special keyboard keys.
End of Line
You can select how End of Line characters are handled on the
screen and when sent out the serial port. By default, EOL is
just a CARRIAGE RETURN character, but you can change this to
CR and LINEFEED pairs. Use this option if all text seems to
be printed on one line.
Character set
NComm offers twelve different translation tables, and they can
be selected here.
ISO
NComm will use the standard Amiga character set, without any
translation. This should be used when using Amiga systems
only.
Please note; if no translation of the in or outgoing data is
wanted when using the ASCII capture or ASCII send option,
switch to ISO before transfer.
IBM
Should be used with bulletin boards running on PC/MS-DOS
machines that use the IBM extended character set. NComm will
utilize a special IBM font containg all the IBM graphic
characters.
IBN
Should be used with Norwegian bulletin boards running on
PC/MS-DOS machines that use the IBM extended character set.
This is a version of the character set that has two norwegian
characters that are missing in IBMs original character set.
NComm will utilize a special IBM font containing all the IBM
graphic characters.
NO7
Use this option when the host uses
the Norwegian ISO 7 bit standard.
US7
Use this option when the host uses
the American ISO 7 bit standard.
UK7
Use this option when the host uses
the English ISO 7 bit standard.
GE7
Use this option when the host uses
the German ISO 7 bit standard.
FR7
Use this option when the host uses
the French ISO 7 bit standard.
SP7
Use this option when the host uses
the Spanish ISO 7 bit standard.
IT7
Use this option when the host uses
the Italian ISO 7 bit standard.
SF7
Use this option when the host uses
the Swedish/Finnish ISO 7 bit standard.
DE7
Use this option when the host uses
the Danish ISO 7 bit standard.
DEL <-> BS
Here you may configure whether the backspace and del keys are
to be exchanged. This can be useful when communicating with a
machine thar runs Unix, VMS or Tops-20, amongst others.
Show HEX chars
This option will translate all incoming text to HEX numbers,
as well as displaying the text to the right. Perfect for
debugging.
5. SCREEN:
This is where you may configure what your screen should look like.
Title bar
Toggles the title bar on and off
Interlace
This option will make NComm use an interlaced screen, which
will double the vertical resolution but cause a lot of flicker
if you haven't invested in a flicker-fixer card or a
long-peristance monitor.
Colours
From here you may choose whether NComm shall use a 2 or 8
colour screen. If you choose the eight colour mode, you will
get full ANSI colour emulation. Choose the two colour mode if
you prefer faster screen updates.
Palette
This will bring up a requester that lets you configure the
colours for the current screen mode. Each screen mode has its
own palette. Click 'RESET' to use the colours that NComm was
shipped with.
Split Screen
This function will divide the screen into two windows, a small
one ( 4 lines ) for your typed characters and a larger one (
19 lines when using NTSC) for characters received from the
modem.
You should select the half-duplex mode on the host system to
prevent your typed characters from being echoed back into the
receive window. To exit the split screen mode, select 'Split
Screen' from the menu again.
Split screen mode requires at least 1MB of memory to operate
in interlaced mode.
Caution:
If you login to a system while in the split screen mode, your
password will be echoed in the TX window. It is best to login
in the single screen mode.
Style
This function allows you to turn on or off the translation of
the different styles (boldface, italics and underline). The
reason why this function was included is that the styles are
misused by many bulletin board systems. The text will appear
clearer, and this will also reduce flashing when the screen is
scrolling.
Bell
From here you can configure what NComm should do when it
receives the ASCII "bell" code. You can have an ordinary
audible bell or a visible bell. You even select
'ScreenToFront', which will bring the NComm screen to front
when the "bell" code is received. You may freely mix the
three or turn bell off.
Reset
This function will clear the screen, turn off all style
settings and reset the colours.
Window Gadgets
--------------
The screen contains hidden gadgets for depth arranging the NComm
window. The depth gadgets are in the upper right hand corner.
6. PHONE:
From here you may dial phonenumbers, edit the phonebook, configure the
modem and redial, or hang up the phone.
Phonebook
This entry will bring up the phonebook window, where you may
load or save phonebooks, as well as edit, delete and add
entries. The entries can also be sorted, dialled or printed.
When loaded, NComm first looks for a file called
NComm:NComm.phone. If not found, the phonebook will be blank.
The phonebook can consist of an unlimited number of entries,
but only the first 46 will be displayed in the DIAL menu, and
only the first 10 can be dialled using hot keys.
Only 15 entries can be displayed simultaneously in the window.
To scroll through the phonebook, use the right drag bar.
You may select an entry by positioning the pointer over it
and then clicking on the left mouse button. When an entry is
selected, it will show up in reverse video. Several entries
can be selected at the same time.
Selecting the 'Dial!' gadget will dial the entries that are
selected, starting at the top. This will bring up a small
window telling you which board you are calling, and eventually
which is the next to go. The phonebook window will be
removed. More entries can be added while dialling by
selecting them from the DIAL menu, or by bringing up the
phonebook again.
If a number is busy, the program will continue with the next
number on the list. If redial has been turned on, NComm will
start over again if no connection has been established with
any of the numbers in the queue. It will not stop until a
connection has been established.
Abort the dialling by pressing the ESC key or closing the
window by clicking in the upper lefthand gadget. To remove
the current entry, press the DEL key. Press the SPACE key if
you would like to go on with the next entry. You may also
click within the window gadgets.
Selecting the 'Edit' gadget will bring up the edit window,
containing the information about the first entry selected.
This information can then be edited. See below for more
information about how to use the edit window. Pressing the
'OK' gadget will accept the edit, 'Cancel' will leave
everything unchanged.
Selecting the 'New' gadget will add a new entry in front of
the first entry selected. However, if no entry has been
selected, the entry will be placed at the bottom of the list.
This will bring up a special edit window. See below for more
information about how to use the edit window. Pressing the
'OK' gadget will add the current entry, 'Cancel' will abort
the edit and not add the entry.
Selecting the 'Abort!' gadget will remove the window. This
equals pressing the upper lefthand closegadget.
Selecting the 'Load' gadget will bring up a file requester in
the center of the screen. For instructions on how to use
this, see "The file input-requester" above. From here you may
load a new phonebook. Remember to save the current phonebook
if any changes have been made. Entering "NComm.phone" will
load the phonebook that is normally loaded at startup.
Selecting the 'Save' gadget will bring up a file requester in
the center of the screen. For instructions on how to use
this, see "The file input-requester" above. From here you may
save the current phonebook. Enter the name "NComm.phone" if
you want the phonebook to be loaded at startup.
Selecting the 'Delete' gadget will delete the entries that are
currently selected.
Selecting the 'Sort' gadget will sort the phonebook. If a
entry has been selected, the function will only sort the
entries between this entry and down. If multiple entries have
been selected, the function will only sort the entries between
the top and lower entry.
This can be handy if you are using hot keys to dial numbers,
and don't want the upper entries mixed with entries that are
lower on the list, or if you prefer using the DIAL menu for
dialling entries and don't want entry 45 and down to be mixed
with the upper entries.
Selecting the 'Print' gadget will print the phonebook. Enter
the name of the file in the righthand text gadget, or use
"PRT:" if you want output sent to the printer. If no entries
are selected, the whole phonebook will be printed. Else, only
the entries selected will be printed.
Dial #
This requester will dial a number which is not listed in the
phonebook. If redial has been turned on, the program will try
reaching the number until connection has been established.
This function can be used together with the dial queue.
Hang up
Selecting this entry will send the HANGUP command string to
the modem.
Redial
By configuring this option, NComm will try over and over again
when a board you are calling is busy.
Modem setup
Within this requester you may configure the things that are
sent and received by the modem, and how long NComm should wait
before redialling. Simply click in the text gadgets to edit
them. The setup strings can contain the control characters
listed under the explanation of 'macrokeys'.
The 'initialization string' will be sent to the modem soon
after NComm opens the serial device and before keyboard input
is accepted. It can be left blank, but remember that NComm
requires 'echo' from the modem, so it can be clever to
configure this here. This can be accomplished by the 'AT E1'
command if your modem is Hayes compatible.
You must also set your modem to detect the BUSY signal if it
has got such a feature. If you have problems configuring your
modem, the 'AT &F\n' line will load the factory configuration
on Hayes compatibles. This configuration is usually accepted
by NComm.
The 'exit string' is sent just before the serial device is
closed, when exiting NComm. It is normally left blank.
'Dial prefix' is the command to be inserted before the
phonenumber. For Hayestype modems, this should be ATDT (or
ATDP for pulse dial).
'Dial suffix' is the string to be added after the phonenumber.
For Hayestype modems, this should be '\n', which will send a
carriage return.
'Hang-up string' is the string to be sent when you choose the
Hangup function. For Hayestype modems, this should be
'\w\w+++\w\w\w\wATH\n' (Wait 1 sec +++ Wait 2 sec ATH CR).
The 'disconnect string' is the string sent from the modem when
a call has ended. For Hayestype modems, this should be 'NO
CARRIER'.
The 'connect string' is the string sent from the modem when
you get connected to a board. For Hayestype modems, this
string should be 'CONNECT'.
The 'busy string' is the string sent from the modem when the
phone is busy. For Hayestype modems this string should be
'BUSY', but if your modem is having problems detecting the
busy signal, enter this as 'NO CARRIER'.
In the delay box you may specify how many seconds NComm should
wait before redialling. This delay is normally set to '3',
but enter this as '0' if you have used 'NO CARRIER' as the
BUSY string.
Auto-speed is a feature that normally should be turned on.
When connected, NComm will look for the number specified right
after the 'CONNECT' message, and will switch to this speed.
This feature should be turned off if you have set a constant
speed between the modem and the machine, or if you are certain
that the hostmodem supports the speed that you are calling at.
To make this feature work, it is important that you have told
your modem to report the baudrate sent after the 'CONNECT'
message. This is done, again on Hayes, with the command 'AT
V1'.
Pressing the 'OK' gadget will accept the edit, 'Cancel' will
leave everything unchanged.
Edit window
-----------
The edit window contains six text input boxes and eight gadgets.
In the text input box marked 'Name', enter the name of the board. The
name can be up to 40 characters long, however, only the first 17
characters will be displayed in the dial menu and window, and in the
logfile. You can not leave this empty.
In the text input box marked 'Phone #', enter the phonenumber to the
current board. The phonenumber can be up to 60 digits long. If a
board has multiple numbers, enter them separated by the '|' character,
for example "416588|410403". Only the first 17 characters will be
displayed in the dial window, and in the logfile. This field can not
be omitted.
In the text input box marked 'Comment', enter an optional comment,
like when the board is open, what the main purpose with the board is,
if MNP is available or which speeds are available. The comment can be
40 characters long.
In the text input box marked 'Config', you may specify the name of an
optional configuration file that must reside in the NComm: directory.
It will be loaded just after dialling. The colors, screen mode and
menu settings will be changed back to the way they were when the
configuration file was saved.
In the text input box marked 'Script', you may specify the name of an
optional scriptfile. The filename is relative to the current
directory. It will be loaded and executed just after dialling, which
means that the scriptfile should not contain the 'dial' command as the
first entry.
In the text input box marked 'Password', you may specify the name of
an optional password. This can be handy if you prefer only using one
scriptfile for multiple boards. The scriptfile can then contain a
'SEND "\p\n"' command line that sends the password configured for the
current board. The password can also be sent by configuring '\p\n' on
one of the macrokeys.
Pressing 'return' in one of the text input boxes will bring the cursor
to the text input box below the current box. The cursor will be
brought to the top if 'return' is pressed in the bottom box.
Pressing the gadget marked 'Baud rate' will multiply the board rate
which is to be used for the board by two. However, since NComm only
supports board rates up to 19200 baud, the baud rate will revert to
300 baud when this baudrate is present.
Pressing the gadget marked 'Data length' will switch between 7 and 8
bits data length. This data length will be used when NComm dials the
board.
Pressing the gadget marked 'Parity' will switch between Even, Odd and
None parity. This parity will be used when NComm dials the board.
Pressing the gadget marked 'Stop bits' will switch between 1 and 2
stop bits. This number of stop bits will be used when NComm dials the
board.
Pressing the gadget marked 'Duplex mode' will switch between Full and
Half duplex. This duplex mode will be used when connection is
established.
Pressing the gadget marked 'Character set' will switch between IBN,
US7, UK7, GE7, FR7, SP7, IT7, DE7, NO7, SF7, ISO and IBM translation.
If the IBM or IBN character set has been chosen, a special IBM
graphics font will be used. ISO should be used for Amiga boards only.
The other character sets should be used on machines only having a
7-bit character set available. By watching the first two letters in
the translation name, you may easily find out which one is to be used
for your country.
7. DIAL
Use this menu for fast dialling of entries in the phonebook. Simply
choose the board you would like to dial from the menu.
Choosing a entry will bring up a small window telling you which board
you are calling. From here you may add more entries from the menu,
and set up a dial queue. The window will at all times tell you which
board is the next to dial.
If a number is busy, the program will continue with the next board on
the list. If redial has been turned on, NComm will start over again
if no connection has been established with any of the boards in the
queue. It will not stop until a connection has been established.
NComm will abort the dialling if it receives any text from the modem
during the redial delay.
Abort the dialling by pressing the ESC key or closing the window by
clicking in the upper lefthand closegadget. To remove the current
entry, press the DEL key. Press the SPACE key if you would like to go
on with the next entry. You may also click within the window gadgets.
HOT KEYS
Are you fed up with menus and mice and want to use something quicker
instead? Look no further - NComm offers hot keys for most important
functions.
Hot Key Function
------- --------
Right Amiga A About NComm
Right Amiga B Sends a 250ms break signal
Right Amiga C Start/end ASCII Capture
Right Amiga D Download
Right Amiga E Enter phonebook
Right Amiga G Palette
Right Amiga H Hang up phone
Right Amiga I Execute script on/off
Right Amiga L Load configuration
Right Amiga M Macrokeys
Right Amiga N Dial number
Right Amiga P Printer on/off
Right Amiga Q Quit NComm
Right Amiga R Reset
Right Amiga S Start/end ASCII Send
Right Amiga T Toggle title bar
Right Amiga U Upload
Right Amiga W Save configuration
Right Amiga Y Message upload
Right Amiga Z New Cli
Right Amiga # (# is one of the keys 1,2,3,4,5,6,7,8,9,0)
This sequence will dial one of the first 10
entries in the phone directory.
HELP key Status
The CONTINUE and APPEND options can be answered with the LEFT AMIGA V
key. The CANCEL and DELETE options can be answered with the LEFT
AMIGA B key. You can of course click the left mouse button over these
selections as well.