OS/2 Shareware BBS: 3 Comm

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / LOG230.ZIP / LOGICOMM.DOC next >

Wrap

Text File | 1990-01-11 | 96KB | 1,868 lines

▓ ▓▓▓▓▓ ▓▓▓▓ ▓ ▓▓▓▓▓ ▓▓▓▓▓ ▓▓ ▓▓ ▓▓ ▓▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓▓ ▓ ▓ ▓▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓▓▓▓▓ ▓▓▓▓▓ ▓▓▓▓ ▓ ▓▓▓▓▓ ▓▓▓▓▓ ▓ ▓ ▓ ▓ .....═══▒═══...........═══▒═══..........═══▒═══ .....═══▒═══...........═══▒═══..........═══▒═══\ ╔════╗ ▒ ▒ ▒ \ ║ ║ ▒ ▒ ▒ \╚════╝ ▒ ▒ ▒ ┌─────┬──┐ ▒ ▒ ▒ │ ├──┤ ▒ ▒ ▒ └─────┴──┘ 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.