home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload
/
ShartewareOverload.cdr
/
comm
/
qmodem4.zip
/
QMDOC.42
/
QMODEM42.DOC
Wrap
Text File
|
1990-09-05
|
553KB
|
15,764 lines
Qmodem Operations Manual
The Forbin Project, Inc
Table Of Contents
Preface..........................................1
Accolades........................................1
Tools of the trade...............................1
System Requirements..............................1
How to Contact The Forbin Project................2
License..........................................3
Single User.....................................3
Giving a copy to a friend.......................3
Sysops - what you need to know..................3
Distributors of PD or ShareWare.................3
Ordering Information.............................3
Registration....................................3
Registration only..............................3
Site License....................................6
Discounts......................................6
Warranty.........................................7
Operating Environment............................8
Multi-Tasking Systems...........................8
Other Background Software.......................8
Installing Qmodem................................9
Back up your diskettes!.........................9
Floppy Disks....................................9
Starting Qmodem in a Floppy Setup.............10
Hard Disk Installation.........................10
Subdirectory Structure........................11
ONLINE Help.....................................11
Getting Help when you need it..................11
Upgrading from a previous release...............13
Command Line Parameters.........................14
The Status Line.................................14
The Home Menu...................................16
Configuration...................................19
Menu Navigation................................19
First time setup...............................20
Video..........................................20
Custom Colors.................................20
Customization Window.........................21
BIOS Video...................................23
Linefeed after CR............................23
Snow Checking................................23
Qmodem SST i
Growing Windows..............................24
Status Line..................................24
Destructive backspace........................24
Line Wrap....................................24
Video Restore................................25
Jump Scroll..................................25
Emulation....................................25
Communications Parameters.....................26
Default Baud Rate............................26
Default Data Bits............................26
Default Parity...............................26
Default Stop Bits............................27
Command Before Baud Change...................27
Command After Baud Change....................27
Cycle Delay..................................27
Timeout Delay................................27
Modem Command delay..........................28
Serial Port..................................28
Modem Commands................................28
Initialization Command.......................29
Prefix Dial Command..........................29
Suffix Dial Command..........................29
Connect Message..............................29
Error Messages 1-4...........................29
Abort Dial Command...........................30
Hangup Command...............................30
Redial Hangup Text...........................30
Port Addresses................................32
COM1-COM8 Base...............................32
COM1-COM8 IRQ................................33
Xon/Xoff.....................................38
CTS/RTS Flow Control.........................38
CTS when Writing.............................38
FIFO during Shell............................39
Lock DTE Baud Rate...........................39
High Speed Xmit..............................40
16550 UART Enable............................40
Init Ignores CD..............................40
Directories....................................40
Upload........................................40
Download......................................41
Scripts.......................................41
SWAP..........................................41
Batch Directories.............................41
Alt-W Pick....................................42
Host...........................................42
Type of System................................42
Download Dir..................................43
Upload Dir....................................43
Maximum Time..................................43
DOS Password..................................44
Shutdown Password.............................44
Init Command..................................44
Answer Command................................44
OK Message....................................44
Ring Detect...................................44
Busy Command..................................45
# Rings and Answer............................45
ii The Forbin Project, Inc.
Protocols......................................45
Protocol Revisions............................46
Select Character.............................46
Protocol Name................................46
Upload BAT...................................46
Download BAT.................................47
Filename Prompt..............................47
Installing an external protocol...............47
ASCII Options.................................48
ASCII Receive................................49
Use INPUT Translate Table...................49
Carriage Return Handling....................49
LineFeed Handling...........................49
ASCII Transmit...............................50
Use OUTPUT Translate Table..................51
Carriage Return Handling....................51
LineFeed Handling...........................51
Pacing Speed................................51
Pacing Character............................51
Blank Line Expansion........................51
End Of Line Character.......................52
Protocol Toggles..............................53
Overwrite Files..............................53
Auto-Increment Filenames.....................53
Save Partials................................54
Clear Batch Screen...........................54
Zmodem Auto-Start............................54
Files..........................................55
Online Help...................................55
Screen Dump...................................55
Capture.......................................55
Log...........................................56
Backscroll....................................56
View..........................................56
Printer.......................................57
Time/Date Stamp...............................57
Options........................................57
Toggles.......................................57
Beeps & Bells................................58
ANSI Music...................................58
Del/^H Backspace.............................58
Auto Start Log...............................58
Keypad emulation.............................58
ENQ Response.................................59
Guard Alt-H..................................59
0xE0 Doorway Codes...........................59
Alt-D FON Book...............................60
Tag Advance.................................60
Auto Start..................................60
Clear tags on FKey..........................60
Write FBK File..............................61
Toggles.......................................61
EMS for Overlays.............................61
Int16 Enable.................................62
Share IRQ's..................................62
Optimum Shell................................62
Disk Shell...................................62
Calibrate Delay..............................63
Qmodem SST iii
Memory........................................63
Script Variables.............................63
Download Buffer..............................63
Overlay Buffer...............................63
Sounds........................................64
Upload tone..................................64
Download tone................................64
Connect Tones................................65
Connect Tone 1..............................65
Connect Tone 2..............................65
Connect Tone 3..............................65
Max Repeats.................................65
Delays........................................66
Status Windows...............................66
File Transfers...............................66
BREAK Timing.................................66
DTR Timing...................................67
Characters....................................67
Beeps & Bells................................67
ANSI Music...................................68
Status Line Filler...........................68
Phone Book Tag...............................68
Notes Tag....................................68
Date Mask....................................69
Time Mask....................................69
Elapsed Mask.................................69
Exit...........................................70
Save Changes..................................70
Abandon.......................................71
Qmodem Keyboard Commands........................72
Strip/Replace Tables [Alt-A]...................72
Changing an incoming character................72
Changing the High-Bits........................73
Bells and Beeps Toggle [Alt-B].................74
Clearing the screen [Alt-C]....................74
Dialing Directory [Alt-D]......................74
Moving around in the Directory................75
Using Up & Down Arrows.......................75
Using PgUp & PgDn............................75
Using ^PgUp & ^PgDn..........................75
Revising this Screen.........................78
Untag All....................................81
Starting the Dialer..........................82
Dialing from ALT-D............................82
Primary Commands..............................82
Status messages...............................83
Parameters passed to Scripts..................84
Manual Dial mode.............................84
{F2}-{F12} Speed Dialing.....................85
How to use Prefixes..........................86
Editing Attached Notes.......................87
Other info in the Phone Book.................91
Changing Duplex Mode [Alt-E]...................95
Script Files [Alt-F]...........................96
What is a Script?.............................96
Terminal Emulation [Alt-G].....................97
Hangup the phone [Alt-H]......................101
iv The Forbin Project, Inc.
Information screen [Alt-I]....................101
Function Key Macros [Alt-J]...................102
Editing Key Macros...........................103
DOS Shell Macros.............................104
A Dial Macro.................................105
An Edit Macro................................105
A Help Macro.................................106
A Script Macro...............................106
A LOG Macro..................................107
The $PASSWORD Variable.......................107
Loading a new Key file.......................108
Changing COM Ports [Alt-K]....................108
Changing the Logged Drive [Alt-L].............108
Music Toggle [Alt-M]..........................109
Changing Subdirectories [Alt-O]...............109
COM Port Settings [Alt-P].....................110
QuickLearn Script Recorder [Alt-Q]............111
Saving the Current Setup.....................112
Commands that are recorded...................113
Putting it all together......................116
DOS Shell [Alt-R].............................119
Split Screen Mode [Alt-S].....................121
Screen Dump [Alt-T]...........................122
Scroll Back Toggle [Alt-U]....................122
View a File [Alt-V]...........................123
Disk Directory [Alt-W]........................123
Exiting Qmodem [Alt-X]........................125
Delete a File [Alt-Y].........................126
Xon/Xoff Toggle [Alt-Z].......................126
Uploading & Downloading (PgUp/PgDn].........127
Selecting a Protocol.........................127
ASCII protocol..............................128
Xmodem......................................128
Xmodem CRC..................................128
Relaxed Xmodem..............................128
1k-Xmodem...................................129
Ymodem......................................129
1K-Xmodem/G & Ymodem-G......................130
External protocols...........................130
Scroll Back (UpArrow].......................137
Capture to Disk (Ctrl-Home].................139
Sending a BREAK (Ctrl-End]..................139
Backspace / DEL Toggle [Alt-1]................140
EGA/VGA Modes [Alt-2/Alt-4]...................140
Hi Bit Stripping Toggle [Alt-8]...............141
Copying to the Printer (Ctrl-PrtSc].........141
Logging activity to a File [Alt-0]............142
Host Mode [Alt-5].............................144
Host Setup...................................144
External Files Required......................144
Files created by the Host....................145
Optional Files...............................145
Logging on Locally...........................146
Starting the Host while ONLINE...............146
Sysop Commands...............................146
F2 Chat.....................................146
F5 Drop to DOS Locally......................147
F10 Disconnect Caller.......................147
Qmodem SST v
Host Functions...............................148
R Reading Messages.........................148
E Entering a Message.......................149
P Page the Sysop...........................150
F File List................................151
D Download.................................151
U Upload...................................151
O Open Script..............................151
S Shell to DOS.............................153
G Goodbye (Hang-up]........................154
? Help with Host Commands..................154
Z Shut down the Host.......................155
Packing the Message Base.....................155
Status Line Toggle [Alt-Minus]................156
Doorway Mode Toggle [Alt-Equal]...............156
Alt. Status Line Toggle [Alt-Enter]...........156
The Internal Editor............................157
The Editing Screen............................158
Basic Movement Commands.......................160
Insert and Delete Commands....................162
Block Commands................................164
Miscellaneous Commands........................165
EDINSTAL.......................................167
Running EDINSTAL..............................168
Fast Entry...................................168
Random Access................................168
Quitting the Program.........................169
The Qmodem Script Language.....................170
What is a script?.............................170
Physical vs. Logical Screen...................170
Input and Output Commands.....................170
Variable Handling.............................171
Running Scripts...............................171
Script Commands...............................171
SCRIPT LANGUAGE................................171
Different types of Scripts....................171
How to create and name a Script file..........172
Using an Editor..............................172
Starting a Script.............................172
/S= command line switch.......................172
The explicit .i.Alt-F.........................172
Linked-Script.................................173
Stopping a Script.............................173
Debugging a Script............................173
Special characters in Scripts.................177
Definitions and Parameters....................178
Labels.......................................178
Pre-defined String variables.................179
Pre-defined System variables.................180
Connect Information variables................181
General Coding Information...................184
Script Commands...............................184
Scripts Command Reference.....................186
ATWRITE......................................187
vi The Forbin Project, Inc.
ASSIGN.......................................187
BEEP.........................................188
BOX..........................................188
BREAK........................................188
CHDIR........................................189
CLOSEFILE....................................190
CLRSCR.......................................190
COLOR........................................190
COLORBG......................................191
COLORFG......................................192
DEBUG........................................192
DECR.........................................192
DELAY........................................193
DIAL.........................................193
DISPLAY......................................194
DISPLAYLN....................................194
DOS/BIGDOS...................................195
DOWNLOAD.....................................196
DRIVE........................................197
EGA..........................................197
EXIST........................................198
EXIT.........................................198
FKEY.........................................198
FLUSH........................................199
GET..........................................199
GETR.........................................199
GETN.........................................200
GETNR........................................201
GETSCR.......................................201
GETX.........................................202
GOSUB........................................202
GOTO.........................................203
GOTOXY.......................................203
GRAPHICS.....................................204
HANGUP.......................................204
IF...........................................204
INCR.........................................206
INKEY........................................206
LOADFON......................................206
LOADKEY......................................207
LOG..........................................207
NOTE.........................................208
OPENFILE.....................................208
PAUSE........................................209
POP..........................................210
PORT.........................................210
PUSH.........................................211
PUTSCR.......................................211
READFILE.....................................212
RETURN.......................................212
SCRIPT.......................................213
SEND.........................................213
SETCOMM......................................214
STAMP........................................214
STRING.......................................215
SYSTEM.......................................215
TIMEOUT......................................216
TURNOFF......................................216
Qmodem SST vii
TURNON.......................................216
UPLOAD.......................................217
WAITFOR......................................219
WAITUNTIL....................................219
WHEN.........................................220
WINDOW.......................................221
WRITE........................................221
WRITELN......................................222
WRITEFILE....................................223
Script Error Messages.........................223
Appendix A.....................................229
Most Asked Questions & Answers................229
viii The Forbin Project, Inc.
Preface
This document was revised for Qmodem 4.2.
Qmodem software and this document is (C) Copyright 1990 The Forbin Project, Inc.
All rights reserved World Wide. Qmodem is a Trademark of The Forbin Project,
Inc.
Any specific hardware/software names used in this document are trademarks of
specific manufacturers.
Accolades
I would also like to take this opportunity to thank all of the Alpha and Beta
testers who helped find all the problems and solutions in Qmodem. They have
made creating this new version a pure joy. Many times we agreed and disagreed,
but we never lost sight of the goal; to make Qmodem the best darned
communications program!
Thank you!
Tools of the trade
I would also like to thank the various Software companies that helped bring
Qmodem 4.2 into reality.
Borland for Turbo Pascal 5.5 in which much of the actual code is
International written. Also for their Turbo Assembler and Turbo
Debugger that I found so indispensable during the
debugging stages.
Turbo Power for the fine libraries of Turbo Professional and Object
Software Professional. They made the difference between a so-so
program and a truly elegant one.
Microsoft for Word for Windows and Windows 3.0 which helped me get
this document together and formatted so nicely.
ZSoft for SoftType which made using Windows and Word truly
enjoyable.
Bitstream for FontWare for Windows. This allowed me to do what
everyone said was impossible.
System Requirements
Qmodem requires an IBM PC,XT,AT,PS/2 or IBM compatible computer with at least
384K RAM, a Color Graphics or Monochrome adapter and monitor, and a serial port
and modem.
Qmodem SST 1
How to Contact The Forbin Project
The best way to get hold of us, is to call the Forbin Project BBS. We have 8
nodes running the PCBoard BBS software; 24 hours a day, 7 days a week. From the
"Main Menu Command" prompt, use the (C)omment command. Turn-around time for
answering BBS mail is usually within 24 hours.
We no longer respond to tech support through the US Mail. It is too time
consuming and the delays are enormous. If you must write a letter, you must be
able to FAX it to us.
You can send mail and packages to the following addresses:
Mail Orders The Forbin Project Inc.
Post office Box 702
Cedar Falls, IA 50613 (USA)
Packages, UPS or Please call before you ship to get the current address.
Federal Express (we're moving to larger facilities!)
Phone numbers for reaching us are:
Voice Orders (319) 232-4516 8am-5pm (CST) Mon - Fri
Tech Support (319) 232-4516 1pm-5pm (CST) Mon - Fri
(this time frame will expand when we finish relocating!)
FAX Machine (319) 233-1725 24 hours a day
MultiTech V32 (319) 233-6006 24 hours a day
(1 line)
1200-38400 baud
USRobotics HST (319) 233-6157 24 hours a day
Duals (7 lines)
1200-38400 baud
Note: When calling our BBS system, set Qmodem up for 8 Data bits, No Parity
and 1 Stop bit.
We also run a Qmodem Support Roundtable on the General Electric GEnie system.
Type "QMODEM" at any menu prompt to get to us!
Calling for Tech Support
Please have the following information handy before you call:
o Version of Qmodem you have
o Computer make and model number
o Modem make and model number
o Version of DOS
o Copies of your CONFIG.SYS and AUTOEXEC.BAT files
2 The Forbin Project, Inc.
License
Qmodem is not, and has never been in the Public Domain. Qmodem is not free.
Non-registered users are granted a limited, 90-day license to determine whether
or not the program meets their needs. Continued use of Qmodem beyond the 90-day
evaluation time period requires registration of the program. Use of non-
registered copies of Qmodem beyond the original evaluation period is strictly
prohibited.
No one may modify Qmodem for any reason, in any way, including but not limited
to, decompiling-compiling, patching, disassembling, or reverse engineering the
program.
These restriction also applies to all Qmodem screen displays such as the opening
screen, help screen, and all other proprietary program output. Only 'FORBIN
APPROVED' patches may be applied to the Qmodem program(s).
Qmodem may be copied and distributed to others, subject to the above
restrictions and the following:
Qmodem must be copied in unmodified form, including the file containing this
license information.
Complete Qmodem documentation and Online Help must be included.
No copying fee of any type may be assessed other than basic charges for the
cost of the copying medium.
Qmodem may not be distributed with any other software or hardware product(s)
without the express written permission of The Forbin Project, Inc.
Sysops (bulletin board SYStem OPerators) may make Qmodem available for
downloading by their users as long as all above conditions are met. If problems
are experienced due to the combined sizes of all Qmodem distribution files, the
QMODEM documentation must be bundled with the QMODEM.EXE file to insure that the
user gets it.
Commercial Distributors of Public Domain, ShareWare, or User-Supported software
may distribute Qmodem subject to the above conditions only after obtaining
specific written permission from the Forbin Project, Inc and filling out a
registration form for upgrade notifications. This condition supersedes any and
all previous agreements.
No blanket authorization has been issued by the Forbin Project, Inc., for
commercial distribution of its products.
Ordering Information
When you register your copy of Qmodem, you are granted a license to use the
program as often as you wish. There are several advantages to registering your
copy of Qmodem:
1. The Forbin Project, Inc. has a large BBS in house for registered users. As
soon as your registration is received, you will receive 1 year of support
at no additional charge on these BBS's. After the first year, you may
Qmodem SST 3
renew your subscription to the Forbin Project BBS. Subscription renewals
also include all Qmodem updates released during that year.
2. Telephone support, also for a one-year period following your registration
date. No problem is too big or too small for us to tackle, but you must
be a registered user to get this kind of support.
3. We run a "Round Table" (special interest group) on the General Electric
GEnie system. Now we are a local phone call away from 99% of you!
4. Automatic notification of upcoming major new releases or enhancements
through the mail and on the Forbin Project BBS.
There are two methods for registering Qmodem:
1. Send a completed Registration form and a check for $30. We will assume
that you have already obtained the program and documentation elsewhere.
The $30 registration fee does not entitle you to diskettes or printed
manuals. Refer to the order form on the following page for pricing.
2. If you have a valid Visa or Mastercard, we also accept phone orders. Call
us during normal business hours at (319) 232-4516.
Non U.S. residents: please send checks or money orders drawn on U.S. Banks in
U.S. Funds. VISA and MasterCard credit cards are also acceptable. All foreign
orders are subject to current U.S. foreign trade and technology exchange
restrictions.
NOTE: Pricing is subject to change without notice. For current pricing,
call us at the order number listed above.
4 The Forbin Project, Inc.
INVOICE # 90-150842
Remit To: The Forbin Project, Inc.
Post Office Box 702
Cedar Falls, IA 50613
Qty. Description Amount
____ Qmodem Registration $30.00 ea __________
____ Qmodem Disk Set (specify 3.5 or 5.25) $20.00 ea __________
____ Qmodem Printed Manual $29.95 ea __________
____ Qmodem Registration & New Disks $50.00 ea __________
____ Qmodem Registration & Printed Manual $59.95 ea __________
____ Qmodem Registration, Disks & Manual $79.95 ea __________
Shipping __________
(Iowa residents add 4% sales tax) Tax __________
Total __________
Payment:
Check [ ] MasterCard [ ] Visa [ ] PO [ ] ________________________
Name: _________________________________________________________________
Company: _________________________________________________________________
Address: _________________________________________________________________
_________________________________________________________________
Work Phone: (____) ________________ Home Phone: (____) _______________
Card #: __________________________________ Exp. Date: ________________
Signature of Cardholder: _________________________________________________
Comments: ________________________________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________
Note: Shipping to 48 continental states is $5.00. Alaska, Hawaii, and
Canada is $10.00. Other countries, please call before ordering.
Second day and Next day air extra, please call.
Qmodem SST 5
Site License Information
If you plan on using Qmodem in a corporation, government office, or for any
business purpose whatsoever, registration is mandatory and the 90 day limited
license is strictly enforced. Quantity discounts are available under a Site
License agreement, described below:
One MASTER copy of Qmodem and of its documentation will be supplied on disk.
The site license customer is responsible for printing the documentation and
copying the disks for distribution. Archival backups of the MASTER copy are not
counted toward the total copies of the license.
For all site licenses, the customer must appoint a single contact person with
whom all Qmodem related dealings will take place. Should a problem occur, that
person -- and that person alone -- must call to report the problem and arrange
for its resolution. All Qmodem program updates will be forwarded to the contact
person. When filling out the order form, please use the contact person's name
to prevent any later misunderstandings.
Site license discount rates are as follows:
Total copiesDiscount
11 - 20 5%
21 - 30 10%
31 - 40 15%
41 - 50 20%
51 - 100 25%
101 - 200 30%
201 - 300 35%
301 - 500 40%
501+ 50%
NOTE: All prices and discounts are subject to change without notice.
Discounts are not cumulative; they apply to separate orders only.
Purchase Orders less than $100 must be pre-paid.
6 The Forbin Project, Inc.
Warranty (or lack of it)
The Forbin Project, Inc. makes no warranty of any kind, express or implied,
including without limitation, any warranties of merchantability and/or fitness
for a particular purpose. The Forbin Project, Inc. shall not be liable for any
damages, whether direct, indirect, special or consequential arising from a
failure of this program to operate in the manner desired by the user. The
Forbin Project, Inc. shall not be liable for any damage to data or property
which may be caused directly or indirectly by the use of this program.
IN NO EVENT WILL THE FORBIN PROJECT, INC. BE LIABLE TO YOU FOR ANY DAMAGES,
INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
CLAIM BY ANY OTHER PARTY.
Definitions
Throughout the documentation, you may run into technical terms or everyday
computer terminology with which you are not familiar. Following are some text
examples you may come across:
ENTER This represents the Return or Enter key on the keyboard. If you see
this in the text, press the Enter key rather than typing in the
string.
ESC This refers to the Esc key on the keyboard.
Alt-[char] Alt- is always followed by a character which means press and hold
the Alt Key and hit the following letter. Alt-A means hold the Alt
key down and press 'A'.
Ctrl-[char]Is executed the same way the Alt- is handled. You press and hold the
Ctrl key and then press the following letter. Ctrl key combinations
may also be specified by the ^ (carat) as in ^T (Ctrl-T).
The following bars represent an image on the screen.
Sample text displayed on the screen.
Qmodem SST 7
Operating Environments
Three multitasking environments are supported:
DESQview from QuarterDeck Systems.
TaskView/OmniView from Sunny Hill Software.
Windows version 3.0 from Microsoft.
DESQview and Windows 3.0 allow Qmodem to run in a window and without requiring
the whole screen.
TaskView takes a slightly different approach and gives Qmodem an entire screen
when the partition is selected. All of these multi-tasking programs let you be
more productive by running other software at the same time as Qmodem.
TIP: The Utilities Disk contains special configuration files for DESQview
and Windows.
Qmodem may not operate properly when other background software is running. By
other background software, we mean programs that are loaded in the CONFIG.SYS,
or by a BAT file and remain in memory. Certain screen clock programs, for
example, are known to interfere with serial port operations.
If you experience loss of incoming data or other unpredictable problems, it is
possible that one of these programs is interfering with Qmodem. Remove these
programs or device drivers from the AUTOEXEC.BAT or CONFIG.SYS file one at a
time until you find the offender.
Another method is to start DOS without any resident programs or device drivers
and add them back in, one at a time, until the culprit is identified. Most
expanded memory drivers, mouse drivers, and hard-disk partitioning software
drivers do not interfere with Qmodem operation.
One program which is known to interfere seriously with serial port operations is
the clock driver supplied with some early memory and multi-function boards.
Conflicts with Qmodem may not be caused by a single program, but by a
combination of programs, which, taken singly, cause no problems. Therefore, if
you suspect some conflict, you should boot your system with only absolutely
necessary device drivers and resident programs (i.e. a partitioned disk device
driver).
8 The Forbin Project, Inc.
Installing Qmodem
Back up your diskettes!
The first thing you should do is back up your Qmodem distribution disks. Always
backup your disks! I can't stress this enough! Please refer to your DOS manual
if you are not sure how to backup your disks.
Floppy Disk Installation
Qmodem diskettes have come pre-installed and you only need to make backups. Be
aware that Qmodem does require one of the following floppy drive setups:
2 - 360K floppy drives
This allows you to use one of the floppy drives for downloading. The drive
with the QMODEM.OVR file must never be removed during operation.
1 - 720K floppy & 1 - 360K floppy
This allows all of the Qmodem files to remain on the 720K drive and allows
the 360K to act as the data disk for downloading and uploading. You should
be able to split the files as if you have 2 360K drives and use the 720K as
your data disk. Again, the floppy with the QMODEM.OVR file must never be
removed during operation.
Copy all of the files from the distribution diskette to a working diskette. The
recommended files on each diskette are as follows:
Disk #1 QMODEM.OVR (overlay for main program)
QMODEM.CNF (configuration file)
QMODEM.FON (Alt-D phone book)
QMODEM.PRE (phone book prefixes)
QMODEM.KEY (function key text)
QM.BAT (startup BATCH file)
COMMAND.COM (to allow shelling to DOS)
Disk #2 QMODEM.HLP (online help)
QMODEM.EXE (main program)
*.SCR (optional script files)
NOTE: When using a single 720K or 1.2mb drive, disks #1 and #2 are combined
on the single floppy.
Qmodem SST 9
Starting Qmodem in a Floppy Setup
Follow these directions:
1. Place a bootable DOS disk in drive A: and press Ctrl-Alt-Del.
2. Place disk #1 in drive A: and disk #2 in drive B:.
3. Type QM and press ENTER at the A> prompt.
4. When the "Terminal mode" message appears on the screen, you can remove disk
#2 from the B: drive and use it as a SCRATCH disk for uploads and download.
NOTE: Before running the Alt-N Setup or accessing the Online Help, make sure
disk #2 is back in the B: drive.
The QM.BAT file should look something like this:
PATH A:\;B:\
B:QMODEM
The first line allows Qmodem to search both drives for files it may need to
allocate. The second line tells DOS to load Qmodem from the B: drive and remain
logged to the A: drive. This is important, because you may want to remove the
B: disk after Qmodem has loaded.
Hard Disk Installation
When installing Qmodem on a hard disk, all of the floppy disks should be copied
into the \QMODEM subdirectory. You should also modify your AUTOEXEC.BAT file as
follows:
1. Add the C:\QMODEM subdirectory to your existing PATH= statement.
2. Add a SET QMODEM=C:\QMODEM (or the name of the subdirectory you create).
This is an environment variable that Qmodem checks when it is loaded. If
it finds one, then it will also search the defined subdirectory for any of
the Qmodem specific files it requires.
Making these two adjustments allows Qmodem to be started from any subdirectory
without needing a special BAT file. You could start Qmodem from your word-
processor directory simply by typing QMODEM at the DOS prompt!
10 The Forbin Project, Inc.
Subdirectory Structure
It is said that a picture is worth a thousand words... Here is a picture of one
possible Qmodem subdirectory setup on a hard disk:
QMODEM─┬─DOWNLOAD
├─HOSTDIR
└─SCRIPTS
The QMODEM\DOWNLOAD directory will be used to store all uploaded and downloaded
file. A separate directory is optional, but having it will make it easier for
you to see what you have transferred.
The QMODEM\HOSTDIR is similar to the QMODEM\DOWNLOAD directory, but is used by
the internal Host mode of Qmodem. Callers to the HOST will be restricted to
this directory.
The QMODEM\SCRIPTS directory is used for script file storage. Keeping scripts
in a dedicated directory makes script maintenance easier. Copy all .SCR files
from the distribution disks to this directory.
Getting Help when you need it
Qmodem features context-sensitive help. As the name suggests, relevant help
information is available for any command as you execute it, just by pressing the
F1 Help Key.
For example... You have the Alt-K window open and pressed F1. The help window
would look like this:
Qmodem SST 11
╒══════════════════════════ Change COM Port (Alt-K) ═══════════════════════════╕
│ │
│ Qmodem can immediately switch between any one of eight communication ports │
│ on computers so equipped. The standard COM1 and COM2 ports are Qmodem │
│ defaults; port definitions beyond COM2 must be specified with the Alt-N/M/P │
│ configuration menu. │
│ │
│ If you have defined additional COM ports, your menu may look something like │
│ this: │
│ │
│ ╒═════════ Set COM Port ══════════╕ │
│ │ Active COM Port is COM1 │ │
│ │ │ │
│ │ 1 COM1 Base(03F8) Irq(04) │ │
│ │ 2 COM2 Base(02F8) Irq(03) │ │
│ │ 3 COM3 Base(03E8) Irq(04) │ │
│ │ │ │
│ │ Your choice : _ │ │
│ ╘═════════════════════════════════╛ │
│ │
│ To select a new serial port, type the desired number from the displayed │
│ list. │
│ │
╘══════════════════════════════════════════════════════════════════════════════╛
░░░░░░░░░░░░░░░ F1-Topic Index AltF1-Previous Topic ESC-Exit ░░░░░░░░░░░░░░
Now, if this isn't what you were looking for, or wanted to get a list of Help
Topics, you just press F1 again. The Topic Index contains all of the major Alt-
commands, and some of the common procedures you might need. It may look
something link this:
12 The Forbin Project, Inc.
╒═══════════════════════════════════ Topics ═══════════════════════════════════╕
│ ■ Help with ONLINE HELP ■ Function Keys (Alt-J) │
│ ■ Moving around in the INDEX ■ Hang Up (Alt-H) │
│ ■ Dialing another System ■ Host Mode (Alt-5) │
│ ─────────────────────────────── Invoice for Ordering (Alt-I) │
│ 8th Bit Toggle (Alt-8) Log File Toggle (Alt-0) │
│ Adding Linefeeds (Shift-Tab) Printer Echo Toggle (Alt-9) │
│ ANSI Music Toggle (Alt-M) Screen Dump (Alt-T) │
│ Backspace <> DEL Toggle (Alt-1) Script File Execution (Alt-F) │
│ Batch Entry Window (BEW) Script Parameters (Alt-F) │
│ Beeps & Bells Toggle (Alt-B) Script QuickLearn (Alt-Q) │
│ Capture File Toggle (^Home) Scroll Back (Ctrl-UpArrow) │
│ Change COM Port (Alt-K) Scroll Back Toggle (Alt-U) │
│ Change Directory (Alt-O) Send BREAK Signal (^End) │
│ Change Drive (Alt-L) Setup - The top menu (Alt-N) │
│ Clear Screen (Alt-C) Split Screen Mode (Alt-S) │
│ Communication Parameters (Alt-P) Status Line Info Toggle (Alt-Enter) │
│ Delete a File (Alt-Y) Status Line Toggle (Alt-Minus) │
│ Dialing Directory (Alt-D) Terminal Emulation (Alt-G) │
│ Directory Display (Alt-W) Translate Tables (Alt-A) │
│ Doorway Keyboard Emulation (Alt-Equal) Upload Protocols (PgUp) │
│ Dos Shell (Alt-R) Video 25-Line Mode (Alt-2) │
│ Download Protocols (PgDn) Video 43/50-Line mode (Alt-4) │
╘════════════════════════════════════════════════════════════════ for more ═╛
░░░░░░░░░░░░░░░ F1-Topic Index AltF1-Previous Topic ESC-Exit ░░░░░░░░░░░░░░
From here, you can jump over to help on other commands, or get more help on how
the Help System works. Help remembers where you have been, so you can retrace
your steps backwards by pressing Alt-F1 back to the original screen.
The online help is not all-inclusive, which is why you are reading this
paragraph. Although the context-sensitive help is as detailed as possible, it
still is no substitute for this documentation.
Summary command help is available from the HOME window by pressing the F1 key,
followed by the desired command key combination. When the F1 key is pressed,
the status line changes to the following display:
░░░░░░░░░░ Select a Command F1-Help ESC-Return to TERMINAL Mode ░░░░░░░░░░
For example, to get summary help for the Translate Table command (Alt-A), press
Alt-A, and the Translate Table summary help window will be displayed.
If you pressed F1 by mistake, press ESC to return to the previous Status Line.
NOTE: Pressing ESC will exit 99.9% of all windows and Qmodem functions
without making any changes.
Upgrading from a previous release
Please refer to the file README.1ST on the first disk. This contains specific
instructions for upgrading from previous releases of Qmodem.
Qmodem SST 13
Command Line Parameters
Certain Qmodem features are (out of necessity) implemented via command line
parameters and have no terminal mode or script command equivalents. Command
line parameters are not case sensitive and may be specified in any order.
The following DOS command-line parameters are valid when starting Qmodem:
/HOST Will invoke the Host Mode immediately after startup. This
option can be used to start an unattended Host system as
soon as the machine is booted, by adding the Qmodem start
command to your AUTOEXEC.BAT file.
/S=SCRIPT.SCR Autoexec Script: the Qmodem script file to be executed
immediately upon startup. The script file must be located
in the script directory as specified in Alt-N/D/S or in
the current directory if the Alt-N/D/S field is blank.
/STATS Shows the technical information while Qmodem is loading.
Such things as: Number of Scroll-back lines, UART detected
and so on.
/REGISTER Can also be specified without the leading '/ / /' character.
This invokes the internal Registration routine to make the
ShareWare version a Fully Registered version.
/VGA=[mode] Allows users of VGA and EGA cards to switch into a non-
standard video mode at start-up. As long as your video
card allows setting the AL register to the desired mode,
this will do the trick.
/VEGAVGA=[mode] An Option Specific to the VEGA VGA cards from Video-7 Inc.
Allows setting an alternate text mode (like 132x43) from
the command line. This is different from the normal /VGA=
command because the Video Seven boards have to load the
registers in a non-standard way.
/R This allows you to restart Qmodem without being prompted
to send the modem init string if you are already online.
The Status Line
While in terminal mode, Qmodem displays many of its operational settings in the
Status Line at the bottom of the screen:
1 2 3 4 5 /-------- 6 --------\ 7
ANSI Offline 38400 8N1 [Home]=Menu FDX 8 LF X B M CP LG PR 21:25:49
NOTE: Some of the special characters used in the status line are unprintable
and may cause erratic printer behavior. These characters were changed
to insure proper printing.
The status line is divided into the following areas:
14 The Forbin Project, Inc.
Area 1:The terminal emulation in effect. In the above example, ANSI emulation
is active.
Area 2:The Online/Offline indicator. When connected to another computer, the
word "Online" will be displayed in this area. When Qmodem is first
started, this indicator should read "Offline". It could also display
either "DOORWAY" or "doorway" if the Alt-= toggle is set ON. The upper
case Doorway means you are Online, while lower case means you are
Offline.
Area 3:The current communication parameters: Baud Rate, Data Bits, Parity, and
Stop Bits. These values will change to reflect changes made with the
Alt-P command, or to reflect the values defined in the Dialing directory
for each number.
Area 4:A short reminder to press the Home key to view the Main Help Menu, which
shows all available commands. Summary help on any Qmodem command may be
obtained directly from the Main Menu as well.
Area 5:The current Duplex (a.k.a. Echo) state. FDX stands for Full Duplex and
HDX stands for Half Duplex. Refer to the Alt-E command for a full
explanation of Duplex mode.
Area 6:The current state of Qmodem Toggles. There are 9 toggles, from left to
right:
8 Hi-bit strip toggle. A "7" means that the high bits are stripped, and
an "8" means all bits are used.
LF Add Linefeed Toggle. If "LF", a Linefeed will be added to all incoming
Carriage Returns. If disabled, this area will be blank.
X XON/XOFF toggle. If "X", Xon/Xoff flow control is active. If this
area is blank, Xon/Xoff flow control is ignored by Qmodem.
B Beeps & Bells Toggle (Shown on-screen as a single musical note). If
present, indicates that Qmodem will generate sounds on the PC's speaker
when specific conditions are met. If this is blank, Qmodem produces no
sounds.
M Music Toggle (Shown on-screen as a double musical note). If present,
indicates that Qmodem will play ANSI Music if found. If blank, Qmodem
will not play ANSI music.
CP Capture Buffer Toggle. If present, indicates that text is being
captured to a file. If blank, incoming text is not captured.
LG Session Log Toggle. If present, indicates that the Session LOG is
active. If blank, the session LOG is not active.
^ Scroll-back Toggle (Shown on-screen by an up-arrow). If present,
Qmodem is capturing incoming data to the scroll-back buffer. If blank,
the scroll-back feature is not active.
PR Printer Toggle. If present, screen text is also sent to the printer.
Qmodem SST 15
Area 7:The last item on the Status Line is the System Clock. When ONLINE, the
clock displays Elapsed-Time (the duration of the call). When OFFLINE,
the clock displays the time-of-day.
The HOME Menu
Pressing the Home key displays the following screen which describes all
available commands :
╒════════════════════════════════ COMMAND MENU ════════════════════════════════╕
│ ─────────────────── BEFORE ─────────────────── ──────── TOGGLES ───────── │
│ Alt-D Phone Book Alt-G Term Emulation Alt-0 Session Log │
│ ─────────────────── DURING ─────────────────── Alt-1 Backspace DEL/^H │
│ Alt-C Clear Screen ^Home Capture File Alt-2 80x25 (EGA/VGA) │
│ Alt-F Execute Script ^End Send BREAK Alt-3 Debug Status Info │
│ Alt-Q QuickLearn PgUp Upload Files Alt-4 80x43/50 (EGA/VGA) │
│ Alt-S Split Screen PgDn Download Files Alt-5 Host Mode │
│ Alt-T Screen Dump Alt-6 Batch Entry Window │
│ Scroll Back Alt-8 Hi-Bit Strip │
│ ─────────────────── AFTER ──────────────────── Alt-9 Printer Echo │
│ Alt-H Hangup Modem Alt-X Exit Qmodem Alt-B Beeps & Bells │
│ Alt-E Half/Full Duplex │
│ ─────────────────── SETUP ──────────────────── Alt-I Order Information │
│ Alt-A Translate Table Alt-N Configuration Alt-M ANSI Music │
│ Alt-J Function Keys Alt-P Change Baud Rate Alt-U Scroll-back Record │
│ Alt-K Change COM Port Alt-Z XON/XOFF Flow Ctrl │
│ Alt-= DoorWay Mode │
│ ──────────────────── DOS ───────────────────── Alt-- Status Lines │
│ Alt-L Change Drive Alt-V View/Edit File ShTab CR/CRLF Mode │
│ Alt-O Change Directory Alt-W List Directory Alt─┘ Status Line Info │
│ Alt-R DOS Shell Alt-Y Delete File │
│ │
╘════════════ Qmodem SST Version 4.2 Production Compiled MM/DD/YY ═════════════╛
░░░░░░░░░░ Select a Command F1-Help ESC-Return to TERMINAL Mode ░░░░░░░░░░
The Home Menu is divided into the following areas:
BEFORE Commands you are likely to use before dialing a system
such as setting terminal emulation and getting into the
dialing directory itself.
DURING Commands you are likely to use while online.
AFTER Commands used to end your online session or exit.
SETUP Commands used to change operational parameters.
DOS Commands which interact with your computer, rather than
with the computer you are calling.
TOGGLES Commands that activate or deactivate certain features.
Operating these toggles is usually done by pressing the
corresponding key combination.
16 The Forbin Project, Inc.
Notice that the Terminal Mode status line changes when the Home Menu is
displayed (see above example) As the Home status line indicates, you can get
summary help for any command by pressing [F1], then the desired command key
combination. Pressing [ESC] returns you to terminal mode.
Qmodem updates or replaces the Status Line to reflect the current environment,
the function being performed, or the command being executed. Check the Status
Line often, it may help you get out of trouble if and when you get stuck!
Qmodem SST 17
QINSTALL
Starting Qmodem for the First Time
If this is your first time, you need to run the program QINSTALL before you can
run Qmodem. This is the installation program that fine tunes Qmodem.
Qinstall is started by typing Qinstall and pressing the Enter key from the DOS
prompt.
After the Qinstall opening screen, you are presented with the Qmodem
Installation Part 1 screen:
QMODEM INSTALLATION PART 1
The file QMODEM.CNF was not found in the current directory or the directory
pointed to by the Environment variable "QMODEM=", so it is assumed this is
a new installation. A few questions will be asked to determine how Qmodem
should be setup for you. Please follow the directions and this will only
take a few minutes.
_______________________________________________________________________________
Display adapter detected : VGA
Do you have a Color monitor connected ? [Y/N]
Qinstall then examines your hardware and tries to determine which video card you
are using. In the previous example, a VGA card was detected. Other
possibilities include Monochrome (which includes Hercules cards), CGA, EGA and
MCGA. If Qinstall cannot figure out your type of adapter, we sure would like to
hear from you about it.
The next question asks if you have a color monitor attached to your video card.
Monochrome displays may be attached to some color adapters. If this is your
case, reply no to this question.
Setup questions are based on the video adapter in your system. The previous
example applied to EGA/VGA/MCGA adapters. If your system is equipped with a CGA
or Monochrome display, the prompts would have changed:
Display adapter detected : CGA
Press any key to test for video snow > _
Did your screen look fuzzy ? [Y/N] _
Do you have a Color monitor connected ? [Y/N] _
Early IBM CGA and cheap clones suffer from snow and flicker when display memory
is accessed. When you to press a key, Qinstall will attempt to generate the
snow or flicker on your display. If irregular, fuzzy patterns or dots appeared
on your screen, reply Y to the Did your screen look fuzzy question.
Monochrome setups are the easiest. Qinstall simply asks you to press any key
to continue.
NOTE: If this is an upgrade from a previous release, Qmodem will read the
existing QMODEM.CNF and skip these questions.
18 The Forbin Project, Inc.
Configuration
Configuring Qmodem is simple, whether you are installing Qmodem for the first
time or upgrading from a previous release. Seasoned Qmodem veterans should read
the section on Menu Navigation and Upgrading from a previous release. First
time users should go through the Installation Section of the manual and ignore
the Upgrade section.
QINSTALL Menu Navigation
The Qinstall Setup Menu will be automatically displayed the first time Qmodem
is started.
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘══════════════════════════════════════════════════════════════════════════════╛
QMODEM INSTALLATION PART 2
The window above is the "Alt-N Setup Menu". With it, you can customize
almost every part of Qmodem. Go through all of the options now to finish
the installation procedure. When you are through, select Exit/Save to
write out the new configuration file.
Press ENTER to Edit the selected option or open a SubMenu.
Press ESC to abort the changes made or close the SubMenu.
╔═══════════════════╗
║ Option A ║
║ Option B ──────────────── Selections that are followed by the
║ ╔═════════════════════╗ character have SubMenus below them.
║ ║ Sub Option B1 ║
╚═║ Sub Option B2 ║
║ Sub Menu Below ║
╚═════════════════════╝
┌─ The Status Line will always give you help on
│ the option you are changing.
Change the way Qmodem looks to you
TIP: Qinstall can be started from inside of Qmodem with the Alt-N command.
The top window is the Alt-N Setup window, which we will refer to as Setup from
here on. Since this is a new installation, it is invoked automatically. The
accompanying text explains how to navigate through the Setup Menus.
NOTE: This text is only shown for first-time installation. Subsequent
calls to Setup only display the Menu Window. As with Qmodem, you have
the complete Online Help system by pressing the F1 key!
Items may be selected with two different methods:
1. By pressing the highlighted letter in the desired menu entry, or
Qmodem SST 19
2. By moving the selection bar to the desired item and pressing ENTER. To
move the selection bar, use the cursor keys.
Menu entries followed by a down-pointing arrow have one or more additional menu
levels. When such an entry is selected, another menu will be displayed from
which additional entries or parameters are configured. Since all Main Setup
Window entries have associated menus, the arrows are omitted.
While in Setup, the status line always displays a brief description of the
currently selected item. If additional information is needed, press the F1 key
for detailed online help.
While changing to an item, pressing ESC restores its original value. To save
the change, press ENTER. Changes to the Setup are not saved automatically; when
done you must use the Exit/Save Top Menu Option to save all changes in the
QMODEM.CNF file.
First Time Setup
Now that you can navigate through Setup menus, let's start with the various
setup tasks from left to right. Colors are first...
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘╒═══════════════════╕═════════════════════════════════════════════════════════╛
│ Custom colors │
│ Blue shades │
│ Purple shades │
│ Red shades │
│ Monochrome shades │
│ LCD Laptop shades │
│ Toggles │
╘═══════════════════╛
Alt-N/V Video
The Video Setup option is used to configure Qmodem screen colors and toggles.
You may select one of 5 pre-defined color combinations, customize the colors to
your liking and set video related Toggles.
The Monochrome and LCD Laptop entries are intended for standard monochrome
displays and Laptop Liquid Crystal Displays (LCD) which can only display shades
of gray.
NOTE: Colors are a cosmetic feature and have no effect on Qmodem's
operation. First-time users should select one of the predefined color
combinations and concentrate on other sections of the Qmodem setup.
Colors may be customized easily after all other operational
parameters.
Alt-N/V/C Custom Colors
Selecting the Custom Colors options yields the following menu:
20 The Forbin Project, Inc.
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘╒═══════════════════╕═════════════════════════════════════════════════════════╛
│ Custom colors │
│╒══ Pick a Field to Color ═══╕
││ Pulldown normal text │
││ Pulldown first letter │
││ Pulldown selection bar │
││ Pulldown window border │
││ Pulldown edit field │
╘│ Window border │
│ Window primary text │
│ Window secondary text │
│ Window Scroll Bar │
│ Screen border │
│ Screen text │
│ Information text │
│ Status Line primary │
│ Status Line secondary │
│ Help border │
│ Help normal text │
│ Help selected xref │
│ Help unselected xref │
╘══════════════ for more ═╛
This is a Pick List of all the possible fields that can be customized. You can
scroll through the list in several way with the Arrow keys being the easiest.
When one of the screen elements is selected, the Qmodem color selection screen
is displayed:
Qmodem SST 21
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘╒═══════════════════╕══════════════╒═════════════ Sample Screen ══════════════╕
│ Custom colors │ │ Option 1 Option 2 Option 3 │
│ B╒══ Pulldown normal text ══╕ │ ╒════════════════╕╒═══ Help Window ════╕ │
│ P│ │ │ │Field in Edit░░░││ Normal text color │ │
│ R│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │Not in Edit░░░░░││ Selected Xref │ │
│ M│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ ╘════════════════╛│ Unselected Xref │ │
│ L│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │ Highlite text │ │
│ T│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ ╘════════════════════╛ │
╘══│ ■ ■ ■ ■ ■ ■ ■ ■ │ │AT │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │OK ╒════ Frame Color ═════╕ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │Primary window text │ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │Secondary text │ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │Scroll Bar text │ │
│┌───┐■ ■ ■ ■ ■ ■ ■ │ │ ╘══════════════════════╛ │
││ ■ │■ ■ ■ ■ ■ ■ ■ │ │ │
│└───┘■ ■ ■ ■ ■ ■ ■ │ │ ╒═══════ Full Screen Edit ═══════╕ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │ Normal Text │ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ │ Marked Text │ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │ ╘════════════════════════════════╛ │
│ ■ ■ ■ ■ ■ ■ ■ ■ │ │Information message text │
│ │ │░░░░ Status Line Primary Secondary ░░░░│
╘══════════════════════════╛ ╘══════════════════════════════════════════╛
ARROWS - Move Indicator ENTER-Accepts ESC-Exit
At the left of the screen is a color chart showing all possible foreground and
background color combinations. To the right is a sample of all the windows that
Qmodem and Qinstall will display. The top of the left window tells you which
selection you are changing. In the example, the Pulldown Normal Text is being
modified.
To select a color, move the square color selector box in the left window with
the arrow keys. The change is immediately reflected in the Qmodem mini-screen
on the right side of the display.
Pressing ESC restores the item's original color. To confirm the color change,
press ENTER. All color changes will take effect immediately.
NOTE: Color changes must be saved explicitly via the Alt-N Exit/Save menu
option. If the new color settings are not saved, the last color setup
will be restored the next time Qmodem is started.
Alt-N/V/T Toggles
The Toggles menu lets you set such things as how characters should be displayed,
how windows in Qmodem should be displayed, and how to handle certain types of
incoming data. The menu looks like this:
22 The Forbin Project, Inc.
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘╒═══════════════════╕═════════════════════════════════════════════════════════╛
│ Custom colors │
│ Blue shades │
│ Purple shades │
│ Red shades │
│ Monochrome shades │
│ LCD Laptop shades │
│ Toggles │
╘══╒════════════════════════╕
│ BIOS video OFF │
│ Linefeed after CR OFF │
│ Snow checking OFF │
│ Growing windows OFF │
│ STatus line ON │
│ Destructive bksp OFF │
│ LIne Wrap ON │
│ Video Restore OFF │
│ Jump Scroll ON │
│ Emulation ANSI │
╘════════════════════════╛
Alt-N/V/T/B BIOS Video
When OFF, Qmodem writes directly to screen memory, which results in extremely
fast screen displays. When ON, all screen displays are performed via calls
to the system's ROM BIOS, and screen displays are much slower. BIOS Video
mode must be ON when Qmodem operates under multi-tasking software such as
DoubleDOS or Windows 3.0.
NOTE: This only applies to the text displayed that is received from the
serial port. Qinstall and most windows in Qmodem still write directly
to video memory.
TIP: Qmodem is fully DESQview aware. When running Qmodem under DESQview,
set BIOS Video mode to NO. With other multi-tasking programs, you
should experiment with this setting to determine the best operating
mode.
Alt-N/V/T/L Linefeed after CR
Setting this ON causes Qmodem to add a linefeed (LF) character after every
carriage return (CR) character. This may be needed if text lines seem to
overwrite the previous line on the screen. This toggle can be changed with
the Shift-Tab command.
Alt-N/V/T/S Snow Checking
Qmodem SST 23
Older CGA display adapters (and some CGA clones) may exhibit "snow" when
video memory is accessed. If this is the case, set this toggle to ON.
Qmodem will use a different memory access method which may help alleviate the
problem. This toggle is not used if your system is equipped with an MDA,
EGA, or VGA display.
TIP: While running under DESQview, you can set this to OFF for slightly
improved display speed.
Alt-N/V/T/G Growing Windows
Controls the method used to display windows on screen. When ON, windows will
grow or explode onto the screen. When OFF, windows will pop onto the screen
instantly.
Alt-N/V/T/T Status Line
This toggle controls displaying of the status line (the last line of the
physical screen). When OFF, the Qmodem status line is not displayed and the
last screen line is available for incoming text display. When ON (the
default), the status line is used to display the status of the Terminal mode
and options of various command windows.
NOTE: The Screen will clear when this is toggled ON and OFF.
Alt-N/V/T/D Destructive Backspace
This controls whether or not the character to the left of the cursor is
erased when a Backspace character (^H or DEL) is received. When ON, the
character is erased before the cursor is moved to the left. When OFF, the
cursor moves leaving the character to the left untouched.
Alt-N/V/T/I Line Wrap
This controls how the cursor reacts when it writes a character in the last
column on the screen (usually column 80). When set ON, the cursor moves the
next line down, performing a Line Feed if the cursor was on the last line on
the screen. When set OFF, the cursor writes the character in the last
column, but does not advance to the next line.
24 The Forbin Project, Inc.
Alt-N/V/T/V Video Restore
When set ON, Qmodem will attempt to restore the original mode of your video
card to the settings prior to starting Qmodem. If you want to leave the last
video mode that Qmodem is using active upon exit, set this to OFF.
Alt-N/V/T/J Jump Scroll
This allow changing the method used to scroll the screen. If you have a CGA
card (the ones that cause snow), you may want to set this OFF to see if the
screen scrolls more smoothly. The default mode is ON to be compatible with
the previous releases of Qmodem.
Alt-N/V/T/E Emulation
The default terminal emulation mode used by Qmodem. When the cursor is
located in this field, pressing ENTER presents a submenu with the list of
available emulations. Use the up and down arrow keys to select the emulation
you need and press ENTER.
Alt-N/M Modem
Modem-dependent settings affect the interaction between Qmodem, your computer,
and your modem. If you use a 2400bps Hayes Smartmodem (or compatible) attached
to COM1, most of Qmodem's default modem parameters are correct. However, the
modem setup must be reviewed to insure that specific parameters are set
properly.
Selecting the Alt-N Modem option yields the following menu:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Quick Modem Config! │
│ Toggles │
╘════════════════════════════╛
Qmodem SST 25
Alt-N/M/C Communications Parameters
These hardware parameters control the operation of the communication port and
its interaction with the modem. When the Communication parameters option is
selected, the following menu is displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Mo╒═════════════════════════════════════════════════╕
│ Po│ A - Default baud rate 2400 │
│ Qu│ B - Default data bits 8 │
│ To│ C - Default parity None │
╘═══│ D - Default stop bits 1 │
│ E - Command before baud change ░░░░░░░░░░░░░░ │
│ F - Command after baud change ░░░░░░░░░░░░░░ │
│ G - Cycle delay 10 │
│ H - Timeout delay 60 │
│ I - Modem command delay 10 │
│ J - Serial port 1 │
╘═════════════════════════════════════════════════╛
Alt-N/M/C/A Default Baud Rate
The Baud Rate is the speed at which the COM port operates and should match
the modem's speed. Supported speeds are 110, 300, 1200, 2400, 4800, 9600,
19200, 38400, 57600 and 115200. The default baud rate is 2400.
NOTE: With many error-correcting and high-speed modems, the COM speed can
be set higher than the modem's nominal communications speed. For
example, the USR Courier HST modem, rated at 9600 baud, supports a COM
speed of 38400 baud. Consult your modem manual for additional
information on supported COM speeds.
Alt-N/M/C/B Default Data Bits
Characters transmitted over phone lines are made up of data bits. For
systems which support text and binary program file transfers (IE., most PC-
based BBS systems), 8 data bits are required. When communicating with
mainframe or minicomputer-based systems, 7 data bits is often used.
Supported settings are 7 and 8. This setting must match that of the software
operating on the remote computer.
Alt-N/M/C/C Default Parity
Parity is used to insure the validity of the data being transmitted and
received. Parity values are None, Odd, Even, Mark and Space. This value
must match that used by the computer being called. Most BBS's use None (no
parity), the default value.
Alt-N/M/C/D Default Stop Bits
26 The Forbin Project, Inc.
Stop bits are generated by the UART to isolate transmitted characters. The
majority of computer systems require 1 stop bit, the default value.
Supported values include 1 and 2. As with other parameters, this value must
match the other computer's setting.
Alt-N/M/C/E Command Before Baud Change
This string is sent to the modem before the serial port speed is changed.
The default value is blank. Non-standard modems may require a different
value.
Alt-N/M/C/F Command After Baud Change
This string is sent to the modem after the serial port speed is changed. The
default value is blank. Non-standard modems may require a different value.
Alt-N/M/C/G Cycle Delay
The Cycle Delay is the number of seconds Qmodem waits after an unsuccessful
dial (IE., a BUSY signal) before trying the next number in the dialing queue
(or the same number again). The default value is 10 seconds.
Alt-N/M/C/H Timeout Delay
The Timeout Delay is the number of seconds Qmodem waits for a connection
after dialing a number. When this period has expired, Qmodem will instruct
the modem to hang up. The default value is 60 seconds.
TIP: Most modems feature an internal timeout delay. When dialing, the
shortest delay will prevail. Make sure that your modem's internal
timeout value is at least equal to the Qmodem setting. In Hayes and
compatible modems, the command ATS7=60 will set the modem's internal
delay to 60 seconds. Increasing the modem's own timeout value allows
total control over the dialing process.
Qmodem SST 27
Alt-N/M/C/I Modem Command delay
This is the delay, in milliseconds (1000 = 1 second) inserted between
characters sent to the modem while it is OFFLINE. The default value is 0.
Some high-speed modems may require a non-zero value if commands are not
recognized, or if the modem does not return an OK acknowledgment. The most
common symptoms are the modem's lack of an OK response when first
initialized, or the modem's inability to dial.
Alt-N/M/C/J Serial Port
This is the port number (1-8) to which the modem is attached. The default is
port 1. For port addresses higher than 2 be sure to configure the Base
address and IRQ in the Alt-N/M/P menu.
TIP: The default Speed, Parity, Data bits and Stop bits values are not
fixed. Defaults can be overridden in each dialing directory entry to
match the settings of the remote computer.
Alt-N/M/M Modem Commands
Modem commands define the text of messages sent to the modem to cause a specific
action (IE., dial, hang up), or received from the modem to acknowledge a command
(IE., OK, ERROR), or reflect a specific condition (IE., BUSY, CONNECT, NO
CARRIER).
When the Modem Commands option is selected, the following menu is displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Po╒════════════════════════════════════════════════════╕
│ Qu│ Initialization Command ATE1Q0X1V1S7=60^M░░░░░░░ │
│ To│ Prefix Dial Command ATDT░░░░░░░░░░ │
╘═══│ Suffix Dial Command ^M░░░░░░░░░░░░ │
│ Connect Message CONNECT░░░░░░░ │
│ 1st Error Message NO CARRIER░░░░ │
│ 2nd Error Message BUSY░░░░░░░░░░ │
│ 3rd Error Message NO DIAL TONE░░ │
│ 4th Error Message VOICE░░░░░░░░░ │
│ Abort Dial Command ^M░░░░░░░░░░░░ │
│ Hangup Command ^~^~^~+++^~^~^~ATH^M░░ │
│ Redial Cancel Text RING░░░░░░░░░░ │
╘════════════════════════════════════════════════════╛
28 The Forbin Project, Inc.
Alt-N/M/M/I Initialization Command
Default: AT E1 Q0 M1 X1 V1 S7=60^M
This command resets Hayes and compatible modems to their standard operating
parameters. This command may vary depending on the modem being used; consult
the modem manual.
Alt-N/M/M/P Prefix Dial Command
Default: ATDT
This command is used to tone-dial a number on Hayes and compatible modems.
It is sent to the modem immediately before the telephone number to be dialed.
For pulse-dialing, change this to ATDP.
The dialing commands may vary depending on your modem brand. Consult the
modem manual for additional information. If your modem requires a 150
millisecond BREAK signal for dialing, change this command to the word BREAK.
TIP: Adding *70 after the ATDT dial command can be used to disable call-
waiting on some tone-dialing phone systems. Adding 1170 after the ATDP
dial command can be used to disable call-waiting on some pulse-dialing
phone systems. Check with your phone company to see if these features
are supported.
Alt-N/M/M/S Suffix Dial Command
Default: ^M
This string immediately follows the number to be dialed. Should your modem
require a different End-of-Command character, you should place it here.
Alt-N/M/M/C Connect Message
Default: CONNECT
The message returned by the modem when a successful connection has been
established. Most modems will also return the connect speed as part of the
message, IE: CONNECT 2400. Do not include a speed value as part of this
message. Doing so will prevent a connection if the baud rate is different
from the one you entered.
Alt-N/M/M/1 Error Message 1
Alt-N/M/M/2 Error Message 2
Alt-N/M/M/3 Error Message 3
Alt-N/M/M/4 Error Message 4
Defaults: BUSY
NO CARRIER
NO DIAL TONE
NO CONNECT
These error messages are returned by the modem when the connection could not
be established. Your modem may return different messages; refer to the
manual for additional information.
Qmodem SST 29
NOTE: Many modems can be set to return Numeric result codes rather than
Verbose result codes. . Although either can be used, you should use
the more descriptive verbose messages. If the modem is set to return
numeric codes, Qmodem will not be able to determine the connect
speed.
Alt-N/M/M/A Abort Dial Command
Default: ^M
This string will be sent to the modem when a dial request is to be cancelled
(IE: pressing ESC from the dialing directory screen while dialing is in
progress). Most modems accept ^M. If the modem supports dropping DTR as a
disconnect method, the word DTR (Data Terminal Ready)should be entered in
this field. Consult the modem manual for information on this feature.
Alt-N/M/M/H Hangup Command
Default: ^~^~^~+++^~^~^~ATH0^M
This command will cause Hayes and compatible modem to hang up. Each ^~ pair
causes a 1/2-second delay. In the example above, the +++ modem escape
sequence is preceded and followed by a 1.5 second delay. This delay,
referred to as escape guard time is required for the modem to recognize the
escape sequence and switch to command mode. The ATH0^M command then
instructs the modem to go on-hook (hang up).
For modems which recognize dropping of the DTR signal as a disconnect method,
specify the word DTR in this field. To hang up, Qmodem disables the DTR
signal, pauses, and then re-establishes it. This hardware-only method, if
supported by your modem, is far more reliable than using a modem software
command which could easily fail (IE., because of line noise). The reason
the DTR method is not the default is, unfortunately, not all modems support
DTR disconnect control.
Specifying BREAK will send the modem BREAK signal for 150 milliseconds. Some
modems attached to PBX (Public Board eXchange, a.k.a. switchboard) require a
BREAK in order to disconnect a call.
Alt-N/M/M/R Redial Hangup Text
Default: RING
This message text, when received, will cause Qmodem to stop dialing
immediately. If you are sharing a voice line with your modem, this allows
you to answer the phone personally. If your modem is connected to its own
dedicated phone line, this field can be left blank.
Alt-N/M/P Port Addresses
30 The Forbin Project, Inc.
Port addresses are hardware-dependent values which define the computer's
communications ports. Qmodem allows you to define up to eight communication
ports (COM1 through COM8). Two COM ports (COM1 and COM2) are standard for most
IBM PC, XT, AT, PS/2 and compatible machines. This does not mean that all
machines have both ports. These are optional. You still have to verify which
ports you have available.
NOTE: An internal modem take up a COM port. If you have two ports in your
machine (COM1 and COM2), you CANNOT set the internal modem to either
COM1 or COM2 and expect it to work. You should set the internal modem
to the first available port. (in this example, it should be
configured for COM3)
Because it is possible to install an internal modem or additional
serial port so that it shares an IRQ with another device, you should
declare all the installed serial ports in Qmodem. This allows Qmodem
to disable other ports that may conflict with the port you are trying
to use. It a port is disabled, it will be enabled if you exit Qmodem
or select another port with Alt-K.
Qmodem SST 31
When the Port Address option is selected, the following menu will be displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Qu╒═════════════════════╕ │
│ To│ A - COM1 Base 03F8 │ │
╘═══│ B - COM2 Base 02F8 │══╛
│ C - COM3 Base 0000 │
│ D - COM4 Base 0000 │
│ E - COM5 Base 0000 │
│ F - COM6 Base 0000 │
│ G - COM7 Base 0000 │
│ H - COM8 Base 0000 │
│ I - COM1 IRQ 4 │
│ J - COM2 IRQ 3 │
│ K - COM3 IRQ 0 │
│ L - COM4 IRQ 0 │
│ M - COM5 IRQ 0 │
│ N - COM6 IRQ 0 │
│ O - COM7 IRQ 0 │
│ P - COM8 IRQ 0 │
╘═════════════════════╛
Alt-N/M/P/ A-H COMx Base Address
These are the computer's COM port hardware addresses. Qmodem supports
default assignments for two serial ports, COM1: and COM2:. For PC/XT/AT and
compatibles equipped with IBM-standard adapters, the port address and IRQ
assignments need not be changed.
Non-PS/2 computers can address COM3: through COM8:. Internal modems usually
have the following Base Address assignments:
Port Base IRQ
Number Address
COM3 3E8 4
COM4 2E8 3
Be sure to read your manual that comes with your internal modem to verify
these setting.
CAUTION: If you intend to install an internal modem as COM3 or COM4,
and it is going in a computer that is not EISA or MC bussed, then
try to set the IRQ to a value other than 4 or 3. On an AT, try 5
or 2. Not all internal modems allow you to change the IRQ and
this may not apply to you. If you cannot set an IRQ other than 4
or 3, then be aware that Qmodem will disable COM1 or COM2 while
you are using the modem. (IE: if you have a serial Mouse on COM1
and your internal modem is set for COM3, then the mouse will be
disabled while in Qmodem.
32 The Forbin Project, Inc.
IBM PS/2 computers also support COM3: through COM8: with the following
assignments:
Port Base IRQ
Number Address
COM3 3220 3
COM4 3228 3
COM5 4220 3
COM6 4228 3
COM7 5220 3
COM8 5228 3
NOTE: On non-PS/2 machines, port assignments above COM2 are non-standard.
Refer to the adapter or internal modem's documentation for specific
hardware information.
Alt-N/M/P/ I-P COMx IRQ
The IRQ (Interrupt ReQuest) value must be known for the serial ports to be
accessed. When specifying Base addresses for non-standard COM ports, you
must also set the correct IRQ values.
Failure to set the IRQ will prevent Qmodem from accessing the COM port and
will make communications impossible. (You also stand a good chance of
locking up your computer! Trust me, I've done it several times!)
Refer to the previous example for setting up a PS/2 COM3: or COM4: board.
Alt-N/M/Q Quick Modem Config
This is probably the single most wanted feature in a communication program... A
method to quickly configure your new modem to work! It's not like the old days
where we had just a handful of modem commands and everybody knew them by heart.
Now we have High-Speed modems with things like MNP and V.32 and V.42 and Speed
Buffering and on and on and so forth. Each modem maker that enhanced upon the
Hayes standard had to come up with their own new commands. To add to the
confusion, some have the same command(s), but mean different things to different
modems!
Enter Quick Modem Config! It takes the worry and confusion out of setting up
your complex modem. Everything in the modem and Qmodem is setup all at once
with a minimum of user intervention. Like the commercial said, "Set it, and
forget it."
The heart of Quick Modem Config (herein called QMC) is the QMODEM.MDF file.
This is the Modem Definition File that QMC uses to configure your modem and
Qmodem. As new modems are added to the MDF file, we post the new version on our
BBS.
The QMC window looks something like this:
Qmodem SST 33
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Quick Modem Config! │
╒══════════ Pick a modem to install ══════════╕
│ Anchor 2400i Internal Half-card │
│ ATI 2400etc (non V.42) │
│ Cermetek INFO-MATE 212A │
│ Everex 12e External (EV-936) │
│ Everex 24e External (EV-945) │
│ Everex Evercom 24+ MNP │
│ Fastcomm FDX 2424 (MNP Class-5) │
│ Fastcomm FDX 2496 │
│ Fastcomm FDX 9696 (V.32 & MNP-5) │
│ Generic 1200 Baud Hayes clone │
│ Generic 1200 Baud Hayes clone (switchless) │
│ Generic 2400 baud Hayes clone │
│ Generic 2400 Baud Hayes clone (switchless) │
│ Hayes SmartModem 1200 External │
│ Hayes SmartModem 1200B Full Card Internal │
╘═══════════════════════════════ for more ═╛
NOTE: Your list of modems may differ if Qmodem was bundled with a modem or
was added to since this manual went to print.
This is another Pick List. You move the Scrollbar to highlight your modem from
the list and press ENTER. If your modem does not appear in the list, call us.
We may have added it to the MDF file and have it posted for download. In the
meantime, you can probably use one of the Generic entries to get you going.
Depending on the modem, there are up to 4 different windows that may pop up
during the process.
1.Speed Detection.
2.Hardware Notes.
3.Modem Init Commands.
4.Additional Notes.
Just follow the directions in each window as it is displayed.
Ok, your modem is in the list, and you want to get going! Let's say you have a
MultiTech MT224 EH7 external and have selected it.
The screen will look something like this:
34 The Forbin Project, Inc.
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Quick Modem Config! │
╒════ Hardware notes for MultiTech MultiModem MT224EH7 (MNP 7) ═════╕
│ Switch Settings on the Bottom of the modem: │
│ 4 Switch Bank 1 2 3 4 │
│ D U D D │
│ 8 Switch Bank 1 2 3 4 5 6 7 8 │
│ U U D U D U U D │
│ │
│ Jumpers that need to be changed -inside- the modem: │
│ CTS/RTS: toward the back of the modem. │
│ ( Tap any key to continue ) │
╘═══════════════════════════════════════════════════════════════════╛
If you get a Hardware Notes window (like above), follow the directions. Do not
skip any steps! There is always a reason for moving jumpers or switches.
After you have done what is asked, just tap any key to continue.
The MultiTech then gets the next window:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Quick Modem Config! │
╒═════════════════ Modem Init Commands being sent ══════════════════╕
│AT$A0&B0&BS0&C1$D0&D2$F1^M │
│AT&G0#L0$MI0&M0$R1&R1&S1^M │
│ATB1E1M1Q0R0V1X4&Q0^M │
│AT&E1&E4&E8&E10&E13&E15^M │
│AT$MB2400$SB19200$BA0&W0^M │
│Send these commands to the modem [Y/N] ? _ │
│ │
│ │
│ │
│ │
│ │
╘═══════════════════════════════════════════════════════════════════╛
The Modem Init Commands window contains a list of modem commands that to be sent
to the modem. Just in case, there is a prompt to confirm the sending of these
commands. 99.9% of all users should answer Y to this prompt. Besides, failure
to do so will not guarantee correct operation in Qmodem.
Qmodem SST 35
You should verity that the modem responds OK to each line that is displayed.
Like this:
╒═════════════════ Modem Init Commands being sent ══════════════════╕
│AT$A0&B0&BS0&C1$D0&D2$F1 │
│OK │
│AT&G0#L0$MI0&M0$R1&R1&S1 │
│OK │
│ATB1E1M1Q0R0V1X4&Q0 │
│OK │
│AT&E1&E4&E8&E10&E13&E15 │
│OK │
│AT$MB2400$SB19200$BA0&W0 │
│OK │
│ ( Tap any key to continue ) │
╘═══════════════════════════════════════════════════════════════════╛
And finally, the Additional Notes window:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Quick Modem Config! │
╒════════════════════════ Additional notes ═════════════════════════╕
│ The 224EH7 is now configured for 19200 baud operation. Be sure │
│ to set all your dialing directory entries to 19200 to get the │
│ best speed on all calls. Note: Data compression was enabled with │
│ the &E15 command. Be sure to read your modem manual and double- │
│ check the setup. Remember to Exit/Save to save these changes! │
│ ( Tap any key to continue ) │
╘═══════════════════════════════════════════════════════════════════╛
This is a list of parting comments that are specific to your particular modem.
You should at least read it. TA-DA! Your modem and Qmodem are now set!
Alt-N/M/T Toggles
These Toggles are specific to modem operations. The menu looks like this:
36 The Forbin Project, Inc.
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘════╒════════════════════════════╕════════════════════════════════════════════╛
│ Communication Parameters │
│ Modem Commands │
│ Port Addresses │
│ Quick Modem Config! │
│ Toggles │
╘═══╒══════════════════════════╕
│ Xon/Xoff flow ON │
│ CTS/RTS flow ON │
│ CTS when Writing OFF │
│ FIFO during Shell OFF │
│ Lock DTE Baud Rate ON │
│ High Speed Xmit ON │
│ 16550 UART Enable ON │
│ Init ignores CD OFF │
╘══════════════════════════╛
Qmodem SST 37
Alt-N/M/T/X Xon/Xoff Flow Control
Xon/Xoff is a software flow control protocol used during normal text and
ASCII transmissions. This toggle can also be changed from terminal mode with
the Alt-Z command.
XOFF and XON are ^S (Ctrl-S) and ^Q (Ctrl-Q) characters, respectively. Most
BBS and mainframe systems use XOFF and XON as a method of pacing text data
transmissions. If the XON/XOFF toggle is ON, Qmodem will send the XOFF
character when its receive buffer is almost full, and will display the
following message on the Status line:
Buffer FULL - Keyboard Input Suspended - Please Wait
As text is displayed, the receive buffer empties and can accept more data.
Qmodem then sends the XON character to resume transmission and restores the
normal status line.
NOTE: The XON/XOFF software flow control is not used during Binary file
transfer protocols.
Alt-N/M/T/C CTS/RTS Flow Control
When set to ON, Qmodem implements hardware handshaking between the modem and
computer. This is required for high-speed and error-correcting modems.
Since additional signals are required to implement hardware handshaking, make
sure that your external modem cable (if any) supports the CTS and RTS signal
lines.
Alt-N/M/T/W CTS when Writing
This toggles controls CTS/RTS hardware flow control when writing to disk
during a binary file download. When this toggle is OFF, Qmodem drops the RTS
signal while writing data to the disk, and raises RTS after the data has been
written.
When this toggle is ON, the RTS signal remains on during the disk writes.
This allows Qmodem to overlap disk and serial port activity while downloading
data on systems equipped with hardware-handshaking modems (IE, high-speed or
MNP modems). For this option to work properly, the Alt-N/M/T/C flag must be
ON.
Normally, the RTS (Request To Send) signal line is dropped low (turned off)
whenever a block of data is being written to disk. This stops the modem from
sending data to the computer during that time, which could cause data loss
due to a missed interrupt.
TIP: If your computer and hard disk are fast enough, you can gain a small
but measurable increase in download speed by using this option.
CAUTION: If you are downloading across a network to a file server
drive, it is strongly recommended that you do NOT use this option.
38 The Forbin Project, Inc.
Alt-N/M/T/F FIFO during Shell
This toggle only applies to systems with serial adapters equipped with a
16550 or 16550A UART, which feature a First-In, First-Out (FIFO) data buffer.
When ON, Qmodem leaves the 16550/16550A UART in FIFO mode. When OFF, Qmodem
disables the FIFO buffer, and the 16550x UART runs in 16450 compatibility
mode.
Some external transfer protocols may require this toggle to be OFF for
correct operation. If your external transfer program aborts immediately upon
startup, try setting this to OFF and execute the external again.
NOTE: This toggle only works if Qmodem detects the 16550/16550A UART in your
system at startup.
TIP: In testing Qmodem 4.2, FIFO buffer operation improved performance in
systems running under DesqView and equipped with high-speed modems.
CAUTION: Problems may occur when upgrading from an 8250 or 16450 UART
to the newer 16550/16550A chips. While they are pin-compatible,
the 16550 series are a superset of the older chips and require
additional connections not used in the older components. Some
serial adapters made specifically for the older chips may not be
able to operate properly with the newer chips.
Alt-N/M/T/L Lock DTE Baud Rate
When set to OFF, Qmodem will set the serial port speed to the connect speed
identified in the modem's CONNECT message. When ON, Qmodem maintains the
serial port speed defined in the phone book entry being dialed.
Qmodem SST 39
Alt-N/M/T/H High Speed Xmit
When set ON, Qmodem uses an interrupt driven transmit routine for better
performance. When set OFF, a "brute force" method of sending data is used
(and as such, is a tad slower). Some UART-CPU combinations may not be able
to handle the faster ON mode and you should leave this set OFF.
Alt-N/M/T/1 16550 UART Enable
When set ON, Qmodem enables the 16550 (and 16550A) FIFO Buffer for both
transmit and receive. We can't imagine why you would want to disable this
feature if you have the 16550, but here is the toggle anyway.
Alt-N/M/T/I Init Ignores CD
When set ON, the Modem Init String (Alt-N/M/M/I) will be sent on startup
regardless of the detection of a Carrier. Some modems always default to
reporting Carrier Detected (CD) until told to report the true state of
carrier. Unfortunately, this causes a catch-22. Qmodem paused asking
whether or not to send the Modem Init if Carrier was present, and the Modem
Init String may have a command to override this. If you have such a modem,
you will surely appreciate this switch!
Alt-N/D Directories
Qmodem directories are defined in the Directories Menu. When selected, the
following window is displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘══════════════╒═════════════════════════════════════════════╕═════════════════╛
│ Upload D:\QMODEM\DL\░░░░░░░░░░░░░░░░░ │
│ Download D:\QMODEM\DL\░░░░░░░░░░░░░░░░░ │
│ Scripts D:\QMODEM\SCRIPTS\░░░░░░░░░░░░ │
│ SWAP D:\░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ 1st Batch D:\QMODEM\DL\░░░░░░░░░░░░░░░░░ │
│ 2nd Batch D:\░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ 3rd Batch D:\░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ AltW Pick D:\DL\*.*░░░░░░░░░░░░░░░░░░░░░ │
╘═════════════════════════════════════════════╛
Note that all the fields in this menu are added and edited manually, following
the procedures outlined earlier in this section.
Alt-N/D/U Upload
40 The Forbin Project, Inc.
The default drive:\directory which will be searched for files which are
uploaded to the remote computer. If this field is left blank, the current
directory will be searched. This directory will be displayed in the file
allocation window following the PgUp upload command for non-batch protocols.
If you exchange many files with remote computers, you may want to assign the
same directory for uploads and downloads.
Alt-N/D/D Download
The default drive:\directory into which downloaded files will be stored. If
this field is left blank, files will be stored into the current directory.
This directory will be displayed in the file allocation window following the
PgDn download command. If you exchange many files with remote computers, you
may want to assign the same directory for uploads and downloads.
Alt-N/D/S Scripts
The drive:\directory path which will be searched for all Qmodem script files.
If this directory is not defined correctly, scripts files will not be
accessible.
Alt-N/D/W SWAP
The drive:\directory path where the Shell to DOS will write a SWAP file if
there is insufficient EMS memory, or EMS has been disabled (via Alt-N/O/R/E).
If left blank, then the current drive:\directory will be used.
The filename created is called QMODEM.$$$ and is marked Read-Only/Hidden.
This is to remove temptation to delete the file while shelled to DOS. Doing
so will likely cause a lockup.
Alt-N/D/1 1st Batch
Alt-N/D/2 2nd Batch
Alt-N/D/3 3rd Batch
These three drive:\directories are the defaults for the Alt-6, Batch Entry
Window. This is to save time if you are always doing Batch Uploads from the
same directory or directories. For more information on how they are used,
refer to the Alt-6 command.
Qmodem SST 41
Alt-N/D/A Alt-W Pick
This is the default drive:\directory\picture-mask for the Alt-W command.
Earlier releases defaulted to *.* or blank. Now you can set the default to
your download directory, your word processor documents directory or even your
spreadsheet WKS directory.
An example might be: C:\WORD\DOCS\*.DOC
NOTE: The above are all DEFAULT directories. Uploads, downloads, and script
commands all use the standard File Allocation Window (FAW) which
allows directory specifications to be changed before the commands are
executed.
The Batch directories can also be overridden in the Batch Entry Window
(BEW) at runtime.
Alt-N/H Host
If you plan on using Qmodem's Host Mode, be sure to read the Host documentation
section completely. When the Host option is selected, the following menu is
displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘═════════════╒═══════════════════════════════════════════════════╕════════════╛
│ Type of System OPEN │
│ Download Dir ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ Upload Dir ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ Maximum Time 60 │
│ DOS Password PASSWORD │
│ Shutdown Password PASSWORD │
│ Init Command ATE1Q0V1M1H0S0=0^M░░░░░░░░░░░░ │
│ Answer Command ATA^M░░░░░░░░░ │
│ OK Message OK░░░░░░░░░░░░ │
│ Ring Detect RING░░░░░░░░░░ │
│ Busy Command ATM0H1^M░░░░░░ │
│ # Rings & Answer 1 │
╘═══════════════════════════════════════════════════╛
The Qmodem Host mode operates as a mini Bulletin Board System, complete with
electronic messages, sysop chat, and file transfer capabilities.
Alt-N/H/T Type of System
Press ENTER to cycle through the 3 possible settings: OPEN, CLOSED and
CALLBACK.
An OPEN system is easiest to setup and get running. As new callers log in,
the Host Password (.PWD) file is automatically updated. All new users are
assigned a security level of 0.
42 The Forbin Project, Inc.
In a CLOSED system, authorized callers' names and passwords must be defined
in the Password file before callers are given access. If the caller's name
is not on file, the Host issues a polite "Sorry, this is a closed system"
message and hangs up.
CALLBACK mode is similar to a CLOSED system in that it requires the callers'
name and passwords to be in the Password file. In addition, CALLBACK
requires that the callers' DATA Phone Number also be on file. When callers
log on successfully, they will be instructed to hang up and place their modem
into Auto-Answer mode. The Host will then hang up and immediately dial the
caller's data phone number. CALLBACK is a very secure system since it
insures that all communications originate from known locations.
Alt-N/H/D Download Dir
This is the Host Mode equivalent of the Qmodem default download directory.
Any valid DOS directory may be entered in this field. All files available
for download from the Host must be stored in this directory. The Host "File
List" command will produce a list of the files in this directory.
Example: C:\QMODEM\HOSTDIR\
Alt-N/H/U Upload Dir
This is the Host equivalent of the Qmodem default upload directory. Any
valid DOS directory may be entered in this field. All uploaded files will be
stored into this directory. If the Upload and Download directories are the
same, all uploaded files become public and are available for download.
Example: C:\QMODEM\HOSTDIR\UPLOADS\
Alt-N/H/M Maximum Time
This defines the maximum time allowed per call, in minutes. The default
value is 60 minutes, or 1 hour. The maximum time allowed is 999 minutes (16
hours 39 minutes).
Qmodem SST 43
Alt-N/H/O DOS Password
The password required to "Drop to DOS" from remote. If this field is left
blank, all callers may drop to DOS.
Alt-N/H/S Shutdown Password
Used to restrict access to the Host Shutdown command. It is strongly
recommended that the Shutdown Password be unique and given out only to your
most trusted friends. If the correct password is entered, the system hangs
up immediately and Host mode is terminated.
Alt-N/H/I Init Command
This command string is sent to the modem each time Host mode is initialized
and after each call. The Host Initialization string should set Verbose
result codes (Q0V1), no Auto-Answer (S0=0), and on hook waiting for call
(H0). The commands in parentheses are valid for Hayes and compatible modems.
Alt-N/H/A Answer Command
The Answer Command string is sent to the modem when an incoming call (RING)
is detected. For Hayes and compatible modems, use the "ATA^M" command.
Alt-N/H/K OK Message
The modem returns an "OK" message when the last command was received and
executed successfully. For Hayes and compatible modems, use "OK". For
modems which do not return a response to the Initialization command, leave
this field blank.
Alt-N/H/R Ring Detect
When an incoming call is detected by the modem, it returns a special "Ring
Detect" message. For Hayes and compatible modems, this is the word "RING".
When the ring detect message is received, the Host sends the Answer Command
to the modem.
44 The Forbin Project, Inc.
Alt-N/H/B Busy Command
This allows you to place the modem Off-hook when you log in as the local
Sysop. Your phone line will return a busy signal preventing callers from
connecting to the host system.
Alt-N/H/# # Rings and Answer
This is exactly what it sounds like. The Answer command is sent after it
received this many Ring Detect message. In layman terms, it could the
number of RINGS and then answers.
Alt-N/P Protocols
When selecting the Protocols option, the following menu is displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘═════════════════════════════════╒═══════════════════╕════════════════════════╛
│ 0 - │
│ 1 - │
│ 2 - │
│ 3 - │
│ 4 - │
│ 5 - │
│ 6 - │
│ 7 - │
│ 8 - │
│ 9 - │
│ ASCII Options │
│ Toggles │
╘═══════════════════╛
The Protocols section allows you to customize Qmodem by adding additional
external transfer protocols. These protocols can then be called from an upload
or download and used as if it were built into Qmodem. The ASCII Options are
used for customizing the built-in ASCII transfer protocol. The Toggles menu
handles Internal transfer protocol specifics.
Qmodem SST 45
Alt-N/P/0-9 Protocol Revisions
External protocols must be defined in numerical order; with no blanks between.
When selecting a number from 0 to 9, the Protocol Definition window will be
displayed:
╒═════════════════════════════════ Setup Menu ═════════════════════════════════╕
│ Video Modem Dirs Host Protocols Files Options Exit │
╘═════════════════════════════════╒═══════════════════╕════════════════════════╛
│ 0 - │
╒═════════════════════════════════╕
│ Select character ░ │
│ Protocol ░░░░░░░░░░░░ │
│ Upload BAT ░░░░░░░░░░░░ │
│ Download BAT ░░░░░░░░░░░░ │
│ Filename Prompt