Category : Communication (modem) tools and utilities
Archive   : CA29-2.ZIP
Filename : COM-AND.DOC

 
Output of file : COM-AND.DOC contained in archive : CA29-2.ZIP
COM-AND: IBM PC Communications and Accessories










-----------------------------------------
COM-AND: Communications and integrated
communications accessories for the IBM PC
-----------------------------------------




COM-AND version 2.9 is copyright 1992 by CABER Software. It is
distributed freely and may be copied by anyone for any number
of machines, for purposes of evaluation. The author offers
COM-AND and its accessory programs as a package, as "shareware".
If you USE COM-AND after evaluating it, you MUST pay for it.



The complete user license and registration information is to be
found in the file REGISTER.DOC. Limitations on redistribution
of COM-AND are set out in the file VENDOR.DOC. These two files
are included with the COM-AND program release.



CABER Software
R. (Scott) McGinnis
P.O. Box 3607 Mdse Mart
Chicago, IL 60654-0607

GEnie, Delphi: TARTAN
CIS .......... 73147,2665
Internet ..... [email protected]











Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories



COM-AND version 2.9 is copyright 1992 by CABER Software. All
rights are reserved world wide, excepting redistribution under the
shareware concept. COM-AND is distributed freely and may be copied
by anyone for any number of machines, for purposes of evaluation.


Restrictions on redistribution are set out in the document file
VENDOR.DOC. You may NOT distribute COM-AND or its documentation in
connection with ANY commercial venture, product, publication or
service without written approval from CABER Software.


COM-AND is distributed as shareware. You may try COM-AND without
charge, to evaluate its usefulness to you. You may evaluate COM-AND
for a period of up to 30 days. If you continue to use COM-AND after
30 days, then you must pay for it. Please read REGISTER.DOC for the
terms and conditions of the User License.


Additional benefits are available when you register COM-AND. These
values include:

. A free Compuserve intro-pack
. The Compuserve Automation script-set for COM-AND
. A tailored dialing directory for your area code
. Discounts on shareware magazines and books

These offers are discussed in detail in REGISTER.DOC. A simple
registration form is provided in the file REGISTER.FRM. Please
print this form (or use REGISTER.CMD to print it), and include the
form with your payment.


The author supports COM-AND through electronic mail on the various
on-line services. Several BBSes focused on COM-AND exist at this
time. Voice support for COM-AND is also available from Support
EtCetera in Long Beach, CA. Please read REGISTER.DOC for details
on support, and COM-AND BBSes.


CABER Software is a member of the Association of Shareware Profes-
sionals (ASP). The ASP offers an ombudsman service to help you
resolve shareware related disputes with ASP members. Please read
the file REGISTER.DOC for information on how to contact the ASP
Ombudsman.




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories


Table of Contents
-----------------

I. Introduction .............................................. page 1

A. What is COM-AND ......................................... page 1
B. Version 2? .............................................. page 2
C. This document ........................................... page 2

II. Running the program ....................................... page 3
III. CRT Display ............................................... page 6
IV. Accessory Programs ......................................... page 8
V. Menu mode .................................................. page 10
VI. Commands: available in CRT and accessory modes ............. page 12
VII. Commands: CRT mode only .................................... page 15
VIII. Commands: Accessory only ................................... page 18
IX. Dialing (Alt-D, Alt-R and Alt-H) ........................... page 19

A. Dialing (Alt-D) ......................................... page 19
B. Dialing directory maintenance (Alt-D) ................... page 20
C. Redial (Alt-R) .......................................... page 22
D. Hangup (Alt-H) .......................................... page 23
E. A note on modem speed ................................... page 23

X. Macros (Alt-M and Alt-0/9) ................................. page 24

A. Revise entry (0-9) ...................................... page 24
B. Load a new file (Alt-M subcommand F) .................... page 25
C. Clear entries (Alt-M subcommand C) ...................... page 26
D. Execute entry (Alt-0 through Alt-9) ..................... page 26

XI. Encryption/Decryption (Alt-N) .............................. page 27
XII. Program Configuration (Alt-S, Alt-P, Alt-O and Alt-J) ...... page 30

A. Setup (Alt-S) ........................................... page 30
B. Communications Parameters (Alt-P) ....................... page 34
C. Options (Alt-O) ......................................... page 36
D. Colors (Alt-J) .......................................... page 43

XIII. File Transfer (PgUp, PgDn, Alt-F, F4) ...................... page 44

A. XMODEM Up/Download ...................................... page 46
B. YMODEM Up/Download ...................................... page 47
C. ZMODEM Up/Download ...................................... page 48
D. KERMIT Up/Download ...................................... page 49
E. CIS-B and B+ Up/Download ................................ page 50




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories


Table of Contents
-----------------

XIII. File Transfer (continued)

F. ASCII Upload ............................................ page 51
G. ASCII Download .......................................... page 53
H. File directory (Alt-F) .................................. page 54
I. Default download path (F4) .............................. page 54

XIV. Logging and Call-logging (F7, F9, Alt-U) ................... page 55

A. Disk logging [transcripting] (F7) ....................... page 58
B. Log hold [transcripting] (F9) ........................... page 58
C. Annotate call-log (Alt-U) ............................... page 58

XV. Miscellaneous Functions .................................... page 59

A. Default Drive:Subdirectory (F3) ......................... page 59
B. Keyboard display (F8) ................................... page 59
C. Chat mode (Alt-A) ....................................... page 59
D. Redisplay [backscreen] (Alt-B) .......................... page 59
E. Clear screen (Alt-C and received TOF) ................... page 60
F. Echo (Alt-E) ............................................ page 60
G. Blank line suppression (Alt-G) .......................... page 60
H. 43/25 line toggle (Alt-L) ............................... page 60
I. Kermit Parameters (Alt-K) ............................... page 60
J. Time and Alarms (Alt-T) ................................. page 61
K. Playback (Alt-W) ........................................ page 61
L. Program termination (Alt-X) ............................. page 61
M. Parity (hi-bit) mask (Alt-Z) ............................ page 62

XVI. DOS Gateway (Alt-F10) ...................................... page 63
XVII. Emulation (Alt-V) ......................................... page 64

A. Display Emulation ....................................... page 64
B. Translation ............................................. page 65
C. Remapping ............................................... page 66
D. Other related settings .................................. page 67

XVIII. Script Language ............................................ page 68
XIX. Text Editor ................................................ page 69
XX. Program Requirements ....................................... page 70
XXI. Program and Author Information ............................ page 71






Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories


Appendices
----------

A. Switches and Parameters .................................... page 72
B. COM-AND Error display ...................................... page 75
C. Files ...................................................... page 76
D. Windowed XMODEM (WXMODEM) .................................. page 77
E. ANSI ,VT100, and VT52 sequences ............................ page 78

1. ANSI sequences .......................................... page 78
2. VT100 sequences ......................................... page 80
3. VT52 sequences .......................................... page 82

F. Vidtex and RLE files ....................................... page 83

1. Vidtex .................................................. page 83
2. RLE Files ............................................... page 84

G. External Protocol drivers .................................. page 85
H. Modem Configuration ........................................ page 87

1. DTR (Data Terminal Ready) ............................... page 87
2. CD (Carrier Detect) ..................................... page 87

I. Environment variables ...................................... page 88

1. COM-AND= ................................................ page 88
2. COMSPEC= ................................................ page 88
3. Other variables ......................................... page 88

J. Background operation ....................................... page 90
K. Encoded music .............................................. page 91
L. BIOS Comm Read/Write ....................................... page 92
M. MODEM Initialization ....................................... page 93
N. COM-AND's Backscreen ....................................... page 96
O. Customizing COM-AND ........................................ page 97
P. BIOS (INT 14h) communications .............................. page 100
Q. 16550A(N) UARTs ............................................ page 102
R. High-Speed communications .................................. page 103
S. Doorways ................................................... page 104
T. Command Index .............................................. page 107









Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 1


I. Introduction


A. What is COM-AND?


COM-AND for the IBM PC and compatibles is a communications
program, for use by itself, or with several integrated accessory
programs (which themselves may be used independent of COM-AND).
COM-AND provides standard comm program functions: a dialing
directory, macros, disk logging, binary and ASCII file transfers,
text editing, scripted execution and so on.


Four accessories are available for use with Version 2.9 of COM-
AND. These accessories are for use over conferencing services
such as People/Link's PARTY, GEnie's RTC and CIS's CB:

PC-VCO provides a way to 'see' and 'hear' people talking.
CCHESS supports chess games with another conference user.
CBRIDG supports bridge games with other conference users.
CCOLOR tracks conference users, coloring each speaker's
received text differently


These accessories are available uploaded separately, not as
a part of COM-AND's release. Please refer to the accessory
documents for more detailed discussions of their function.


COM-AND Version 2.9 executes as a CRT based comm program either
in 25 line text mode on a CGA or monochrome screen, 25/43 line
mode on an EGA display and 25/50 on a VGA. When an accessory is
loaded through COM-AND (or when COM-AND is loaded by an acces-
sory), most of the functions of COM-AND are available through
the accessory.


COM-AND and its accessories (PC-VCO, CCHESS, CBRIDG, and CCOLOR)
may be copied freely and distributed to anyone for any number of
machines, for purposes of evaluation. The author offers COM-AND
as "shareware". If you USE COM-AND after evaluating it, you
MUST pay for it.







Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 2


I. Introduction (continued)


B. Version 2?


Version 1 of this software was released in 1986 as PC-VCO. In
other words, the accessory and communications programs were one
single program.


In 1988, version 2.0 of PC-VCO had grown to such a size that the
program was split into two executable programs. From that point
in time, accessories have been developed and released as indivi-
dual programs, using COM-AND as a base.


Version 2.9 is the tenth release.


C. This document


This document describes the features of COM-AND, both standard
communications features and as much of the accessory program
features as may be appropriate. For the most part, however, any
discussion of accessory functions is limited in this document.


Accessories are released separately. A detailed guide to each
accessory is to be found in its own documentation.


This document addresses manual use of COM-AND, and may be treated
as a reference document. In this document, basic DOS skills are
assumed, as well as basic telecommunications concepts.


A detailed guide to installation, and an introduction to modem
communication is to be found in the document INTRO.DOC.


For details of COM-AND's script language, please refer to the
file CASCRIPT.DOC, included with this release. The internal
editor is documented in CAEDIT.DOC, included with this release.





Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 3


II. Running the program


Generally, COM-AND is invoked at the DOS prompt with the command:

-----------------------------------------------------------------
"d>" COM-AND

Where "d>" is the DOS prompt, and
is/are ( ( ...))
and is either a switch or a parameter

Refer to Appendix A for a description of switches and parameters.
-----------------------------------------------------------------

COM-AND could be invoked with a command such as:

"d>" COM-AND

to simply start COM-AND, or, for example, the command:

"d>" COM-AND DIAL 1

to dial dialing directory entry #1 as soon as COM-AND is loaded.

The command:

"d>" COM-AND /FSCRIPT

would be used to perform the commands contained in the file SCRIPT
(or SCRIPT.CMD or SCRIPT.ENF, whichever is first in the directory).


COM-AND requires no other file for its execution. It creates a
parametrization file, dialing directory, and macro definition if
needed.


Note: Once loaded, COM-AND does not require its executable disk
file again. No program disk need be retained in the default drive
if loaded from floppy diskette (though it is needed again to change
the dialing directory, or macro, or accessory definitions).


Run-time switches and parameters are discussed in Appendix A. Files
used by COM-AND are discussed in Appendix C. Default pathing of
file names is discussed in Appendix I.



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 4


II. Running the program (continued)


The first time COM-AND is loaded, it establishes default settings
(as described in Appendix A). The comm port used is the first comm
port installed (if none are found, COM1 is used). On some machines,
when no port is usable, COM-AND 'hangs'. If this happens, you must
boot the machine and reload COM-AND thusly:

"d>" COM-AND /I

The /I switch directs COM-AND to NOT issue a modem initialization
string. When COM-AND is loaded in this manner, the serial port is
unused until a character is transmitted. Use Alt-P to change the
default port (remember to save the setting).


The very first time COM-AND is loaded:

1) Use DOS to move to the subdirectory where you plan to install
COM-AND... where previous versions have been installed.

2) Extract the distribution files onto the selected subdirectory.
Have a care not to overwrite files you want to keep!

3) Load COM-AND (as above)

If COM-AND is loaded on a subdirectory where no COM-AND.DFT
resides AND if the environment variable COM-AND= does not point to
a subdirectory where COM-AND.DFT may be found, COM-AND creates a
new .DFT file.

A script named INSTALL.CMD is included with this release. When
COM-AND creates its .DFT file (as opposed to updating an existing
one), if the script INSTALL.CMD is available, INSTALL is invoked
automatically upon completion of initialization.

INSTALL takes over some of the decision process, and some of the
work required to configure COM-AND for use. It is in no way
necessary to the execution of COM-AND, however.

INSTALL performs the following functions (all steps in INSTALL are
optional):

o Adds a COM-AND= environment variable to the AUTOEXEC.BAT
o Sets (and searches for possible) serial ports
o Sets the default speed for the serial port selected
o Sets modem command strings according to modem model


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 5


II. Running the program (continued)


5) Review settings in COM-AND

o Check Alt-P

.. Check the COM port you use (1/2/3/4).
.. Check the default speed selection. It is not important if
you always use the dialing directory. Set it anyway.
.. Remember to save new settings.

o Check Alt-S

.. Check modem strings against your particular modem,
.. The backscreen buffer size defaults to 4K. You can set it
up to 64K, for redisplay and transcripting.
.. Remember to save the new settings.

o Check Alt-O

.. Set flags the way you want them (e.g. exit query on, d*mned
advert off, and so on; Note BIOS/DIRECT settings)
.. Remember to save new settings.

6) Review the accessories (F1).

You may revise the contents of accessory definitions with the 'r'
subcommand. You may want to add entries for a listing program
and editor... perhaps PC-VCO... perhaps CCOLOR...

7) Exit COM-AND with Alt-X.


















Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 6


III. CRT Display


When COM-AND is loaded, a pop-up announces that initialization is
occurring. Initialization of the modem is performed automatically
by COM-AND. The modem initialization string specified through the
Setup function (Alt-S) is issued to the modem when COM-AND is
loaded, after the modem port is set to the default rate, parity,
data and stop values specified (at run time or with Alt-P).


Other initialization includes: looking for a mouse, and loading
files (dialing directory, macro, and accessory definitions).


Once initialization is complete, COM-AND enters terminal mode, and
your PC serves as a 24 line (CGA and monochrome) or 24/42(50) line
(EGA/VGA) CRT. The first 24(42/49) lines are a scrolling region for
received text. The last line is used for program identification,
status and keyboard display. Carriage return/line feed combinations
received cause the text area to scroll.


Text typed on the keyboard is transmitted out the COM port. What
is received through the COM port is displayed on the screen. Special
escape sequences are performed by COM-AND (optional). Control char-
acters (except null) are displayed according to the IBM character set
(optional). Received characters may be masked to 7 bits (optional).


In order to connect to a host, usually the first step would be to
dial a phone number to connect to a network node. For example, with
a Smartmodem, the following directs the modem to dial the phone:

AT E1 DT 245-9110


This sequence instructs the Smartmodem to echo entry (E1) and dial
using tone dialing (DT) PLINK Chicago (245-9110) as a local call.
Modem initialization could be done between the E1 and DT as needed.


This sequence is automated in COM-AND through a dialing directory
(Alt-D). Phone numbers and parameters are maintained in the
directory. The phone is dialed with the same Alt-D window.





Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 7


III. CRT Display (continued)


Many people prefer to make connection to a host with a script, how-
ever. Scripts for dialing and connecting to several popular services
are included with this release of COM-AND. A script is a 'program'
written for another program, in this case for COM-AND.


Whether the connection is made manually or through a script, every-
thing that happens appears in the text area of the CRT display.


The keyboard on the IBM PC provides ordinary typewriter-like keys and
other keys (e.g. F1, F2...). The 'other' keys are used by COM-AND
for control purposes, as the mention of Alt-D above shows. The Alt-
key, when held down while another key is pressed, is treated as a
special keystroke. Press Alt-D and a window pops-up displaying the
current dialing directory. Press F2 and a window pops-up to display
the scripts available on the current subdirectory, and to accept a
script file name to execute.


The remaining chapters of this document describe the functions of
COM-AND as they may be manually invoked. The internal editor is
described in a separate document, CAEDIT.DOC.


A separate document (SCRIPTS.DOC) summarizes the scripts released
with this version of COM-AND. [An individual script may or may not
have its own document covering its use.] A separate document
(CASCRIPT.DOC) describes the script language and concepts.


















Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 8


IV. Accessory Programs


Released with the 2.9 version of COM-AND are four programs labelled
'accessories': PC-VCO, CCHESS, CBRIDG and CCOLOR. PC-VCO, CCHESS,
CBRIDG, and CCOLOR are programs in their own right, and may be used
with or without the COM-AND program (according to your preference
in comm program).


Accessory programs are usually loaded with COM-AND for a special
purpose (such as PC-VCO: Visual Conferencing), after connection has
been established through COM-AND. When COM-AND is loaded as above
(i.e. "d> COM-AND"), accessories would be loaded 'on top' of
COM-AND through the F1 Menu.


However: the accessory program may be loaded first. When PC-VCO is
run from the DOS prompt without the '/P' switch, it looks for the
COM-AND program on the current subdirectory (or in the subdirectory
indicated by a 'COM-AND=' environment variable). PC-VCO does not run
without the '/P' switch unless it can find COM-AND. PC-VCO loads
COM-AND, and the F1 menu in COM-AND is made unavailable for use.


The integration of accessory programs into COM-AND means:

(1) the accessory loads COM-AND if COM-AND isn't loaded already
(unless you loaded the accessory "/P"),

(2) COM-AND functions such as macros and dialing directory are
available in the accessory when COM-AND is loaded, and

(3) settings made in COM-AND carry over to the accessory when it
is loaded, and settings made in the accessory carry over to
COM-AND when the accessory terminates.


When an accessory program loads COM-AND, COM-AND is limited to the
use of a single accessory (and no other, although you may gateway
to DOS). When COM-AND is loaded first, a menu of accessories,
arranged somewhat like the dialing directory, is presented. One
accessory after another may be selected, each new accessory selec-
tion automatically terminating the previous one.






Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 9


IV. Accessory Programs (continued)


An accessory is loaded by pressing F1, and selecting the entry you
choose to execute. [The F1 menu is available only on the CRT side,
and only when COM-AND is loaded first.]


The F1 menu defines an accessory as:

o A title which is displayed in the menu
o A subdirectory for use during the accessory (optional)
o A script file to perform (optional)
o A program to load, along with run parameters (optional)


An accessory to COM-AND, therefore, might be any COM-AND script, or
most any program, or both. You are not limited to the ones coded for
COM-AND. If you have a favorite editor you'd like to use to keep
notes on-line, define it as an accessory... If you like to look at
READMAC (or GIF) graphics during conferences, define an accessory
for each of several favorite pictures...


To create a new entry, use the revise subcommand ("R"). You are
prompted for each of the above values. The subdirectory specified
is used as the default for all program and file accesses when you
invoke the accessory. The program name must be given in full (e.g.
XXX.COM or YYY.EXE). Batch files are not executable as accessories
(at this time); however, you may use "COMMAND.COM /C FILE.BAT" to
effect the execution of a batch file.


Accessories integrated into COM-AND (such as PC-VCO) permit switching
between CRT and accessory modes. A loaded accessory is terminated
with the "T" subcommand of F1, or by simply loading a new accessory.


COM-AND supports multiple accessory directory files. A new accessory
directory is manually selected with the 'F' subcommand of the F1
window. Note: the new file name is also reflected in the Alt-S
window (but isn't saved for the next time).


External protocol drivers may be implemented as accessories, easily.
Refer to the Appendix G for a discussion of one such driver's
implementation as an accessory (DSZ for file transfers).



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 10


V. Menu mode


An easy way to get to know a new program is through a summary of
functions it provides. In COM-AND, the F10 key provides a command
summary. Like most communications programs, COM-AND ties its func-
tions to special keys (Alt-D for dialing, Alt-F for file directory,
and so on). This is done for purposes of speed... host services
charge by the minute... every keystroke counts!


However, beginning with version 2.5, almost every function of COM-AND
is also available through a 'menu mode'. When COM-AND is run with
the /V switch (or if menu mode is set permanently through Alt-O,
Options), the top line of the screen displays a 'menu bar'. Each
item on the top bar may be selected in turn, and a menu pulled down
to list functions. The equivalent keystroke is displayed for every
item in the pull-downs.


In menu mode, items from the top bar may be selected with the mouse,
or the cursor keys. Pull-down windows are opened in the same way.
Keystrokes active on the top bar (when no pull-down is open) are:

Mouse Keystroke Menu mode ON Menu mode OFF
--------------- --------------- --------------- ----------------
Left motion Cursor left Top bar select Backspace sent
Right motion Cursor right Top bar select Space transmitted
Downward motion Cursor down Open pull-down It beeps
Upward motion Cursor up Open pull-down It beeps


Once an item from the top bar is 'opened' or 'pulled-down', the usage
changes slightly. Within a pull-down, keystrokes are:

Mouse Keystroke Menu mode ON
------------------- --------------- ---------------------------
Left motion Cursor left Open pull-down to left
Right motion Cursor right Open pull-down to right
Downward motion Cursor down Select next successive item
Upward motion Cursor up Select previous item

Left button click PgDn Select next successive item
Right button click PgUp Select previous item
Left double click Carriage rtn Execute selected item
Right double click ESCAPE Cancel window




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 11


V. Menu mode (continued)


Within function 'windows' (such as Alt-D dialing), the above key-
strokes and mouse actions have the same general meaning. [Only in
menu mode pull-downs do left/right motions/cursor keys open new
windows, however.]


At this point, a note on mouse usage seems appropriate... COM-AND
uses a Microsoft Mouse (or equivalent) if it finds one, when the /M
run-time switch is not used. Even for the miceless, left, right,
up, and down motions should be self-explanatory. However, mention
of 'buttons' and 'double clicks' requires some discussion.


The Microsoft Mouse has two buttons. COM-AND implements the left
button as PgUp and the right button as PgDn, as shown in the table
above. However, when a button is pressed, it is not 'executed'
immediately. After a button press, COM-AND waits for a short moment
to determine if the button is being pressed once, or twice in rapid
succession. A left 'double click' is taken as a carriage return,
and a 'right double click' is taken as ESCAPE. The interval after
which COM-AND takes a button press as a single press may be changed
through Alt-S, Setup.


All of this is to say: in any COM-AND window where there are
multiple items, the cursor keys, mouse up/down motions, and mouse
buttons may be used to select an item. [Every window where this is
the case 'highlights' the current selection.] A double click on the
mouse left button executes the selection (just as a carriage
return), and a double click on the mouse right button cancels the
function (just as ESCAPE).


The menu mode of COM-AND permits all 'manual' functions, such as
dialing, hanging up, toggling disk capture, exiting the program, and
so on, to be performed entirely with a mouse (or the cursor keys
even). Of course, someone somewhere must have done the typing to
update the dialing directory, to define the macros...


But as stated at the outset, its an easy way to get to know the
program.





Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 12


VI. Commands: available in both COM-AND and Accessory


COM-AND provides the following command keys both on the CRT side, and
during an accessory:

F1 Switch between text (CRT) and accessory modes: As described
above, the F1 key behaves differently, according to the way
you loaded COM-AND. When COM-AND is directly loaded, F1
provides a menu of accessories and functions. When an
accessory loads COM-AND by default, the F1 key is restricted
to switching back and forth between CRT and accessory modes.

F10 Help screen: All currently implemented commands are summar-
ized on this screen. Any command may be executed directly
while this screen is displayed. The help screen displayed is
either by COM-AND or from the accessory, according to the
current mode.

Alt-F10 DOS Gateway: If sufficient memory is available, COM-AND
executes a shell program. This is normally a second copy
COMMAND.COM for full access to DOS while a communication
session is in progress.

Ctl-End Break: This sends a true 'break' signal.

Ctl-Prt Printer: Toggle (i.e. turn on/off) printing to LP1.

Alt-C Clear: Clear the text area of the screen.

Alt-D Dialing directory: Enter, change, execute, and print the
dialing directory entries. Please refer to Chapter IX,
page 19.

Alt-E Echo: Toggle local echo. [This function may also be con-
trolled through the dialing directory (Echo ON).] In 'full
duplex' (echoplex), the host must echo back what is typed
for you to see it (you set Echo OFF). In 'half duplex',
COM-AND echoes what is typed immediately (Echo ON).

Alt-F File directory: A display similar to the DOS DIR command
command is displayed in a window. Please refer to page 54.

Alt-G Blank line suppression: Toggle. COM-AND may suppress
blank lines (double spacing) if you wish. You may make
this a program default through the Alt-O options menu.

Alt-H Hangup: Hangup the phone.


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 13


VI. Commands: available in both COM-AND and Accessory (continued)


Alt-I Program information: Author information. Propaganda.

Alt-M Macros: Define a macro for Alt-0 through Alt-9. Please
refer to Chapter X, page 24.

Alt-N Encrypt/decrypt a file: Encrypted files may be used as
scripts. Files cannot be encrypted/decrypted in place!!!
Please refer to Chapter XI, page 27.

Note: Should the encrypted file be modified in any way, or
the password be lost, there is little chance of recovery.
Neither CABER Software nor the author will be liable for any
damages or lost revenues incurred through the use of this
function beyond the registration price paid for COM-AND.

Alt-O Options: Set controlling flags for COM-AND. Note: although
this menu may be used from either COM-AND or accessory, it
really only effects COM-AND settings. Refer to page 43.

Alt-P Comm Parameters: Set rate, parity, number of data and stop
bits for use when COM-AND is initially loaded. These
settings are overridden by run-time switches. Whatever
the current setting, the dialing directory overrides.
Please refer to page 34.

Note: Although this menu may be used from either COM-AND or
accessory, it really only effects COM-AND settings. Each
accessory has an Alt-P function as well accessible only when
the accessory is loaded with the '/P' switch.

Alt-Q Editor: You may invoke COM-AND's text editor to view or
to change a text file, at any time. For an overview,
please refer to Chapter XIX (page 69, below). For a
detailed description, refer to the CAEDIT.DOC file.

Alt-R Redial the last number dialed: The program redials the last
number dialed until the function is terminated (with ESC),
or connection is made.









Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 14


VI. Commands: available in both COM-AND and Accessory (continued)

Alt-S Setup: Define initial program values, such as Modem initial-
ization, the Modem Hangup sequence, and file names. Please
refer to page 30.

Note: Although this menu may be used from either COM-AND or
accessory, it really only effects COM-AND settings. Each
accessory has an Alt-S function as well which may or may not
be accessible when COM-AND is used to load the accessory.

Alt-T Elapsed time: The time the program was loaded, and the time
the last call (Alt-D or Alt-R) was placed, are displayed.
The 'last call time' may be reset. A real-time alarm may be
set (for one time use, or permanently). Refer to page 61.

Alt-U Annotate call-log: COM-AND keeps (if you wish) a log of
calls, hangups, disconnects and so on. You may enter free-
form notes into the log through this window. Please refer
to Chapter XIV, page 55.

Alt-X Exit the program: If the modem you use reports 'carrier'
and you exit without hanging-up, you are asked if a hangup
is desired.

NOTE: a script may override the Alt-X function. When this
happens, after Alt-X is pressed (and after the hangup query
if it is needed) a script may start!

Alt-Z Parity mask: Toggle. The high bit mask is used only for
text received and displayed. It has no effect on file
transfers (XMODEM, YMODEM, ZMODEM, KERMIT, and CIS-B).

Alt-0/9 Send a Macro: A string of characters defined through the
Alt-M command described above is transmitted. Please refer
to Chapter X, page 24.

---------------------------------------------------------------
Note also functions defined below: "Commands: CRT modem only".
---------------------------------------------------------------










Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 15


VII. Commands: CRT mode only


COM-AND provides the following command keys only in CRT mode:


F2 Execute a script: A window is opened to request the name of
the script file. The extension ".CMD" is attempted if the
given name does not have an extension, and the given name is
not found. Similarly, the extension ".ENF" is tried. Please
refer to Chapter XVIII, page 68.

F3 Set current drive:path: You may change the default disk
drive and path from within COM-AND using this feature.
The current drive:path affect uploaded files and file name
searches (Alt-F), when no qualification is provided.

NOTE: The F3 setting is retained even after COM-AND is
terminated.

F4 Set default drive:path for downloads: All download file
transfers (XMODEM, YMODEM, ZMODEM, KERMIT, CIS-B, ASCII,
logging, and RLE) use this setting if the target file name
supplied (one way or another) does not specify the drive
and/or path.

NOTE: The F4 setting is retained for the next time COM-AND
is used. Each change to F4 is saved!

F5 ASCII upload: Files may be transmitted to a system using a
simple 'send' (as if they were entered by hand). Transfer
may occur with or without a host prompt (some special char-
acter issued for every line). Transfer may be timed (paced)
in either case. Line feeds may or may not be suppressed.
Tabs may or may not be expanded as blanks, as you wish.

This function is also available through PgUp (page 51).

F6 ASCII download: This differs from transcripting (F7,
below) in that no extra characters are added to the file
(line feeds after received carriage returns, or an end-of-
file byte). Transcripting is intended to result in an ASCII
edit file, or a printed log. ASCII download may be used to
save sessions (or parts of sessions) exactly as received.

This function is also available through PgDn (page 53).




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 16


VII. Commands: CRT mode only (continued)


F7 Logging or transcripting: Log received text to a disk file
or device. You specify the file to use. If not empty, new
logging is appended to the end of existing data.

You are asked if the backscreen (the last text received) is
to be saved. Logging need not be started before an event
you want to record.

What is logged is not exactly what is displayed on the
screen. If hi-bit masking is turned on, characters are
saved with the high bit turned off. An ASCII end-of-file
is added when the file is closed.

Opening and closing the log marks the log with date and
time. Transcript marking may be turned off with the
Alt-O window. Log hold (below) does not mark the log.

F8 Toggle display of typed characters (for use with half duplex
connections, otherwise known as 'no echo'). The keyboard
display takes over the last screen line.

F9 Hold the log: no entry is made to the log from this point
until hold is turned off (by pressing F9 again) or the
log is closed. The status line informs you of log hold.

PgUp Upload: A menu of protocols for file transfer is displayed.
One must be selected, and the upload then proceeds as below
(under "File Transfer"). Please refer to Chapter XIII, page
44.

PgDn Download: A menu protocols for file transfer is displayed.
One must be selected, and the download then proceeds as
below (under "File Transfer"). Please refer to Chapter
XIII, page 44.













Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 17


VII. Commands: CRT mode only (continued)


Alt-A Toggle split screen 'chat mode' on and off: The screen is
split in chat mode, one window for received text, and one
for typed. The size of the chat window is set through Alt-S
Setup. Some accessories also support Alt-A.

Alt-B Redisplay (backscreen): You may review the backscreen
buffer page by page. Some accessories also support Alt-B.

Alt-J Set screen colors: You may set foreground and background
color values for the CRT screen, the status line, and menu
windows. Some accessories have their own Alt-J window.

Alt-K Set KERMIT parameters: The values as supplied are suitable
for most systems. We do not recommend that you change
these settings unless you fully understand their meaning.

Alt-L Toggle EGA(VGA)/CGA (43(50)/25 line) modes: Some
accessories have their own Alt-L.

Alt-V Emulation: You may select terminal emulation, and enable/
disable translation and/or remapping through Alt-V. Note:
both translate and remap require prepared data.

Alt-W Playback: Display text from a file in the CRT screen area.
This may be used to set screen colors using ANSI controls
(overriding the screen colors set through Alt-J).

Alt = Menu mode: Alt-Equal toggles the menu mode interactively
(see chapter V, 'Menu Mode').

Alt - Alt-Minus toggles remote function key use (see Appendix S,
'Doorways').


---------------------------------------------------------------
Note also functions defined above under "Commands: both modes".
---------------------------------------------------------------










Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 18


VIII. Commands: Accessory only


A discussion of accessory commands must properly be referred to the
accessory document. However, a few comments are in order here.


Each accessory must have an Alt-P function similar to COM-AND's
Alt-P Comm Parms Menu, to allow you to set default parameters. The
defaults have effect when the accessory is NOT run 'piggyback' ('/P'
switch) through the DOS gateway of another communications program.


Each accessory must have some kind of Alt-S setup window which
defines accessory-specific flags and values. In all accessories
currently released, the accessory setup function is available through
the 'Controls' pull-down. When the accessory is loaded '/P', the
Alt-S key is enabled to access the accessory setup as well. [When
loaded through COM-AND, an accessory's Alt-S calls up COM-AND's
Setup window.]


Each accessory integrated into COM-AND defines Alt-X as program
termination: not accessory termination, but process termination!
Use Alt-X from an accessory to terminate the accessory AND the
COM-AND program. Alt-X from COM-AND terminates COM-AND and any
loaded accessory. The F1 key is used to switch between COM-AND and
an accessory, and may be used to terminate the accessory without
terminating COM-AND.


As of version 2.6 of COM-AND, certain accessories permit COM-AND
scripts to execute while the accessory is active. This includes
scripts executed automatically through Alt-D dialing. Please refer
to an accessory's documentation to determine the accessory supports
scripts.














Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 19


IX. Dialing (Alt-D, Alt-R, and Alt-H)


A. Dialing (Alt-D)

. Dial from directory

The dialing directory is invoked with Alt-D. You dial the
number in an entry by entering the entry number followed by
. The particular directory entry does not have to be
visible.

The entry number you type may be prefixed and/or suffixed with
a long distance entry code (+,-,#,@). A prefix is transmitted
before the number dialed, and the suffix is transmitted after
the dialed number. Both prefix and suffix may be used, or one
alone, or none.

A fixed prefix string, which is transmitted with every call
before any long distance prefix, may be specified in Alt-D.
[For example, "9,," used for outdial through a PBX.]

The modem dialing string specified through the Alt-S window is
issued; the prefix for all calls (if specified) is issued; a
long distance prefix (if used) is issued; the telephone number
is issued; a long distance suffix (if used) is issued; and
finally a dialing suffix string specified through the Alt-S
screen is transmitted.

Communications parameters are specified when the dialing direc-
tory entry is created. Each service requires certain settings
for comprehensible communications. However, one note: COM-AND
changes settings to 8 data bits, no parity and 1 stop bit when
file transfer commences, if appropriate (KERMIT is the only
exception). When transfer completes, previous settings are
reinstated. You only need to know what the specific service
requires for conversational mode.

. Manual dialing (M)

From the Alt-D dialing directory, you may invoke manual dialing
with the command "M". You are asked to enter a number to dial.
Enter the telephone number to dial; it is prefixed with the
modem dialing string (specified through the Alt-S window) and
the fixed prefix for all calls, suffixed with the Alt-S dialing
suffix, and issued.




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 20


IX. Dialing (continued)


. Manual dialing (continued)

Manually dialed numbers use the communications parameters in
effect at the time the number is dialed. The rule for comm
parameters is: The Comm Parms default (Alt-P) is overridden
by run-time parameters; the setting specified in a dialing
directory entry overrides both.


B. Dialing directory maintenance (Alt-D)

. Revise entry (R)

A directory entry is revised with the "R" command. You are
prompted for an entry number (you may use the command "Rn" too,
where "n" is the entry number). Answer each prompt with the
appropriate value. You may cancel the change at any prompt
with the ESC key. When all the prompts are completed you are
asked whether the change is to be saved to disk. If you say
no, the change is not available the next time you use COM-AND.

NOTE: When you enter a telephone number to be dialed, there is
space for 13 digits. For example: 1-312-555-1212. Normally
you would not include the 1-xxx area code for your OWN area
code. You may, however, enter ALL numbers as long distance
numbers, and set the 'Strip area code' ('S' subcommand, below)
to your own area code. COM-AND recognizes the 1-xxx and
removes it if the 'xxx' matches the 'Strip area code' value.

NOTE: When you revise a dialing directory entry, you must
specify a speed for the connection. Many modems nowadays want
the link between the computer and the modem to run at a single
(high) speed. The modem itself handles the connection speed
(usually a lower speed). You may select to override the Alt-D
speed setting through Alt-O. Although you must select a speed
in Alt-D, if Alt-O overrides the speed, the current (default)
speed is displayed in Alt-D for ALL entries, and the speed
setting in Alt-D is not used.

NOTE: Also, you may select "Default" for the rate (speed) of
an individual connection, and ignore the Alt-O override. The
default rate is the rate holding AT THE TIME the entry is used
to dial. The default is: 1) the last rate set by using Alt-D
dialing, 2) the rate specified in the run command, or 3) the
Alt-P default rate (in order of preference).


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 21


IX. Dialing (continued)


B. Dialing directory maintenance (continued)

. Delete entry (D)

A directory entry is deleted with the "D" command on the Alt-D
window. You are prompted for the entry number (you may use
the command "Dn" too, where "n" is the entry number). The
chosen entry is displayed. If you answer "y" to the query, the
entry is deleted in memory and on disk.

. Revise Long distance directory (L)

The Long distance directory is a directory within a directory.
Four entries may be created (labelled: "+", "-", "#", and "@")
and used to prefix or suffix a dialing command (or to suffix).

The Long distance entry is free form. Any string your modem
accepts may be entered. The Long distance directory is pulled
up from the Alt-D window with the command "L". An entry may
be modified by selecting its label ("+","-","#","@").

. Print directory (P)

The dialing directory (current in memory) may be printed from
the Alt-D window with the subcommand "P". Printer output is
directed to the standard output device (PRN). You are prompted
to ready the printer. Press any key except ESC to begin
printing. ESC at this prompt cancels the print job.

The printed directory is two pages, each of 50 lines (plus
heading). Top-of-forms (decimal 12) are issued at the start of
each page. Column headings are similar to the Alt-D headings.

. Load file (F)

A new dialing directory may be loaded with the 'F' command at
any time. Note: when you change the directory file, the change
also is reflected in the Alt-S window (but isn't saved for the
next time unless you save the values in Alt-S).








Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 22


IX. Dialing (continued)


B. Dialing directory maintenance (continued)

. All call prefix (A)

You may specify a string to precede all numbers with the 'A'
subcommand. The string may contain any characters your modem
will accept. [This is used, for example, for the "9,," outdial
command common to many PBXes.]

. Strip area code (S)

You may specify your own area code to be stripped from the
number dialed with the 'S' subcommand. When a dialing direc-
tory number begins with the digit "1" followed by that area
code, COM-AND removes it from the number being dialed. This
feature makes it travelling and communicating more convenient.

. Timeout delay (T)

When Alt-D dials a number, and it fails to connect after a
given period of time, COM-AND performs a hangup, and then
attempts a redial. You may specify the the timeout with the
'T' subcommand. Note that this value is reflected in Alt-S
(but is not saved unless you save Alt-S).


C. Redial (Alt-R)

The last dialing directory entry used to dial (or manual number
as entered) may be recalled and redialed. The redial sequence
cycles. It waits for the "Connect string" (as specified through
the Alt-S window) for a fixed period, then resets the modem using
the "Escape string" and tries again. Time spent redialing is
updated every time a redial is attempted.

You may force a new attempt with the space-bar. You may change
the delay interval by pressing the END key: you are prompted
for a new value (in seconds).









Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 23


IX. Dialing (continued)


D. Hangup (Alt-H)

The connection (if any) may be interrupted and the "Hangup string"
(specified through the Alt-S window) issued (or DTR dropped,
according to your Alt-O preference), using the Alt-H command.

One note about Alt-H hangup: According to your modem and your
setup of COM-AND, when you hangup, the connection may not be
properly broken. A second Alt-H may or may not finish the job.
Modems configured to follow DTR always respond to dropping DTR.

Through Alt-O, you may opt to re-initialize the modem after
hangup. The re-initialization takes some time, but ensures the
modem is left in a uniform state.


E. A note on modem speed

Some new modems connect to the PC at one speed and connect to the
host at a second speed. If you use a modem of this type, you
have several alternatives:

. set the speed in the dialing directory to the speed used
modem-to-PC. Usually this is a higher rate. Leave the Alt-O
"Override Alt-D speed" OFF.

. set the speed in Alt-P to the speed used modem-to-PC. Set the
Alt-O "Override Alt-D speed" ON.

Please note that, at this time, COM-AND does not automatically
detect and change speeds during a connection. Several included
scripts demonstrate this 'autobauding' (see BBS, HOST, CONNECT
and PC-2-PC), but COM-AND does not offer it in manual usage.














Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 24


X. Macros (Alt-M and Alt-0/9)


A. Revise entry (0-9)

COM-AND is distributed with an empty Macro directory. Entries are
displayed and modified through the Alt-M window. A macro entry
is any string of text which may be transmitted on-line with one
keystroke. Carriage returns may be embedded in the string (as
exclamation points "!" ... Exclamation points themselves must be
entered doubly: "!!"). Control characters may be embedded in the
string (as caret/letter "^x" ... ^a = 1, ^b = 2, and so on...
Carets themselves, too, must be doubled: "^^"). The grave (`)
forces the next character (may be used in place of doubling).

The macro definition window is invoked with Alt-M. Select the
entry number to revise by entering its number (0...9). You are
prompted for the new entry.

One interesting note: COM-AND keystrokes may be programmed into
macros themselves. For example, the macro:

"^@
actually invokes the F2 (execute script) window, and passes the
name "SOURCE" with a terminating carriage return to the F2 window.
The ^@ indicates the following character is interpreted as an
'extended keystroke', i.e. not-ASCII. Extended characters are:

Macro seq Key Macro seq Key Macro seq Key
--------- --- --------- ----- --------- -----
^@; F1 ^@^^ Alt-A ^@1 Alt-N
^@< F2 ^@1 Alt-B ^@^X Alt-O
^@= F3 ^@. Alt-C ^@^Y Alt-P
^@> F4 ^@ (space) Alt-D ^@^P Alt-Q
^@? F5 ^@^R Alt-E ^@^S Alt-R
^@@ F6 ^@! Alt-F ^@^_ Alt-S
^@A F7 ^@" Alt-G ^@^T Alt-T
^@B F8 ^@# Alt-H ^@^V Alt-U
^@C F9 ^@^W Alt-I ^@/ Alt-V
^@D F10 ^@$ Alt-J ^@^Q Alt-W
^@I PgUp ^@% Alt-K ^@- Alt-X
^@Q PgDn ^@& Alt-L ^@^U Alt-Y
^@u Ctl-End ^@2 Alt-M ^@, Alt-Z

Note, too, Alt-A (requiring "^^") is unprogrammable. It may
be entered as decimal 30 (use Alt and numeric pad keys, below).



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 25


X. Macros (continued)


A. Revise entry (continued)

In the above example, the F2 key was represented by "^@<". When
the F2 key is pressed a window is opened and a search for all
files *.CMD and *.ENF takes place. In simpler terms, pressing the
F2 key takes TIME. COM-AND defines the ASCII value 255 as a short
cut to execute a script or script statement. The macro:

" SOURCE!"

where the first character (here displayed as blank) is ASCII 255,
performs the same sequence... without opening the F2 window.


DOS provides an obscure method for entering characters by their
ASCII value. To enter the ASCII value 255: hold down the
Alt-key, type '2' on the numeric pad, then type '5' on the numeric
pad, then type '5' again on the numeric pad, and finally, release
the Alt-key. The Alt-key must be held for the duration of the
2-5-5. The numeric pad must be used.


If the first character following the 255 is ".", subsequent text
is executed as a single script command. Otherwise, the text is
interpreted as a script file name to execute. In this way,
single script statements or entire script files may be tied to
a macro key (Alt-0 through Alt-9).


B. Load a new file (Alt-M subcommand F)

When COM-AND is loaded, the Macro Definition file as named through
the Alt-S setup menu is loaded. You may load a different file of
macros later, using the (F)ile subcommand of Alt-M. Note: when
you change the macro definition file, the change is reflected
in the Alt-S window (but isn't saved for the next time unless you
save the values in Alt-S).










Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 26


X. Macros (continued)


C. Clear entries (Alt-M subcommand C)

You may clear all macro definitions in COM-AND's memory (but not
in the current file) with the (C)lear command. To clear the file,
make blank entries (blank, ) for 0-9.


D. Execute entry (Alt-0 through Alt-9)

Macros are issued with the commands Alt-0 through Alt-9, outside
of Alt-M. The entry indicated by the number is transmitted.
What happens after is strictly up to what you've entered, the
service you're using, and the people around you.

As discussed above, the text of a macro may or may not be trans-
mitted. If the macro is plain text, it is transmitted. If the
macro contains commands for COM-AND to execute, it is executed.






























Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 27


XI. Encrypt/Decrypt (Alt-N)


Beginning with version 2.2, COM-AND performs file encryption and
decryption. COM-AND encrypted script files are automatically
recognized and decrypted in memory. Dialing directory, Macro
definition and Accessory definition files are not automatically
decrypted, but might be decrypted and reloaded through a script.


COM-AND implements two encryption methods:

o a simple encryption method; this method is appropriate for
script files which you plan to keep on your own machine, and
only wish to protect from casual perusal (e.g. passwords).

o a one-way encryption method; this method is only for scripts.
No password is required for this encryption. When a script
file encrypted this way is encountered, no password prompt is
issued to the screen. COM-AND does not decrypt one-way encrypted
files from Alt-N.


'Simple' encryption uses a simple XOR algorithm against the data.
It is not considered very secure, but appropriate to protect against
casual perusal. One-way encryption uses a similar algorithm, but
generates a password that cannot be entered by hand (through Alt-N).


Encrypted files are slightly larger than the original file. Infor-
mation as to true file size, file date/time and CRC checking is added
to the file. When the file is decrypted, the method used to encrypt
is recognized automatically, and the file is restored to its original
size, date and time. The decrypted file is deleted immediately if
a CRC check fails.


When you encrypt or decrypt a file (or when the script processor
recognizes an encrypted file with the exception of one-way encryp-
tion) you are asked for a password. COM-AND accepts up to 32 char-
acters for the password, and uses them to derive a 'key' for the
file. The password you supply is not the decrypting key. For the
maximum protection, it is recommended you use the full 32 characters
for a password.






Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 28


XI. Encrypt/Decrypt (continued)


---------------------------------------------------------------------
However, you must be able (somehow) to remember the password. Should
you lose the password, or if the encrypted file is modified in any
manner, there is very little chance of recovering the data. Neither
CABER Software nor the author will be liable for any damages or lost
revenues incurred through the use of this function beyond the
registration price paid for COM-AND.
---------------------------------------------------------------------


Encryption and decryption must be performed from one (input) file to
another different (output) file. Do not attempt to encrypt or
decrypt a file over itself. If there is insufficient space on the
target disk for the file, you are warned, and allowed to select a
new target disk or diskette or to abort.


Alt-N invokes a menu allowing selection of Encryption or Decryption.
You are prompted for each required parameter. When the process
begins, a display similar to file transfers provides an estimate for
the time required and a measure of its performance.


The COM-AND script processor searches for the extension ".ENF" as
well as ".CMD". The script processor searches first for the given
file name. If no match is found it then searches for the same file
name with the extension ".CMD". If no match is found the second
time, it searches for the same file name with the extension ".ENF".
[If the name is unqualified with drive:subdirectory and if there is
a COM-AND= environment variable, another three searches are done on
the drive:subdirectory indicated by the COM-AND= variable.]


Thus, if you want to encrypt a script file with no extension or with
the extension ".CMD", you must use one of two strategies:

o encrypt the file using a DIFFERENT name... and use the
different name when invoking the script (F2)... or

o encrypt the file to the same name with the extension ".ENF"
and then delete the original (after backup of course).






Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 29


XI. Encrypt/Decrypt (continued)


We suggest you use either the 'simple' method or 'one-way' method
to encode script files. Script files encoded with these methods
are decrypted and executed transparently... the differences is that
'one-way' encrypted scripts do not pop-up a prompt for a password.
---------------------------------------------------------------------


Previous versions of COM-AND included Federal Data Encryption
Standard (DES) compliant encryption. In 1992, CABER Software was
informed that it is not legal to ship software out of the U.S.
containing DES encryption. [Aside: Other countries are permitted to
sell DES software HERE... and do. U.S. companies, however, may not
sell this technology abroad!] In version 2.9, DES encryption has
been removed from COM-AND.


The Federal Data Encryption algorithm encodes data in 64-bit
'chunks'; each bit of each byte goes through many transformations,
and may end up anywhere in the 64-bit area. The simpler methods
also encode in chunks, but do not 'smear bits'.


The full Federal Data Encryption Standard (DES) algorithm in
software is not fast but may be considered fairly secure. The DES
is appropriate for files you wish to exchange publicly, but choose
to secure. However, it is SLOW.


It is not available in this version of COM-AND.


















Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 30


XII. Program Configuration (Alt-S, Alt-P, Alt-O, and Alt-J)


A. Setup Screen (Alt-S)

1. Modem control

. Modem initialization string

The modem initialization string is issued when COM-AND is
first loaded. It is not issued when the port is changed
during execution. If blank, it is ignored. Carriage
returns and control characters are specified as with macros.
Refer to Appendix M (Modem Configuration) for examples.

. Modem dialing prefix

The Modem dialing prefix commands the modem to begin a
dialing sequence. It is followed by a number from the
dialing directory (and long distance string, if specified).

. Modem dialing suffix

The Modem dialing string terminates each dialing command.
For Hayes type modems it should be a "!" (translated by
COM-AND to a ). It may be any string appropriate to
your modem. Carriage returns and control characters are
specified as with macros.

. Hangup string

The hangup string is issued (after a modem escape) when you
press Alt-H, if "drop DTR" is not set in Alt-O. Carriage
returns and control characters are specified as with macros.
Delays of 1/2 second each may be specified with a tilde (~)
(see "modem delay char" below).

. Escape string

The modem escape is issued before the hangup string (Alt-H),
and before each dialing attempt. Delays of 1/2 second each
are specified with a tilde (~). Carriage returns and
control characters are specified as with macros.

. Connect string

The connect string is used by the Alt-D dial and Alt-R redial
commands to determine when connection has been made.


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 31


XII. Program Configuration (continued)


A. Setup Screen (continued)

2. Files

All files specified here are searched under the current
drive:subdirectory, and under the drive:subdirectory
indicated through the COM-AND= environment variable, unless
the name given is explicitly qualified.

. Call-log file

The call-log file name determines the file to open for
call-logging (if call-logging is enabled, see below, Alt-O
Options, and Chapter XIV).

. Dialing directory file

The dialing directory file is used to initialize the
program's dialing directory. The current dialing directory
may be changed at any time from within COM-AND.

. Macro Directory file

The macro directory file is used to initialize the
program's macro definitions. You may change the current
macro definition at any time from within COM-AND.

. Accessory directory file

The COM-AND accessory function F1 requires a file to contain
definitions for accessories. You may have several files of
definitions and change at any time from within COM-AND.

. RLE temporary file

COM-AND recognizes RLE graphics images when they are encoun-
tered in the received stream, and buffer the image to disk.
This file name specifies the temporary file name.









Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 32


XII. Program Configuration (continued)


A. Setup Screen (continued)

3. Timings and Values

. Backscreen buffer size

Up to 64K for the backscreen buffer may be selected (or turn
it off altogether by setting it to 0K). This buffer is used
by the Alt-B redisplay, and by the F7 transcript command.

. Break delay

COM-AND issues a true break through the Ctl-End key. The
duration of the break is controlled here. "Break delay"
specifies the number of milliseconds the comm line is held.

. Alarm duration

The alarm duration value specifies the number of seconds an
alarm tune sounds when a function is terminated. Set this
to zero to inhibit the special termination alarm.

. Modem char delay

The modem char delay gives the number of milliseconds COM-
AND delays after each character of a modem control sequence
(e.g. dialing, hangup, initialization). Certain modems
require their control sequences be enunciated slowly.

. Reconnect delay

The interval between Alt-R redial (and scripted dialing)
attempts is specified here. 45 seconds is recommended for
long distance dialing. 30 seconds is usual for local calls.

. Chat Window

The size of the lower window in chat mode (where what you
type appears) may be changed. The size of the chat window
is limited to between 2 and 10 lines.

. Bell tone

COM-AND implements its own bell sound. You may set the tone
to any pleasant frequency (in Hz).


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 33


XII. Program Configuration (continued)


A. Setup Screen (continued)

3. Timings and Values (continued)

. Mouse vertical sensitivity

The vertical sensitivity of the mouse may be set here.
The higher the value used, the less sensitive the mouse.
The most sensitive value is 0.

. Mouse horizontal sensitivity

The horizontal sensitivity of the mouse may be set here.
The higher the value used, the less sensitive the mouse.
The most sensitive value is 0.

. Mouse double click interval

The double click interval of the mouse may be set here.
When a mouse button is pressed twice within this interval a
different action is taken than when it is only pressed once.

. Modem delay character

The modem delay character defaults to a tilde (ASCII 126).
It represents a 1/2 second delay in strings sent to the
modem (above) and strings sent with the script command
TRANSMIT. It may be redefined here.

. Xfer Screen Update Interval

At 9600 bps and above, the time taken to paint the status
screen becomes a significant percentage of the overall time
required for a file transfer. Setting the screen update
interval to '5' has a visible impact on performance, even at
2400 bps.


4. Save

You may change values for one execution of COM-AND, or you
may change them for all subsequent executions of COM-AND. If
you save values, the values you've saved are set the next time
you use COM-AND.



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 34


XII. Program Configuration (continued)


B. Communications Parameters (Alt-P)

Do not change the current setting after you've connected to a ser-
vice. XMODEM, YMODEM, ZMODEM, and CIS-B transfers can change (and
do change) to no parity (if necessary), but you shouldn't.

1. Port speed (bps)

Rate is specified through the first selections of the Alt-P
window. Other parameters (parity, data bits, and stop bits)
may be set individually or in combination (below).

2. E,7,1 and N,8,1

For convenience, the combinations Even parity/7 data bits/1
stop bit, and No parity/8 data bits/1 stop bit are provided
after the port speed selections.

3. Parity, Data bits and Stop bits

Individual settings for parity, number of data bits and number
of stop bits comprise the next items of this menu. You also
set these values when you create a dialing directory entry.

4. COM ports

The last items on this menu are the candidates for COM ports.
Select the appropriate port for your modem. This item is
usually selected once, and then left alone.

NOTE: If your computer is equipped with fewer than four serial
ports, an attempt to configure a missing port results in the
port being shown set at 115k bps. When a board is added with
the additional port (e.g. an internal modem set to work as
COM3 or COM4), COM-AND will recognize it.

-----------------------------------------------------------------
Note: All parameters may be set through the command parameters.
These parameters override the Alt-P default settings. Example:

"d>" COM-AND COM3 1200 DATA8 STOP1 NONE

Refer to Appendix A for the list of run-command parameters.
-----------------------------------------------------------------



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 35


XII. Program Configuration (continued)


B. Communications Parameters (continued)

5. Save

Current settings for the next execution of COM-AND are saved
through the "Save" selection. Settings are saved to disk.

6. Set Base/IRQ

COM-AND defaults the four supported comm ports to the values:

COM1: base address: 0x3f8, interrupt request # 4
COM2: base address: 0x2f8, interrupt request # 3
COM3: base address: 0x3e8, interrupt request # 4
COM4: base address: 0x2e8, interrupt request # 3

These may be changed through a submenu of the Alt-P menu.
Select 'Set Base/IRQ', and a submenu is opened. Current
values are displayed. Select a port and you are prompted
for new values.

Each port's base address is limited to the values 0-1023 (or
0 through 0x3ff). Each port's interrupt request number is
limited to the values 0-7.

The default values are appropriate for most applications.
Most people never need to change these settings. However,
should you need to do so, the capability is available.

DO NOT CHANGE these assignments unless you are sure you have
need to do so, and have the correct values at hand. If you
do not save the changes, COM-AND reverts to the defaults the
next time it is loaded (after Ctrl-Alt-Delete, for example!).

If COM-AND is directed to use a non existent port base
address, the result may range from: nothing happening what-
soever, to complete machine lockup (if there IS in fact a
device at that address able to respond to interrupt requests).
It is recommended you try new settings before saving them.

The meaning of the 'names' COM1, COM2, COM3, and COM4, as far
as COM-AND is concerned, is determined simply by these base
address and IRQ assignments.




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 36


XII. Program Configuration (continued)


C. Options (Alt-O)

1. Settings otherwise available

. Echo (also Alt-E)

Some services turn around what you type for you to see,
("full duplex" or echoplex), and some don't ("half duplex").
You may force COM-AND to display what you enter in the CRT
window by toggling echo. Setting echo on here turns echo
on immediately. Saving the setting causes echo to be turned
on the next time you run COM-AND. You may toggle echo
dynamically with Alt-E.

. Parity mask (also Alt-Z)

You may mask parity from received text by setting the parity
mask on permanently here. I've found this useful; mandatory
when I've needed it. Parity masking is toggled dynamically
with Alt-Z.

. Keyboard display (also F8)

Some talk systems are more friendly when what you type is
not mixed in with what you receive. Turning system echo off
(if the system echoes key-entry) is accomplished in a number
of ways (Note: this is different from Alt-E above), each
unique to the particular system.

However, all of a sudden there is a new problem: you don't
see what you're typing! Keyboard display in COM-AND is one
attempt to solve this problem. What you type is displayed
on the status line when keyboard display is enabled. You
may enable it on permanently through this option. Keyboard
display may be toggled dynamically with F8.

. Chat mode (also Alt-A)

Chat mode is another mechanism to allow you to see what
you've typed when echo has been turned off. Instead of just
one line of keyboard display, chat mode allows you to see
the last few (up to 10) lines you have typed. Chat mode is
toggled dynamically with Alt-A.




Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 37


XII. Program Configuration (continued)


C. Options (Alt-O) (continued)

1. Settings otherwise available (continued)

. Blank line suppression (also Alt-G)

You may enable blank line suppression on when COM-AND is
loaded, through this selection. Blank line suppression
may be dynamically toggled with Alt-G.

. In/Out Translate (also Alt-V)

You may turn on in/out character translation on when COM-AND
is loaded, through this option. Note: the file COM-AND.XLT
must be prepared prior to the use of this function. This
file may be prepared using the script XLATE.CMD.

. Remapping (also Alt-V)

You may turn on keyboard remapping on when COM-AND is loaded,
through this option. Note: the file COM-AND.RMP must be
prepared prior to the use of this function. Please refer to
to the script REMAP.CMD and its documentation REMAP.DOC.


2. Settings available only through Alt-O

. Nondestructive Backspace

You may toggle a destructive/nondestructive backspace func-
tion through this option. Nondestructive backspaces are not
required by many systems, but now and then it comes up.

. Backspace sent as delete

You may toggle the character transmitted as a backspace func-
tion through this option. Either backspace (decimal 8), or
delete (decimal 127, a.k.a. rubout) may be transmitted.

. CR -> CRLF received

You may toggle a CR/CRLF on received CR function through this
option. Most systems generate a CR and a LF to terminate a
line, but a few only generate a CR.



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 38


XII. Program Configuration (continued)


C. Options (Alt-O) (continued)

2. Settings available only through Alt-O (continued)

. Alarm noise

An alarm tune (of sorts) sounds when the Alt-R redial makes
connection, and when file transfer is complete. The noise
is also played when certain error conditions occur.

When disabled, the alarm window is held open without noise.
The duration of the noise (or noiseless pause) is controlled
through Alt-S Setup.

. Exit query

Some people dislike the query "do you really and truly mean
it?" when they type Alt-X. Others feel it mandatory. COM-
AND is distributed with exit query disabled. You may enable
it, if you're so inclined, through this Alt-O selection.

. Mark transcript

COM-AND marks every disk transcript taken (beginning and
end) with the date and time. You tell COM-AND not to mark
further transcripts through this Alt-O selection.

The transcript function also has the capability to add the
backscreen (the full backscreen buffer's worth) to the
transcript. Turning transcript marking off means there
will be no delimiter between the backscreen and transcript.

. Initial advertisement

In its distributed form, COM-AND's Information screen
(Alt-I) is set to display when the program starts. You may
disable the display through this Alt-O setting.

. Use BIOS for screen saves

You may set BIOS screen accesses permanently through this
option. COM-AND defaults to direct screen buffer reads and
writes. Some machines (and environments) require you to use
BIOS. See also Appendix J on multitasking, and "Use DOS
for screen writes", below.


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 39


XII. Program Configuration (continued)


C. Options (Alt-O) (continued)

2. Settings available only through Alt-O (continued)

. Use DOS for screen writes

You may set DOS screen writes permanently through this
option. When received text is written through DOS, ANSI.SYS
or other console driver is invoked (if you turn all emulation
off). See also Appendix J on multi-tasking, and "Use BIOS
for screen saves", above.

. Display control characters

COM-AND displays all displayable control characters if you
choose (as many BBS's use them). You may turn this feature
off and on through Alt-O according to the system you use.

. Software flow control (XON/XOFF)

COM-AND supports software flow control using the XON/XOFF
discipline. You may enable and disable software flow con-
trol according to the system(s) you use.

NOTE: If you enable software flow control, and use a high
speed modem, you should turn XON/XOFF flow control OFF in
the modem. Refer to your modem's manual.

. Unidirectional hardware flow control (OLD style!)

COM-AND supports a hardware flow control, raising RTS and
waiting for CTS, before transmitting a char. This function
may be permanently established here, according to your
needs. [This method is rarely used now.]

. Bidirectional hardware flow control (modern usage)

COM-AND supports a second, more modern, hardware flow
control, raising RTS when able to receive, and waiting for
CTS before transmitting. This function may be permanently
established here, according to your needs.

NOTE: Most of the modern, high speed modems require this
bidirectional flow control. Refer to your modem's manual.



Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 40


XII. Program Configuration (continued)


C. Options (Alt-O) (continued)

2. Settings available only through Alt-O (continued)

. Drop DTR to hangup

COM-AND disconnects either (1) by dropping DTR momentarily or
(2) using the hangup escape sequence specified in the Alt-S
setup. Only use the first method if your modem is configured
to follow DTR (see Appendix M, Modem Configuration).

. Re-initialize modem after HANGUP

COM-AND retransmits the modem initialization string (Alt-S
above) after HANGUP, when this is ON. If you alter modem
settings (say, through a script) for individual connects,
reinitializing after HANGUP ensures the modem is always in
a proper default state.

. Call-logging

COM-AND logs successful connections, hangup, carrier drop-
outs, file transfers and file encrypt/decryptions to a call-
log when call-logging is enabled. The name of the current
call-log is declared through Alt-S. Please refer to Chapter
XIV, page 55.

. Screen clock

COM-AND displays the current time (as "hh:mm:ss" if no
connection is known, and as "hh:mm (hh:mm)" showing current
time and time since connection) on the status line when the
Alt-O screen clock is ON. The reminder "Press F10 for help"
is displayed when the screen clock is OFF.

. Suppress bells

COM-AND does not sound received bell characters when this
option is enabled.

. Menu mode

COM-AND supports a menu mode offering most all customary
functions for execution with a mouse. This mode may be set
permanently here (interactively toggled with Alt-equal).


Version 2.9: 921203

COM-AND: IBM PC Communications and Accessories Page 41


XII. Program Configuration (continued)


C. Options (Alt-O) (continued)

2. Settings available only through Alt-O (continued)

. Respect CD

COM-AND monitors carrier detect unless you turn the function
off here (or with the /T run-time switch). Carrier detect
(CD) is monitored during file transfers and after successful
connection through the dialing directory.

. Suspend comm during disk (PCJr)

This mode suspends the comm line (using flow control) during
disk I/O. This is needed on PCJrs and for (some) high speed
communications (machine dependant).

. Capture/Display RLE files

COM-AND recognizes RLE files as they are received, and cap-
tures them to disk while displaying them (if you have EGA
or CGA). It may be permanently enabled it here. See also
Appendix J on multi-tasking.

. Allow MUSIC

COM-AND plays music escape sequences when received when this
function is enabled. Music escape sequences take the form:
"ESC,[,M,,^N".

. Allow REMOTE

COM-AND performs script commands received over from a REMOTE
system when this is enabled. REMOTE sequences take the form:
"ESC,^,