Category : OS/2 Files
Archive   : LOG230.ZIP
Filename : LOGICOMM.DOC

² ²²²²² ²²²² ² ²²²²² ²²²²² ²² ²² ²² ²²
² ² ² ² ² ² ² ² ² ²² ² ² ²² ²
² ² ² ² ² ² ² ² ² ² ² ² ²
²²²²² ²²²²² ²²²² ² ²²²²² ²²²²² ² ² ² ²





.....ÍÍͱÍÍÍ...........ÍÍͱÍÍÍ..........ÍÍͱÍÍÍ
.....ÍÍͱÍÍÍ...........ÍÍͱÍÍÍ..........ÍÍͱÍÍÍ\ ÉÍÍÍÍ»
± ± ± \ º º
± ± ± \ÈÍÍÍͼ
± ± ± ÚÄÄÄÄÄÂÄÄ¿
± ± ± ³ ÃÄÄ´
± ± ± ÀÄÄÄÄÄÁÄÄÙ




Version 2.30 Copyright (C) 1990


LOGISTIQUE LMM
6577 First Avenue
Montreal, Quebec
Canada, H1Y 3B2
(514)-727-1368 (Voice)
(514)-374-9422 (DATA)

LogiCOMM i




TABLE OF CONTENTS


COPYRIGHT NOTICE...................................... iii

DISCLAIMER............................................ iii

LICENSE AGREEMENT..................................... iv

REGISTRATION AND ORDERING INFORMATION................. v

ORDER FORM............................................ vi

PREFACE TO VERSION 2.30............................... vii

1. INTRODUCTION....................................... 1

1.1 LogiCOMM Description......................... 1
1.2 System Requirements.......................... 1
1.3 LogiCOMM Files............................... 1

2. STARTING LOGICOMM.................................. 3

2.1 Starting a LogiCOMM Session.................. 3
2.2 Terminal Mode................................ 3
2.3 Getting Help................................. 4
2.4 Going Online................................. 4

3. LOGICOMM FEATURES.................................. 6

3.1 Send Break................................... 6
3.2 Clear Screen................................. 6
3.3 Dialing Menu................................. 7
3.3.1 Selecting an Entry.................... 7
3.3.2 Adding, Editing, and Deleting Entries. 7
3.3.3 Dialing Numbers....................... 8
3.3.4 Changing Directories.................. 8
3.3.5 Access Codes.......................... 8
3.4 Local Echo Toggle............................ 9
3.5 File Directory............................... 9
3.6 Change Directory............................. 9
3.7 Hang up...................................... 9
3.8 Display Information.......................... 10
3.9 User Hot Keys................................ 10
3.10 Logfile Open/Close.......................... 11
3.11 Logfile Suspend/Resume...................... 11
3.12 Macro Menu.................................. 12
3.13 Printer Toggle.............................. 13
3.14 Line Settings Menu.......................... 13
3.15 Dialing Queue............................... 14
3.16 Redial Last Number.......................... 14
3.17 Redisplay Buffer............................ 14
LogiCOMM ii


3.18 CR/LF Toggle................................ 14
3.19 Exit LogiCOMM............................... 15
3.20 Send Auto-Answer String..................... 15
3.21 Help Screen................................. 15
3.22 Call Logging................................ 15

4. FILE TRANSFERS..................................... 16

4.1 Transferring Files........................... 16
4.2 Transfer Protocols........................... 17
4.2.1 Xmodem................................ 17
4.2.2 Xmodem 1K............................. 17
4.2.3 Ymodem................................ 17
4.2.4 Ymodem-G.............................. 18
4.2.5 CIS QuickB............................ 18
4.2.6 ASCII Transfers.........................18

5. CONFIGURING LOGICOMM............................... 19

5.1 Setup Options................................ 19
5.2 Modem Setup.................................. 19
5.2.1 Init String........................... 20
5.2.2 Dial Prefix/Dial Suffix............... 20
5.2.3 Answer String......................... 20
5.2.4 Hangup String......................... 20
5.2.5 Carrier Timeout....................... 20
5.2.6 DTR Control........................... 21
5.3 Connect Strings.............................. 21
5.4 Terminal Setup............................... 22
5.4.1 Terminal Emulation.................... 22
5.4.2 Duplex................................ 22
5.4.3 XON/XOFF.............................. 22
5.4.4 LF After CR........................... 23
5.4.5 Download Priority..................... 23
5.4.6 Alarm Time............................ 23
5.4.7 Popups................................ 23

5.5 Path/Hot Keys................................ 24
5.5.1 Default Download Directory............ 24
5.5.2 User Hot Key Configuration............ 24
5.6 Color Setup.................................. 25
5.7 Protocol Setup............................... 26
5.7.1 ASCII Uploads......................... 27
5.7.2 CIS QUICK B........................... 27

6. APPENDIX A -Common Problems........................ 28

7. APPENDIX B -Product Support........................ 30

8. APPENDIX C -Acknowledgements....................... 31

LogiCOMM iii



Copyright

LogiCOMM is Copyrighted (c) 1988, 1989, and 1990
by Logistique LMM.

This document is Copyrighted (c) 1989, 1990
by Logistique LMM.

No part of LogiCOMM or this document may be reproduced,
stored in a retrieval system, or transmitted in any form or
by any means, electronic, mechanical, photocopying,
recording or otherwise except as in accordance with the
Licensing Agreement below, or without the prior written
consent of Logistique LMM


Disclaimer

LogiCOMM and all accompanying written materials
(including instructions for use) are supplied "AS IS"
without warranty of any kind. Logistique LMM does not
warrant, guarantee or make any representations regarding the
use, or the results of use, of LogiCOMM or the written
materials in terms of correctness, accuracy, reliability,
currentness, or otherwise. Logistique LMM will not be
responsible for any direct, indirect, consequential, or
incidental damages (including damages for loss of business
profits, business interruption, loss of business
information, and the like) arising out of the use or
inability to use LogiCOMM even if Logistique LMM has been
advised of the possibility of such damages.
LogiCOMM iv



License Agreement

LogiCOMM is Copyrighted (c) 1990 by Logistique LMM.

LogiCOMM is not, and has never been public domain or
free software.

LogiCOMM is distributed under the Shareware concept.
Non-registered users of LogiCOMM are granted a limited
license to use LogiCOMM for a trial period not to exceed
30 days in length in order to determine whether LogiCOMM
suits their needs. Under no circumstances can an un-
registered version of LogiCOMM be used by a business,
organization, or institution of any kind.
All users are granted a limited license to distribute
shareware versions of LogiCOMM subject to the following
restrictions:

- LogiCOMM is distributed in unmodified form,
along with all program, documentation, and any
other files present in the original package.
- LogiCOMM is not bundled with any other product.
- No distribution fee is charged other than
nominal duplication or media charges.

Registered users may receive upgrades from Logistique
LMM from time to time. Registered copies are NEITHER free
software nor shareware. Users are granted unlimited use of
registered copies of LogiCOMM subject to the following
restrictions:
- LogiCOMM may be installed on more than one
computer at a time, so long as only ONE version
is run at one time.

- Users are not free to copy, modify, or
redistribute registered copies of LogiCOMM IN
ANY WAY whatsoever.

Bulletin Board Services are free to post LogiCOMM for
downloading to prospective users, providing that no fee is
charged for such downloading, aside from possible connect
charges.
Any other groups, companies, or organizations who wish
to distribute LogiCOMM must obtain prior written approval
from Logistique LMM.
LogiCOMM v



Registration and Ordering Information

Registering LogiCOMM will entitle you to continued use
of LogiCOMM beyond the trial period. Registration will
also entitle you to receive technical support.




To register your copy of LogiCOMM, fill out the order
form on the following page, and send it, along with a cheque
or money order for $35 in U.S. funds to:

Logistique LMM
6577 First Avenue
Montreal, Quebec
Canada, H1Y 3B2

A comercial version of LogiCOMM is also available.
This version includes a full featured script language and
two printed manuals. Please phone or write for details.
Corporate users and other institutions should inquire
at the above address regarding charges for site licensing of
LogiCOMM.
Note that continued use of an unregistered copy is a
violation of the licensing agreement. Support Shareware-
register your copy today!
LogiCOMM vi



Order Form


LogiCOMM version 2.30S
------------------------------------------------------------

LogiCOMM 2.30 Registration fee @ $35 U.S. ____

LogiCOMM 3.0x (includes commercial version with scripting & ZMODEM): $CALL$

Prices are valid as of Jan 1, 1990 and are subject to change without notice.
Please call or write for current prices.

Please make cheques or money orders payable in U.S. funds to LOGISTIQUE LMM


NAME_______________________________________________________

Company____________________________________________________

ADDRESS____________________________________________________

____________________________________________________

____________________________________________________

PHONE ____________________ Business ______________________



Where did you obtain LogiCOMM (if BBS please include full
phone number)?

______________________________________________________



Comments/Suggestion?


______________________________________________________

______________________________________________________

______________________________________________________

______________________________________________________



LogiCOMM vii



PREFACE TO VERSION 2.30



Version 2.30 of LogiCOMM is a maintenance release. A
few minor bugs in the program have been fixed, along with
some minor cosmetic changes. Documentation changes have been
made to correct order information.


PREFACE TO VERSION 2.20S


Quite a number of changes and enhancements have gone
into version 2.20S of LogiCOMM. We recommend that you start
off with a fresh directory containing only the new
LogiCOMM.EXE.
In particular, the dialing directories used in all 1.x
versions are no longer compatible. This has been done to
allow the inclusion of script file names with a particular
dialing entry.
Some of the new functions in LogiCOMM include:

Call Logging
Enhanced configuration menus
Telephone access codes
CIS QUICK-B
YMODEM-G
ASCII Uploads
Redisplay buffer
VT100 support

LogiCOMM 1



1. INTRODUCTION

1.1 LogiCOMM Description

LogiCOMM is a terminal communications program
written specifically for IBM's Operating System 2 (OS/2).
The program has been designed to provide access to many
commonly used telecommunications tasks. Some of the many
features offered by LogiCOMM are:

- A 200 entry dialing library.
- Dialing queues and automatic redial.
- Telephone access code capabilities.
- Keyboard macros.
- Many common file transfer protocols, including:
- XMODEM
- XMODEM 1K
- YMODEM
- YMODEM-G
- CompuServe QuickB protocol.
- Background communications capabilities.
- The ability to run simultaneous communications
sessions.
- Extensive on-line help facility.
- User-defined hot keys.


1.2 System Requirements

LogiCOMM requires an 80286 or 80386 based computer
running IBM's Operating System 2 (OS/2). In addition, the
OS/2 device driver COM01.SYS or COM02.SYS must be installed
in the CONFIG.SYS file. LogiCOMM will only run in protected
mode: it does not run in the DOS 3.x compatibility box, or
under MSDOS. LogiCOMM is a text-based application, and so
will not make use of the graphical interface provided by the
Presentation Manager (PM). It can, however, be run as is
under the PM with no problems, so long as video popups are
disabled (see "TERMINAL SETUP", below.
Many of LogiCOMM's default settings assume that the
computer is attached via a full-configuration cable to a
100% Hayes-compatible modem. If your modem is not 100% Hayes
compatible, or if the cable is not a full-configuration
cable, then it may be necessary to change some of the
default settings (see "CONFIGURING LOGICOMM", below).


1.3 LogiCOMM Files

The LogiCOMM distribution diskette contains the
following files:
- LOGICOMM.DOC -program documentation
- LOGICOMM.EXE -executable code for LogiCOMM
LogiCOMM 2


- README.1ST -documentation updates and
corrections.
When LogiCOMM is run, a number of other files may be
subsequently created:

- LOGICOMM.DIR -dialing library
- LOGICOMM.MAC -macro strings
- LOGICOMM.INI -default initialization values
- LOGICOMM.LOG -online log file

We recommend that you do not have any files with the
same names in the same directory as LogiCOMM. In
particular, LogiCOMM will not function correctly if other
files named LOGICOMM.INI and LOGICOMM.DIR exist.
LogiCOMM 3




2. STARTING LOGICOMM


2.1 Starting A LogiCOMM Session

Starting LogiCOMM is as simple as typing "LOGICOMM" at
the OS/2 command prompt. You will be presented with two
sign-on messages, each of which is terminated by hitting any
key. During the startup process LogiCOMM looks for
LOGICOMM.INI in order to determine the default screen
colors, communications port, modem initialization strings,
etc. If LOGICOMM.INI does not exist, then it is created in
the startup directory, and LogiCOMM will assume a number of
default values. LogiCOMM is initially configured for use
with a monochrome monitor.
LogiCOMM will next try to open the default serial port
(which is COM1 the first time LogiCOMM is executed). If
LogiCOMM cannot access the serial port for any reason (e.g.
if the port is being used by another process, by the mouse,
or COM0x.SYS is not installed), LogiCOMM will display a
message and prompt the user for an alternate serial port:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º The specified COM port cannot be º
º accessed. Choose COM1, COM2, or º
º COM3 (1,2,3) or ESC to exit: º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

If no alternate serial ports exist, LogiCOMM must be
exited, and a serial port freed up before continuing.
Alternately, it may be necessary to install the serial port
device drivers COM01.SYS ( for the AT and compatibles) or
COM02.SYS (for PS/2 computers).


2.2 Terminal Mode

After reading the two sign-on screens, LogiCOMM will
present the user with a blank screen. LogiComm is now in
terminal mode. Anything that is typed at the keyboard will
be sent to the serial port, while anything that comes in
from the serial port will be echoed to the screen. In
addition, the user may now execute most of LogiCOMM'S
special functions by typing in a given ALT-key combination.
A complete list of LogiCOMM functions may be obtained at any
time by pressing the key combination ALT-Z. This will call
up the help facility.
LogiCOMM 4



2.3 Getting Help

From terminal mode, it is possible to invoke on-line
help by typing ALT-Z (the 'Z' key is pressed while holding
down the ALT key). This will present the user with a list of
all ALT-key commands. Detailed help is available for each
entry by moving the highlighted bar to the entry of choice,
and pressing ENTER. The command keys available are:

ALT-A - Execute Script File.
ALT-B - Send break signal.
ALT-C - Clear terminal screen.
ALT-D - Dialing Directory.
ALT-E - Local ECHO toggle.
ALT-F - File Directory.
ALT-G - Change Directory.
ALT-H - Hang up line.
ALT-I - Display Information.
ALT-J - User Hot Key #1
ALT-K - User Hot Key #2
ALT-L - Logfile Open/Close
ALT-M - Macro menu.
ALT-N - Printer Online/Offline Toggle.
ALT-P - Line Settings menu.
ALT-Q - Dialing queue.
ALT-R - Redial last number.
ALT-S - Setup menus.
ALT-T - Suspend/Restart logfile output.
ALT-U - User Hot Key #3
ALT-V - Cr/Lf Toggle.
ALT-W - Redisplay buffer.
ALT-X - Exit LogiCOMM.
ALT-Y - Send Auto Answer string.
ALT-Z - Display Help Menu.
Pgup - Upload a file with a protocol.
Pgdn - Download a file with a protocol.


A complete description of each command is given in the
following sections. In addition, on-line help is available
from all menus by pressing the F1 key.


2.4 Going Online

The terminal screen is your interface to a remote
system. When you first start LogiCOMM, your screen is blank
except for a flashing cursor. If you type the letters AT
followed by a return you should see the word OK sent to you
by the modem. If these letters do not appear, you may need
to set up the communications port. Pressing ALT-P will call
up the Line Settings menu and allow you to select the
appropriate baud rate, parity, data size, and stop bits. If
LogiCOMM 5


you need help at any time, pressing the F1 key will give you
a description on how to use the settings menu.
Once your settings have been selected the easiest way
to call up a remote system is to use the built in dialing
facilities of your modem. Typing the letters ATDP followed
by the telephone number of the online system will place the
call, and if the line is free, connect you to the host.
Of course many of these functions may be automated. In
particular, the dialing library is a very powerful feature.
The next section lists all of LogiCOMM's features. Remember
that help is only a keystroke away.
LogiCOMM 6





3. LOGICOMM FEATURES


LogiCOMM has been designed to provide many of commonly
used communications functions and a set of enhancements that
can increase productivity and ease of use. The following
sections outline all of LogiCOMM'S features.

3.1 Send Break

ALT-B send a 500ms break signal to the modem. This
facility is needed on some systems where a break signal is
recognized as a user-interrupt.


3.2 Clear Screen

ALT-C clears the screen to the current foreground and
background colors, as determined either by the values in
LOGICOMM.INI, or the values selected from the "Select
Colors" menu. Since LogiCOMM operates as an ANSI terminal it
supports full color escape sequences as sent by the host.
Thus it is possible that the colors you have selected may be
changed by the host system you are connected to.




3.3 Dialing Menu

LogiCOMM provides a full featured dialing directory
that allows automatic dial and redial of any of 200 numbers.
The dialing directory is invoked from terminal mode by
pressing ALT-D. The first time LogiCOMM is started, this
directory does not exist but will be created.
LogiCOMM 7



ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Current Directory: D:\LOGICOMM\LOGICOMM.DIR F1-HELPº
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄĶ
º # NAME ³ Phone Number ³ BAUD P D S³ Script º
º ³ ³ ³ º
º 1 Logistique LMM ³ 514-374-9422 ³ 2400 E 7 1³ º
º ³ ³ ³ º
º ³ ³ ³ º
º ³ ³ ³ º
º ³ ³ ³ º
º ³ ³ ³ º
º ³ ³ ³ º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄĶ
º [ESC] Exit menu [PgUP] next page [A]dd entry [N]ew dir º
º [HOME] first page [PgDN] prev page [C]hange entry [M]anual dial º
º [END] last page [SPACE] mark [K]ill entry [R]edial last º
º [up/dn]Select entry [CR] dial # [Q]ueue call [#]Access codesº
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ


3.3.1 Selecting an Entry


To select an entry, the up and down arrows are used to
move the highlighted cursor over the desired selection. The
PgUp and PgDn keys may also be used for moving through the
directory a page at a time. Finally, the HOME and END keys
may be used to move to the first or last page of entries in
the directory. To mark an entry for the dialing queue,
select the entry and press the space bar. Marked entries are
shown in the directory with an arrow next to their name. To
unmark a directory entry, select the entry and press the
space bar a second time.


3.3.2 Adding, Editing and Deleting Entries

To edit an existing entry, select the entry to be
edited and press "C". To add a new entry to the directory,
simply press "A". New entries are added at the end of
directory. To remove an entry, press "K". You will be
prompted for verification before the entry is deleted.
When editing or adding an entry, the user is prompted
for the name of the host system, the telephone number, and
the line settings at which the connection should be made.
The user is also prompted for the name of a script file
which will be executed automatically upon connect. Note that
the only optional fields are the name field and the script
field.
To abort editing, hit ESC at any time, and the previous
entry will be restored.
LogiCOMM 8



3.3.3 Dialing Numbers

To dial a single number, select the entry to dial and
press return. LogiCOMM will try to call the number
continuously until a connection is made, or until the user
aborts dialing by pressing the ESC key.
To dial a number not in the directory, press the "M"
key. The user will be prompted for host name, number, and
line settings. The dialing will then proceed as for any
other number in the directory.
To redial the last number that was tried, press "R".
To dial multiple entries, mark each entry to be dialed
by selecting it and pressing the space bar. Pressing "Q"
will then enter the dialing queue, where each number will be
dialed in turn until a connection is made. As each number
connects, it is removed from the queue. During queue
dialing, the user may press the space bar to retry the same
number before moving on to the next entry, or he may delete
an entry from the queue by pressing the DEL key.
Alternatively, the user may abort queue dialing altogether
by pressing the ESC key.
NOTE: When dialing is aborted, LogiCOMM will signal the
modem by dropping DTR if DTR control is ON, or by sending
the modem a hang-up string if DTR control is OFF.


3.3.4 Changing Directories

LogiCOMM supports multiple dialing directories. To load
an alternate directory, press "N". You will be prompted for
the name of an alternate library. If the file specified does
not exist, a new blank directory is created. LogiCOMM will
search for the desired library in the current directory, the
start-up directory, and along the path specified by the OS/2
environment variable DPATH.

3.3.5 Access Codes

Many phone systems require dialing a prefix or access
code to obtain an outside number. Pressing the # key will
present a menu that will allow the entry of up to six
telephone access codes. The fields are selectable using the
cursor keys and entries may be added or changed by pressing
the C key. Each entry has a letter associated with it.
Placing this letter in the number field of a dialing entry
will cause LogiCOMM to send the appropriate numbers to the
modem during dialing.
For example, if access code A is set to "9,,", and the
phone number for entry 1 is "A555-1234", then when entry
number 1 is dialed, the modem is sent the number "9,,555-
1212". Note that to include the access code, the letter used
must be UPPER case. The code letter may appear anywhere
within the string.
LogiCOMM 9






3.4 Local ECHO Toggle

ALT-E toggles the current local echo (duplex) between
on and off. When local echo is on, (half duplex), characters
typed at the keyboard are echoed to the screen. Local echo
should be set ON for systems that do not echo characters
back to you. If you see that characters are rreeppeeaatteedd
then you should set the echo mode to off (full duplex).


3.5 File Directory

ALT-F invokes the display directory command. The user
will be prompted for a filespec which can include wildcard
characters ('*' and '?').


3.6 Change Directory

ALT-G allows the user to change the default directory
and/or the default drive. This directory does not affect the
default download directory used for downloading files.This
command is useful for changing the logged in directory when
many file uploads are being performed.




3.7 Hang up

ALT-H directs LogiCOMM to hang up the line. The user is
prompted for verification before the line is disconnected.
The specific action taken by LogiCOMM when ALT-H is pressed
depends upon the setting of the DTR (Data Terminal Ready)
control variable (See "MODEM SETUP", below).
If DTR control is set ON, then LogiCOMM will hang up
the modem by dropping the DTR signal to the modem. This is
the preferred mode of operation, and should be used if the
modem can recognize DTR handshaking. Please refer to your
modem documentation. Also note that this may be selectable
as either a switch setting or as a software command
depending on the modem.
If DTR control is set OFF, the modem will hang up by
sending the modem hangup string (in the "MODEM SETUP" menu).
LogiCOMM 10



3.8 Display Information

ALT-I displays an information screen containing
information on a number of current program settings:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º INFO º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º Line Settings: 1200,N,8,1,COM1 º
º Duplex: Full º
º CR/LF Toggle: Off º
º DTR Control: On º
º XON/XOFF: On º
º Log File: Closed º
º Line Status: Offline º
º Time: 06:00 º
º Elapsed Time: 00:00:00 º
º Printer: Offline º
º º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

Line status reflects the current state of the carrier
detect line. This value will accurately reflect the modem's
current connect status if the modem is connected with a full
configuration cable, and if the modem is configured so that
the value of the CD (Carrier Detect) line follows the modems
actual connect status. Once again this may be selectable as
either a hardware switch setting or in software.



3.9 User Hot Keys

LogiCOMM provides a user Hot Key facility which can be
used to start another program in a foreground or background
session. There are three hot-keys accessed by the keystrokes
ALT-J, ALT-K, and ALT-U. Initially these keys are not
assigned to any function and must be configured in the user
hot-key setup menu.
Briefly, there are three fields that will need to be
filled. A given field is selected with the cursor keys and C
is pressed to edit the field.

ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º User Hot Key 1 (ALT-J) º
º Path: º
º Parms: º
º Mode: Foreground º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ


The first is the Path field. This field must contain
the complete path including drive specs and the full
LogiCOMM 11


filename of the program to be executed. For example, if you
had a utility called ARC.EXE on drive C: in the UTILS
directory, you would enter "c:\utils\arc.exe" in this field.
Note that this program will be executed as a stand alone
process in its own session and upon termination will close
this session completely. Thus if the program prints
something on the screen and then immediately terminates, you
will most likely not see anything as the session will
finish.
The next field allows passing of parameters to a
program selected with a hot key. There are three ways to use
this field. The first is to leave it blank. In this case the
running program will not pass any parameters to the program.
The second is to enter a string used by the program. In the
above example, entering *.arc will result in the string
*.arc being passed to the ARC.EXE program specified in the
PATH field. The last method is used if you wish a runtime
prompt from LogiCOMM for the parameters to pass to the
program. When this method is selected LogiCOMM will prompt
you for the parameters. To select this method place a
reverse quote ` in the parms field for the particular hot
key in question.
The final field is the Fore/Background field. This
field defines whether the program runs in the foreground or
background. If the session is to run in the foreground,
LogiCOMM is moved to the background. If it is to run in the
background LogiCOMM presents a message and then continues to
run. Note if there are any errors in the path parameters,
LogiCOMM will inform you of these and not execute your
program.


3.10 Logfile Open/Close

ALT-L invokes LogiCOMM's logging process: the user is
prompted for a filename to which all serial port input data
is saved. If the chosen file already exists, the user has
the option of entering a new filename, overwriting the
existing file, or appending data to the existing file.
If a logfile is currently open, ALT-L will close it. To
temporarily suspend output to the log file without closing
it, use ALT-T (Logfile Suspend/Resume). This command
effectively acts as an ASCII receive protocol. You must not
confuse this command with the automatic call logging that
LogiCOMM performs. See section 3.22.


3.11 Logfile Suspend/Resume

If a logfile is currently open, pressing ALT-T will
suspend output to the file until another ALT-T is pressed.
If there is no logfile currently opened, pressing ALT-T has
no effect.
LogiCOMM 12



3.12 Macro Menu

In terminal mode, LogiCOMM will recognize the twelve
function keys F1 to F12 and output a string that may be
assigned to them.
To change or load these macro strings, press ALT-M from
terminal mode. The user will be presented with a menu of
existing macro strings and edit options:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Macro Strings F1-HELP º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º F1 : Welcome to LogiCOMM º
º F2 : º
º F3 : º
º F4 : º
º F5 : º
º F6 : º
º F7 : º
º F8 : º
º F9 : º
º F10: º
º F11: º
º F12: º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º Current Macro File: D:\LOGICOMM\logicomm.mac º
º [up/dn] Select [C]hange entry [L]oad menu [S]ave menu [ESC] quit º
º Special characters: ~ pause ^ control code º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

To modify an entry, use the up/down arrow keys to
highlight the desired entry. Pressing "C" will place you
into edit mode. In edit mode, the left and right arrows will
move the cursor in the respective direction, the INS key
will toggle insert/overwrite mode, and the HOME and END keys
may be used to move to the beginning and end of the string,
respectively. To accept the edited string, press ENTER. To
abort an edit and keep the original string, press ESC.
Embedding control characters in the string sent may be
accomplished by using the caret character ('^') to preface
the letter corresponding to the desired control code. For
example, to send a carriage return (control-M), the
character string "^M" would be used. Note that the ASCII
character following the caret must be in uppercase. To send
a caret character itself you would have to send two carets
in a row (^^).
It is also possible to embed a pause in the string
being sent to allow the host system time to process what it
has already received. To embed a 1/2 second pause, insert a
tilde character "~" in the string. Longer pauses may be
obtained by entering multiple tildes.
LogiCOMM 13


Alternate macro files may be loaded by pressing the L
key, and the edited file may be saved by pressing the S key.
Saving the macro string file under the name "LOGICOMM.MAC"
has special significance since if LogiCOMM finds a macro
file with this name during startup, it will be automatically
loaded. LogiCOMM will search for the default macro string
file in the current directory, as well as along the path
specified by the OS/2 environment variable DPATH.


3.13 Printer Toggle

Pressing ALT-N will toggle the printer online or
offline. When online, all data that comes in from the serial
port is also echoed to the printer. Note that if the OS/2
print spooler is being used, output may not be directed to
the printer until it is toggled offline by pressing ALT-N
once again. The ALT-I key may be used to see the current
printer status.



3.14 Line Settings Menu

ALT-P invokes the line settings menu, which will allow
the user to change current communications port settings:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º >>>SETTINGS MENU<<< º
º º
ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÑÍÍÍÍÍÍÍÍÍÑÍÍÍÍÍÍÑÍÍÍÍÍÍÑÍÍÍÍÍÍÍ͹
º Baud Rate ³ Parity ³ Stop ³ Data ³ Port º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄÄÄĶ
º ³ ³ ³ ³ º
º 300 4800 ³ NONE ³ 1 ³ 7 ³ COM1 º
º 1200 9600 ³ ODD ³ 1.5 ³ 8 ³ COM2 º

º 2400 19200 ³ EVEN ³ 2 ³ ³ COM3 º
º ³ ³ ³ ³ º
ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÏÍÍÍÍÍÍÍÍÍÏÍÍÍÍÍÍÏÍÍÍÍÍÍÏÍÍÍÍÍÍÍ͹
º º
º arrows:Move cursor [CR] Select ESC Escape º
º [S] Save to disk [F1] Help º
º º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

To change a particular setting, move the cursor with
the arrow keys until it is over the desired setting, then
press ENTER. To save the current settings as a default,
press "S". LogiCOMM will not allow you to change the serial
port to a port that does not exist.
LogiCOMM 14



3.15 Dialing Queue

ALT-Q will sequentially dial selected numbers until a
connection is made. For information of entering numbers into
the dialing queue, see "DIALING DIRECTORY".

3.16 Redial Last Number

ALT-R will redial the last number that was dialed,
regardless of whether the last dialing attempt was
successful. It will redial the previous number, even if the
previous number was a manual entry. For more information on
dialing a phone number, see "DIALING DIRECTORY".


3.17 Redisplay Buffer

ALT-W selects LogiCOMM's redisplay buffer. This feature
will allow you to review the last 32 kilobytes of data that
were received through the communications port. You may
scroll through the data using the cursor keypad (PgUp, PgDn,
Home,End,up,down,left,right).
In addition, it is possible to search the buffer for a
specific string by pressing "F". You will then be prompted
for the string. Pressing F3 will continue the search from
the last highlighted position.
It is possible to mark a section of the buffer by pres-
sing "M" at the beginning and end of the block. This block
may then be saved to a disk file by pressing "W". You will
be prompted for a file name. If no block has been selected,
the entire buffer will be saved. If the file exists it will
be overwritten.
Finally, the contents of the buffer may be erased by
pressing "C".



3.18 CR/LF Toggle

ALT-V will toggle the current CR/LF toggle switch. When
ON, LogiCOMM will append a linefeed character to all
incoming carriage returns. This setting should be used when
the host does not transmit linefeed characters and
characters appear to be overwritten. When OFF, no linefeeds
are appended.
LogiCOMM 15



3.19 Exit LogiCOMM

ALT-X will exit LogiCOMM. The user will be prompted for
verification before exiting. Note that due to the current
nature of the OS/2 serial port driver, it is not possible to
exit without dropping DTR and thus hanging up the phone
line.
To shell to DOS without losing the connection, the user
may use the ALT-ESC or CTRL-ESC features in the OS/2 session
manager. Alternatively, the user can execute a copy of
CMD.EXE though use of one of the hot keys. If this is done
as a foreground session you effectively have a shell to DOS.


3.20 Send Auto-Answer String

ALT-Y will cause LogiCOMM to transmit the string stored
in the "Answer String" field of the setup menus (see below
for information on changing this string). By default, this
string is "ATS0=1^M", which will cause Hayes compatible
modems to switch into auto answer mode, and answer incoming
calls on the first ring.


3.21 Help Screen

ALT-Z will popup a help menu outlining available
command keys. Extended help is available for each entry in
this menu by moving the highlighted cursor to an entry and
pressing ENTER. There are two fields that offer features for
a Users convenience. These are the Hayes/USR command summary
which is a summary of the Hayes AT command set. The other
feature is an ASCII table in the help section "ASCII
uploads".


3.22 Call Logging

LogiCOMM automatically maintains a log of online calls
and connect times. This information is placed in a file
called LOGICOMM.LOG. Each time a number is dialed and a
connection is made, an entry is written to this file. The
entry contains the name of the system, the date and time of
connect, and the elapsed connect time. Note that in order
for this function to work correctly, it is necessary to have
a modem whose carrier detect line (CD) follows the actual
modem connection and is not forced true all of the time.
Consult your modem documentation for information on switch
settings etc.
LogiCOMM 16




4. FILE TRANSFERS


4.1 Transferring Files

File transfers may be selected by pressing either the
PgUp key to upload a file (transfer a file FROM LogiCOMM to
the host system), or PgDn to download a file (transfer a
file TO LogiCOMM from the host system).
The user will be presented with a menu of possible
protocols to select from:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Transfer Protocols º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º XMODEM º
º XMODEM 1K º
º YMODEM º
º YMODEM-G º
º CIS Quick B º
º ASCII º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º [up/dn]Select [CR] Choose º
º [ESC] Exit [F1] Help º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ


Move the highlighted cursor to select the appropriate
file transfer protocol and press return. It is also possible
to configure LogiCOMM to automatically perform CompuServe
Quick B protocol uploads and downloads by modifying the
protocol setup (see "CONFIGURING LOGICOMM"). To transfer an
ASCII file, the ALT-W command is used instead.
When a protocol is selected, the user may or may not be
prompted for a filename depending upon the protocol. When a
valid name has been entered a popup will appear giving the
current status of the upload/download (e.g.):

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º XMODEM DOWNLOAD º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º Filename: FILE.EXE º
º Mode: CRC º
º Block: 10 º
º Bytes: 10240 º
º El. Time: 00:01:00 º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º Status º
º Received Block º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
LogiCOMM 17



When the transfer is complete LogiCOMM will notify you
with either a popup and/or an alarm signal depending upon
how you configure LogiCOMM initially (see Configuring
LogiCOMM). If, for any reason, you want to abort the file
transfer before it is complete, press the ESC key. The file
transfer will abort at the end of the transfer of the
current block.

4.2 Transfer Protocols

LogiCOMM supports the most commonly used file transfer
protocols. Because of some confusion in the nomenclature of
common protocols, a brief description of each protocol
implementation is given.

4.2.1 XMODEM

XMODEM is one of the simplest public domain file
transfer protocols around. It consists of 128-byte block
transfers with checksum error checking. Over the years this
protocol has evolved to include more elaborate error
checking. This is implemented in LogiCOMM as support of CRC
error checking with automatic fallback to checksum mode. You
will be required to supply a filename to both the uploads
and downloads.

4.2.2 XMODEM 1K

XMODEM 1K is essentially the same as XMODEM, except
that 1K blocks may be transmitted instead of 128 byte
blocks. This protocol is sometimes (mistakenly) referred to
as YMODEM. LogiCOMM supports CRC error checking with
automatic fallback to checksum mode, as well as adaptive
block sizes. You will be required to supply a filename to
both the uploads and downloads.

4.2.3 YMODEM

YMODEM differs from XMODEM in that the file name, along
with some other information, is transmitted as well. YMODEM
is a batch file transfer protocol sometimes called YMODEM-
BATCH. Since the filename is sent you are required to
provide a filename on uploads only.
Since YMODEM transfers send the file name along with
the file, it is possible to download a file that already
exists on disk. In this situation, LogiCOMM will rename the
incoming file with a "$" character as the first character of
the filename, so as to try to avoid overwriting the existing
file (e.g. "FILE.DAT" becomes "$ILE.DAT").
LogiCOMM 18



4.2.4 YMODEM-G

In most file transfers, the sending side will wait for
an acknowledgement of successful receipt of a block before
proceeding. YMODEM-G differs in that the sender will
continuously transmit data without waiting for any
acknowledgement. If an error is detected, the block is not
retransmitted and the whole transfer is aborted. YMODEM-G is
suitable mainly for transfers over noise-free dedicated
lines, or between modems with error correcting circuitry
(e.g. MNP level 4 modems).

4.2.5 CIS QuickB

This protocol is for use on Compuserve, and supports
such file transfer features as multiple block sending. This
is the protocol of choice for use on compuserve, as it
reduces the network delays that are introduced by XMODEM.
You may configure CIS QUICK-B to operate automatically. This
is accomplished by setting the CIS AUTO to on in the
protocol setup section of the setup command.


4.2.6 ASCII Transfers

An ASCII download will save ALL incoming communications
port data to a disk file. This is in contrast to a log file,
which will filter escape sequences. The download will conti-
nue until the user presses ESC, a control-Z is received, or
a 30 second time-out occurs.
An ASCII upload will send an ASCII text file to the
remote system. When this protocol is selected you will be
prompted for a file name. The upload may be aborted by
pressing ESC. For more information on this protocol, see
"Protocol Setup" in Chapter 5.
LogiCOMM 19



5. CONFIGURING LOGICOMM

5.1 Setup Options

The main configuration menu is invoked by typing ALT-S
while in terminal mode. The user is presented with a number
of sub-menus that he may select:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Setup Options º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º Modem Setup º
º Connect Strings º
º Terminal Setup º
º Path/Hot Keys º
º Color Setup º
º Protocol Setup º
º Save Settings º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º[up/dn] Choose [CR] Select º
º[ESC] Exit [F1] HELP º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

Move the highlighted cursor to the desired choice and
press ENTER. The Save Settings feature allows the user to
permanently set LogiCOMM's default start-up condition.

5.2 Modem Setup

The modem setup menu is used to configure the default
modem behavior. To change an entry in the menu, move the
highlighted cursor to the desired field and press "C". You
may then enter a text string that will be sent to the modem
under appropriate conditions. To enter a control character
you must prefix the uppercase control character letter with
a carat "^". For example a control-M must be entered as ^M.
LogiCOMM 20


ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Modem Setup º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º Init string....: ATE1 S7=255 S11=55 V1 X3 S0=0 ^M º
º Dial prefix....: ATDT º
º Dial suffix....: ^M º
º Answer string..: ATS0=1^M º
º Hangup string..: +++~~~ATH^M º
º Carrier timeout: 60 º
º DTR control....: ON º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º[up/dn] Select [C]hange ESC Exit ~ Pause ^ Control code º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

5.2.1 Init String

This is the string that is sent to the modem when
LogiCOMM is first started. By default, the modem is assumed
to be Hayes compatible, and is set up with local echo ON,
verbose result codes, auto-answer disabled, and enhanced
response codes.

5.2.2 Dial Prefix/Dial Suffix

The dial prefix string is the string that is
transmitted to the modem before the phone number when
dialing. For Hayes compatible modems on pulse-dial lines
this sting is "ATDP".
The dial suffix string is the string that is sent to
the modem after the phone number. Usually, this is simply a
carriage return.

5.2.3 Answer String

The answer string is the string that must be sent to
the modem to put it into auto-answer mode. For a Hayes
compatible modem, this string is "ATS0=n", where n is the
ring upon which the modem will answer.

5.2.4 Hangup String

The hangup string is the string that is sent to the
modem to hang up the connection when DTR control is not
being used. It is recommended that you use the DTR control
method.

5.2.5 Carrier Timeout

Carrier timeout specifies the time the dialing routine
will wait for a connect string before a time-out is
generated.
LogiCOMM 21


5.2.6 DTR Control

This setting determines whether LogiCOMM will hang up
the line by dropping the Data Terminal Ready (DTR) line, or
whether it will send the modem a hang up string. The
preferred method of operation is to use DTR control if your
modem supports it.

5.3 Connect Strings

The connect string menu defines the strings that the
modem will return to signal various return codes:

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Modem Connect Strings º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º 300 Baud connect string.: CONNECT^M º
º 1200 Baud connect string: CONNECT 1200^M º
º 2400 Baud connect string: CONNECT 2400^M º
º 9600 Baud connect string: CONNECT 9600^M º
º Modem VOICE string......: VOICE^M º
º Modem BUSY string.......: BUSY^M º
º NO CARRIER string.......: NO CARRIER^M º
º TIMEOUT string..........: TIMEOUT^M º
º NO DIAL TONE string.....: NO DIAL TONE^M º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º [up/dn] Select [C]hange ESC Exit [F1] HELPº
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

To change any of the default settings, move the cursor
to the desired selection and press "C". LogiCOMM will
examine all characters received from the modem until it
finds the first string that exactly matches a connect
string. As a consequence, it is important to make sure that
each string is unique for LogiCOMM to work correctly. As an
example, if the 300 baud string were defined without the
carriage return, then when the modem were to connect at a
higher baud rate and send, say, a "CONNECT 1200" string,
LogiCOMM would match the string to the string "CONNECT" as
the first complete match.
If your modem returns MNP extended codes, then the
default connect strings will not work. You will have to
either disable extended result codes, or edit the connect
strings. Removing the trailing carriage return on all but
the 300 Baud connect string is usually sufficient. Thus if
you enter CONNECT 1200 as the 1200 Baud connect string
entry, your modem will give the right connect message
regardless of whether you are using MNP or not. Do not use
the string CONNECT 1200/ARQ since this is then only work
when you connect to another MNP modem.
LogiCOMM 22


5.4 Terminal Setup

To change the default terminal mode, the entries in the
terminal settings may be modified. Move the highlighted
cursor to the desired entry and press "C".

ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Terminal Settings º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º Terminal Emulation: Ansi BBS º
º Duplex............: Full º
º XON/XOFF..........: On º
º LF after CR.......: Off º
º Download Priority.: Normal º
º Alarm Time........: 03 º
º Popups............: popup and alarm º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º [up/dn] Select [C]hange ESC Exit [F1]HELP º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ


5.4.1 Terminal Emulation

Currently, LogiCOMM only emulates an ANSI BBS. This
method is used on the majority of systems and is rapidly
becoming a standard. It supports full color displays and
enhanced cursor positioning functions.

5.4.2 Duplex

This entry controls whether the default terminal mode
is in FULL or HALF Duplex. In Half Duplex mode, characters
typed at the keyboard are echoed to the screen. In FULL
duplex mode, no echoing is done.

5.4.3 XON/XOFF

This entry determines whether LogiCOMM performs
automatic XON/XOFF processing or not. When on, LogiCOMM will
react to a received XOFF by stopping transmission of all
data until an XON character is received. Also, if LogiCOMM's
input buffer is nearly full, LogiCOMM will transmit an XOFF
character to the host, and a subsequent XON character when
it is ready to resume receiving.
Unless a specific need for this feature exists, it is
recommended that XON/XOFF processing be left off. This is
because it is possible to "hang" the communications line if
random noise is interpreted as a spurious XOFF.
LogiCOMM 23



5.4.4 LF after CR

This setting determines whether LogiCOMM will, by
default, add a linefeed when it receives a carriage return.
This option is used when connected to a host system that
does not transmit linefeed characters.

5.4.5 Download priority

OS/2 supports the concept of different levels of
priorities for different functions. LogiCOMM allows the user
to give the communications port either normal or high
priority when performing file transfers. This setting should
be left at "Normal" unless the user sees that background
file transfers slow down significantly.
It is also possible to affect background communications
throughput by changing the "PRIORITY=DYNAMIC" field of
CONFIG.SYS to "PRIORITY=ABSOLUTE".

5.4.6 Alarm Time

This field allows the user to specify the number of
seconds an alarm will sound whenever LogiCOMM completes a
file transfer, or manages to connect to a host system.
Setting this value to 0 will turn off the alarm. The maximum
alarm time is 99 seconds.

5.4.7 Popups

LogiCOMM will signal the user whenever a file transfer
is completed, or when a successful connection is made. This
field determines the method that LogiCOMM uses to notify the
user.
If set to "Alarm only", LogiCOMM will sound an alarm
for a user specified period. Setting the Alarm Time to 0,
and Popups to "Alarm only" will result in no notification by
LogiCOMM at all.
If set to "Alarm and popup" LogiCOMM will pop a message
box onto the screen notifying the user that a file transfer
is complete, or that a connection is made. It will then
sound the alarm. The message that pops up will appear in the
current screen group, so that the user will see this message
even if LogiCOMM is executing in the background. This option
should not be used under the Presentation Manager since
current versions (beta) seem to have problems with this
function.
LogiCOMM 24



5.5 Path/Hot Keys


The Path/Hot Key menu allows the assignment of the
default download directory and the programs assigned to the
user Hot Keys.

5.5.1 Default Download Directory


The default download directory is the directory that
will be used for all protocol based downloads. If this field
is left blank, the default directory will be the logged in
directory. Note that CIS-B uploads are also from this
directory unless otherwise specified by you in response to
the CIS host question "Filename for you computer?".



ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Path/Hot Key Setup º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º Default Download Directory º
º Path: D:\LOGICOMM\DOWNLOAD º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º User Hot Key 1 (ALT-J) º
º Path: º
º Parms: º
º Mode: Foreground º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º User Hot Key 2 (ALT-K) º
º Path: º
º Parms: º
º Mode: Background º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º User Hot Key 3 (ALT-U) º
º Path: º
º Parms: º
º Mode: Background º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º [up/dn]Select [C]hange [ESC] Exit [F1] Help º
º º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ


5.5.2 User Hot Key Configuration

LogiCOMM provides a user Hot Key facility which can be
used to start another program in a foreground or background
session. There are three hot-keys accessed by the keystrokes
ALT-J, ALT-K, and ALT-U. Initially these keys are not
LogiCOMM 25


assigned to any function and must be configured in the user
hot-key setup menu.
There are three fields that will need to be filled. A
given field is selected with the cursor keys and C is
pressed to edit the field.
The first is the Path field. This field must contain
the complete path including drive specs and the full
filename of the program to be executed. For example, if you
had a utility called ARC.EXE on drive C: in the UTILS
directory, you would enter "c:\utils\arc.exe" in this field.
Note that this program will be executed as a stand alone
process in its own session and upon termination will close
this session completely. Thus if the program prints
something on the screen and then immediately terminates, you
will most likely not see anything as the session will
finish.
The next field allows passing of parameters to a
program selected with a hot key. There are three ways to use
this field. The first is to leave it blank. In this case the
running program will not pass any parameters to the program.
The second is to enter a string used by the program. In the
above example, entering *.arc will result in the string
*.arc being passed to the ARC.EXE program specified in the
PATH field. The last method is used if you wish a runtime
prompt from LogiCOMM for the parameters to pass to the
program. When this method is selected LogiCOMM will prompt
you for the parameters. To select this method place a
reverse quote ` in the parms field for the particular hot
key in question.
The final field is the Fore/Background field. This
field defines whether the program runs in the foreground or
background. If the session is to run in the foreground,
LogiCOMM is moved to the background. If it is to run in the
background LogiCOMM presents a message and then continues to
run. Note if there are any errors in any parameters,
LogiCOMM will inform you of these and not execute your
program.




5.6 Color Setup

LogiCOMM allows the user to set up the default colors
that appear on screen. The user can change the colors of any
screen by moving the cursor to the field to be changed and
pressing a "C". The new color desired can then be entered as
a single hexadecimal digit (0-9,A-F).
LogiCOMM 26


ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Color Setup º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º FG BG HL Example º
º Terminal screen: 0F 00 0F ÉÍÍÍÍÍÍÍÍÍÍÍÍ» º
º Dialing menu...: 0F 00 0F º Normal Textº º
º Macro menu.....: 0F 00 0F º High Light º º
º Help screen....: 0F 00 0F ÈÍÍÍÍÍÍÍÍÍÍÍͼ º
º Pop-ups........: 0F 00 0F º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º 0 1 2 3 4 5 6 7 8 9 A B C D E F º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º [up/dn] Select [C]hange ESC Exit º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

Please note that the screen is not cleared to the new
terminal colors upon completion of the setup facility. This
may be done by pressing ALT-C to clear the screen.



5.7 Protocol Setup


The protocol setup section is concerned with the
configuration of two protocols, the ASCII upload and the CIS
QUICK-B.



ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Protocol Setup º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º ASCII UPLOADS LF after CR...........: Ignore º
º Character pacing......: 00 º
º Carriage return pacing: 00 º
º Turn around character.: 00 º
º View Output...........: ON º
º º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º º
º CIS QUICK B Auto Transfers........: ON º
º º
ÇÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄĶ
º [up/dn] Select [C]hange [ESC] Exit [F1] Helpº
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
LogiCOMM 27



5.7.1 ASCII Uploads

There are several options that may be changed in the
ASCII setup menu. The first option is concerned with
translation of linefeeds that follow carriage returns. In
general you will leave this field at "Ignore" since the
output of most word processors is a CR followed by a LF.
This seems to be compatible with many online systems.
However, some systems will have problems with linefeeds so
you may elect to strip these from the output. Alternately,
if your wordprocessor does not add linefeeds you may elect
to add them to the output. These modes are selected as a
toggle by pressing the C key.
There are two other options that may prove to be useful
with some host computers. Many of these systems receive
their input into a small buffer which is designed primarily
for obtaining input at a rate no faster than that of a
typist. When an ASCII upload is performed, the characters
are output much quicker than this and thus may overload
these buffers. LogiCOMM provides two options to deal with
this. The first is character pacing which is the time
interval between characters in milliseconds. The second is
the carriage return pacing in tenths of seconds. You may
wish to try 10 and 10 respectively if you are having
troubles.
Finally you may specify a "turn around character". This
is a character that is sent from the Host system when it
wishes another line of text to be sent. Many times it is a
colon ":". Setting this field to the decimal value of the
ASCII character will instruct LogiCOMM to wait until this
character is received before outputting another line of text
to the host. If this field contains 0 then LogiCOMM will not
wait for the turn around character. For your convenience, a
table of ASCII values may be obtained easily by pressing F1
while in this menu.


5.7.2 CIS QUICK B

This selection toggles the automatic CIS QUICK B
detection mode. When Compuserve wishes to start a upload or
download it transmits an ENQ character to LogiCOMM. If Auto
CIS transfers are on, and an ENQ is received, LogiCOMM will
automatically attempt to enter CIS QUICK B mode. This has
one consequence in the case of line noise. If you receive a
spurious ENQ character upon hangup or from a line hit you
may see the message

"Waiting for Host. Press ESC to abort."

If the ENQ came from line noise you will thus have to
press ESC to end the wait for the HOST system.
LogiCOMM 28








6. Appendix A - Common Problems


Problem: Characters appear garbled.

Example: šs×ØñõØ+dd,

Solution: Check your Baud rate, parity, number of stop
bits and number of data bits. In general you would use
NO parity, 8 data and 1 stop OR Even parity, 7 data,
1 stop.



Problem: ALT Keys work but modem no longer responds.

Solution: Check that you have not issued a control S.
Do this by typing control Q. If this doesn't clear the
problem you should check that XON/XOFF is disabled in
the terminal setup menu.



Problem: LogiCOMM will not access the serial port.

Solution: Be sure that COM01.SYS or COM02.SYS are
installed in your config.sys file and that you have
at least one port free for use.



Problem: Protection error occurs at end of download
or dial connection when running in a PM window.

Solution: Current beta releases of PM do not work
reliably with VIOPOPUPS which are used by LogiCOMM
to signal completion of downloads. You should disable
these in the terminal setup section by setting the
popups field to "Alarm only".



Problem: LogiCOMM doesn't work in IBM OS2 EE.

Solution: Be sure COM01.SYS or COM02.SYS are installed
and that you are not using ASYNCDD.SYS.
LogiCOMM 29



Problem: LogiCOMM always returns "NO CARRIER" when it
dials.

Solution: Be sure that your strings are correct in the
"Connect string" section of the setup command.



Problem: None of the above?

Solution: Please feel free to contact technical support
at Logistique LMM. We will do our utmost to help all
registered users.



Problem: LgoiCOMM looses characters at 19200 Baud.

Solution: Switch to a lower Baud rate or set the
priority of download to high.



Problem: Garbled dialing directory

Solution: The dialing directory is incompatible with
the new LogiCOMM format. Delete the file and re-enter
your numbers.
LogiCOMM 30



7. Appendix B - Product Support

If any problems should come up that are not covered in
the manuals, registered users may receive help from
Logistique LMM's Technical Support Division. When sending in
a report of a problem, please make sure to include the
following information:

Computer make:_____________________________________________

Computer peripherals:______________________________________

_________________________________________________

Operating System:__________________________________________

Contents of CONFIG.SYS:____________________________________

Nature of problem:_________________________________________

_________________________________________________

_________________________________________________

_________________________________________________

_________________________________________________


Is problem reproducible?:__________________________________

Other programs running:___________________________________


Registered LogiCOMM users who have problems with
LogiCOMM can receive technical support on Logistique LMM's
BBS at (514)-374-9422. Alternatively, they may leave E-MAIL
concerning the problem to E. Zuck on CompuServe (user ID:
73020,2073), or to E. Zuck on BIX(user id: ezsoft). Requests
for assistance on BIX and CompuServe will not normally be
answered more than once a week, so for faster response,
contact the Support BBS.

Alternatively, you may write to Logistique LMM at the
following address:

Logistique LMM
ATTN: Technical Support
6577 First Avenue
Montreal, Quebec
Canada, H1Y 3B2

Finally, registered users may phone the following
number:
(514) 727-1368 (Voice) 9:00AM - 5:00PM EST
LogiCOMM 31


8. Appendix C - Acknowledgements


Logistique LMM would like to thank all the users who
made many suggestions and comments on version 1.0. Many of
the enhancements seen in version 2.20S were the direct result
of user comments. In particular we would like to thank Mr.
Doug Hogarth of Microsoft corporation who in his spare time
has helped immensely with LogiCOMM. We would also like to
acknowledge the Compuserve information system who developed
the CIS QUICK-B Protocol.