QCOM.EXE Revision 3.18 Sep 1994 ------------------------------------------ Copyright 1990-1994 by RTFM Software and Richard W. Turenne Winnipeg, Mb. All Rights Reserved All users are granted a limited license to try QCom for thirty day evaluation period to determine its' suitability. QCom is USER SUPPORTED. It is not Public Domain and is not free. This means, if you decide to use this program, please show your support by registering it with the author. To add INCENTIVE, those who register will be shown how to utilize the user defineable functions. Users can pre-define other external dos functions, or other external protocols, or batch files, and access them with a single keystroke. Additionally, they will be able to eliminate the "nag" screen when QCom ends. ------------------------------------------------------------------ -Page 1- SYSTEM REQUIREMENTS: Minimum of one floppy drive, 256K or more memory, and a modem of course. QCom Features: + Compact and VERY EASY to use. + Easy Modem Setup. + Modem finder. + Mouse support. + User Defined Main menu. + Configurable Com Port IRQ and address. + Easy Scripting. No programming experience required. + Extensive help. + Auto-Script maker. + FIFO (16550) UART support. + Transfer Protocols including Ascii, Xmodem, Xmodem1k, Ymodem, YmodemG, Zmodem and any externals. + Terminal Emulation for TTY, ANSI, ANSI-BBS, VT100. + Auto download/upload triggering for ZModem and CIS QuickB. + AutoSend, AutoHangup Timers and AutoEnd. + Dialing Directory size limited only by available conventional memory. + 500 line Scroll Back Buffer with text quoter. + File tagging for batch Uploads. + QCom Mail Processor offline mail reader. + Function key and Alt-Key Macros. -Page 2- FIRST TIME SETUP AND CONFIGURATION: Run QCom. QCom will execute the configuration utility, QComCFG. If you're familiar with your communications hardware you can edit the Com Port, modem string, etc in the Edit QCom.CFG screen. Press F1 to go to the pull-down Menus. Selecting from the various menus you can set your Com Port, Modem type and any other options you wish. To exit, select the File Menu, Save your changes, then Exit. Qcom will continue where it left off. Wait a few moments while the modem is being initialized. An error message usually means the modem has not been properly initialized. Correct modem initialization is critical to all operations that involve the modem. If the string from QCom Setup is incorrect, please advise the author so that corrections can be made. Refer to the Trouble Shooting section for solutions. Special Character codes in QCom.CFG: The "|" character will send a carriage return to the modem. The "~" is a half-second pause to allow the modem time to execute the commands in the initialization string. Some modems need more time than others. The pause is executed by QCom and the modem will not actually receive the "~" character. -Page 3- COMMANDLINE PARAMETERS: In addition to specifying a script, the user can specify an alternate configuration file and an alternate phone directory file. This allows network users to have CFG and FON files tailored to their individual needs. Switches are: /S = load and execute script file /C = load alternate configuration file /P = load alternate phone directory /B = force monochrome Usage is: QCOM [/Sfilename.SCR] [/Cfilename.CFG] [/Pfilename.FON] [/B] Users may use the options in any sequence. The switches (/S,/C,/P) must NOT have a space preceding the filename. When the commandline options are not used, QCom defaults to QCom.CFG and QCom.FON. TERMINAL EMULATION: This version has built-in support for ANSI-BBS and straight TTY. Pressing ALT-K will toggle between the two. STATUS LINE EXPLANATION: ---------------------------------------------------------------------- Alt-Z:Help SEC Host system name Online 05:55:55 Z COM1:2400N8 ---------------------------------------------------------------------- | |||| | | | | | | |||| | | | | | Commands |||| | | | | | Script on -- ||| | | | | | Echo On ----- || | | | | | Capture On --- | | | | | | Alarm Off ----- | | | | | Host name --------------- | | | | Carrier status --------------------------- | | | Time connected ----------------------------------- | | Transfer protocol -------------------------------------- | Communication port, baud, parity and databits ------------------ -Page 4- FILE TRANSFER PROTOCOLS: Transfer protocols are used as a method of flow-control and error checking when transferring files. These protocols are specified when adding to the Dialing Directory. The Dialing Directory is displayed when you press ALT-D. The use of ZModem protocol is recommended if the host computer has the option available. QCom will default to using the built-in protocol unless an external protocol is otherwise specified when editing the Dialing Directory or when doing a file transfer. ZModem options: -r receive a file. This switch must come last. -s send a file. This must be the last switch. -p Send or accept complete pathnames. -b#### Specify the CONNECT baud rate -l#### Specify a locked baud rate. -h hardware flow control (RTS/CTS). -i ignore absence of carrier detect signal. -v disable serial I/O during disk writes. -e# file exists option. -e0 -- do not download. -e1 Resume at the end of current file (default). -e2 Download the file as a separate file. -e3 Overwrite the existing file. -w#### transmit window size (must be a multiple of 128). -x Escape all control characters. -x# Escape specific control characters -6 Force use of 16 bit CRC. -y overrides received filename 16550 related switches: -d Do not enable 16550 FIFO mode. -t# characters per interrupt (range 1 to 16). -m Disable modem status register interrupts. EXTERNAL PROTOCOLS: QCom can be set up to use external protocols. In QCom Configuration select the XFer Options under the Protocols Menu. From the Pop-up list of protocols you can select and edit existing protocol options, or add a new one by selecting an unused entry marked with " ******* ". Options for the protocols supplied with QCom need not be modified. Options for the DSZ examples can be modified to suit your requirements but remember that QCom automatically sends the port number, baud rate and appropriate pathname to these choices. For other external protocols, options such as port, baud rate and pathnames will have to manually entered where required. Registered users are shown a shortcut way to pass these parameters making it unnecessary to edit them whenever a baud rate or pathname changes. Note: An unregistered copy of QCom is not "crippled". The instruct- ions for this feature of QCom are provided to all those who register. -Page 5- DIALING DIRECTORY: The Dialing Directory stores data about the online services you use. It can be as large as you like and there is no preset size restriction, however if a directory is larger than 999 records you may find the numbers on the left spilling over the border. (If this is a serious problem for you, I would like to hear about it!) If needed, you can have multiple Directory files and load a different file at startup using the "/P" commandline switch mentioned previously. Adding entries to the Directory is straightforward. When editing, use the Arrow keys, TAB key, ENTER key and mouse to select fields to edit. When editing phone numbers, you can have multiple numbers. QCom will dial each one in turn until a connection occurs. Separate each number with a semi-colon (";"). On some fields, popup lists will display your available choices. Select a choice with Arrow keys and press Enter (or double click left mouse button). The Script list allows you to press ESC so that you may enter the name of a script not found on the list. The Script list is a listing of the script files located in the Script subdirectory specified in QCom.CFG. -Page 6- VARIOUS FUNCTIONS: ALT-A: Toggles the sound functions on or off. ALT-B: Allows the user to scroll back up to 500 lines of received data. Search capabilities are provided for finding particular text and the whole buffer can be written to disk using the Save command, "S" (the filename defaults to "QComBuff.Txt") or erase the buffer with "E". "Q" is for quoting previously received text. When "Q" is pressed another menu of choices is presented and one line of text will be highlighted. This highlighted line can be moved through the buffer with the cursor keys, Home, End, PgUp, or PgDn. Lines can be tagged or untagged by pressing "T" or the SPACE bar. Once text is selected, it can be save to disk with "F" or immediately sent to the host with "S". This last feature allows you to quote lines from a message and return them to the host's editor when answering that message online. "U" will untag all tagged lines as will sending or filing. ALT-C: Communication parameters can be modified here. These changes are in effect until changed again or until QCom ends. Com Port must be set in QCOm.CFG. Port changes will not take effect unless QCom is restarted. -Page 7- VARIOUS FUNCTION CONTINUED... ALT-D: Displays the dialing directory. Use the arrow keys to select a number and ENTER to dial that number. Other keys that are PGUP, PGDN, HOME and END. HOT TIP: Pressing ALT and a letter will put the cursor on the first line beginning with that letter. Add a new entry with "A" or edit an existing one with "E". To delete an entry press "D". You can dial the phone with a manually entered number using "M". Phone entries can be tagged or untagged with the Space bar. This will cause QCom to continuously dial all tagged numbers until a connection is made. Dialing of tagged numbers will commence when the Enter key is pressed. Once a connection is made and broken you will be returned to the Dialing Directory. Continuous dialing will resume where it left off if Enter is pressed again. ALT-E: Toggles local echo on or off. This is used when the host does not echo back the characters that you enter. An "E" is displayed in the left-hand box on the status line when local echo is on. ALT-F: Toggles adding linefeeds to incoming and outgoing lines. ALT-G: Toggles output to printer on and off. Allows all incoming text to be sent to the printer. Make sure the printer is online. ALT-H: Sends the hang-up string to the modem and toggles DTR. ALT-I: Will save the current screen image to a text file as specified in the QCom.CFG file. Default filename is QCOM.SCN which can be changed by editing the QCom.CFG file (use ALT-O). ALT-J: Allows shelling out to DOS without ending QCOM. External programs can be executed while on-line. The user could make use of other external file transfer protocols here if desired. Though there is a better way. See registration section. ALT-K: Toggles between ANSI and TTY terminal emulation. ALT-L: Toggles the "capture" function. If on, all incoming text will be saved in a file named as specified in the QCom.CFG file. Default is QCOM.CAP. IF the file does not exist in the default directory, it will be created. Otherwise data is appended to an existing capture file. A "C" is displayed in the left-hand box on the status line when capture is on. ALT-M: Sends the modem initialization string to the modem. This string is automatically sent upon start-up (providing no carrier is present). -Page 8- VARIOUS FUNCTIONS Continued... ALT-N: Split-screen separates incoming and outgoing keystrokes during a "chat" session. ALT-O: Brings up the QCOM.CFG file to the screen for editing. Press F10 to save the file and to set the Communication parameters as shown in the file. Esc exits and makes no changes. If it were necessary to change baud or any other Communication parameter while online, use ALT-O to edit and F10 to set parameters. Changing the port specified here will have no effect unless QCom is restarted. ALT-P: Sends the current password from an entry of the Dialing directory when you have dialed and connected to that entry. ALT-Q: Load and execute a script. ALT-R: Re-dials the last phone number dialed when no entries are "Tagged", or if entries are "Tagged", it will continue dialing those. ALT-S: Toggles the Script Save function. See the Script section for more information on making and using scripts. ALT-T: Allows changing of the transfer protocol currently in effect. This can be done while on-line. ALT-V: Allows the use of an external editor or file viewer. The editor (or file viewer) of choice is defined in the configuration file. ALT-U: Will send a pure ascii text file to the host with no error- checking. Ascii transfer is used to send a text file to the host PC. For example, you might use it when sending a message to an electronic mail service. Instead of editing the message on-line, you can prepare your message in advance. Once on- line, go into the message editing screen on the host and then use ALT-U to upload your file. ALT-W: Wipes the screen clear. ALT-X: Ends QCOM. -Page 9- VARIOUS FUNCTIONS Continued... ALT-Y: QCom becomes the host computer. It will wait for any incoming phone calls until ESC is pressed. When a call is received, QCom will answer the phone. QCom sends the file HELLO.HOS to the caller's PC. You can edit this file to suit your own needs using an ANSI "editor" like TheDraw. After this message file is sent, the caller is shown the menu contained in the file "MENU.HOS" The caller can select one of the choices or the Host can enter selections. "Help" sends a brief help screen, HELP.HOS to the user. "Area" allows the user to change to a different subdirectory. When a caller selects the Area command, a file called AREAS.HOS is displayed on the caller's screen. This is intended to show which "areas" (subdirectories in fact) the caller can have access to. A sample AREAS.HOS file is included. Users will want to edit this file to suit their systems. "Files" allows the user to list specified files in that subdirctory. "Chat" will allow a dialogue between each PC. To end Chat and return to the menu, the Host must press ESC. "Upload" will send a file to the Host using DSZ ZModem. "Download" will send a file to the caller in a similar manner. If the caller specifies the correct path and filename, he will be able to download a file from anywhere on the Host system. "Proto" will allow the caller to select XModem, YModem or ZModem protocols when transferring files. "Goodbye" will send BYE.HOS and terminate the connection . As Host, you can also terminate the call by pressing ALT-H to hangup. QCom will then wait for the next caller. ALT-X will also terminate the call and in addition, end QCom. A local Host mode test is available: Press ENTER when waiting for incoming calls. This allows preparation and preview of your own host welcome messages or help screens. PGUP: Uploads (sends) a file to the other system. You will be prompted to enter a filename to upload. The file can be preceded by a path only if NO upload path is specified in QCOM.CFG. If the host supports batch uploads then you can take advantage of DSZ's capabilities; when prompted for a file to upload enter the name of a file containing a list of the files you wish to upload. Precede the filename with an "@" . Example: "@files.lst". Or you can use QCom to create a list file for you. When prompted for a file to upload press ENTER with any global file specification (*.* or *.zip). You will -Page 10- VARIOUS FUNCTIONS CONTINUED... be shown a box containing filenames based on that specification. From here simply use the cursor keys to select a files and Mark them with "M". When finished marking press ENTER and QCom will create "Files.LST" and pass that to DSZ for you. PGDN: Downloads (receives) a file from the host computer. If XModem or YModem are the protocols in effect, you'll be prompted to enter the filename to receive. QCom tries to guess the filename based on recently entered text and places its' guess at the prompt. If ZModem is in effect, entry of filenames is not required and in fact, pressing PGDN is not required because QCom will call DSZ automatically when it receives the Zmodem Receive string. ALT-=: Toggles "Doorway" mode. This removes the status line when in Doorway mode and gives full screen display for using remote applications. Allows you to make full use of all keys while online. All Alt-key combinations except ALT-= are sent out and their usual functions are disabled in this mode. For example, PgUp, PgDn, Home, End and the cursor key codes are transmitted. You might make use of this when using a full-screen editor while online or when using your PC as a dumb terminal on a non-DOS system such as Unix. Status line and all key functions are restored when Doorway mode is turned off. ALT-Minus: Enables/disables debugging during script execution. Status line displays the next line of text which QCom is looking for. ALT-Space: Enables the user defined Main menu when at the terminal screen. Ctrl-END Sends Break signal to host. Used for terminating some mainframe connections. F1-F10: Defineable macro keys. Use them to send text or to execute a script command. See the next section on Function Key Macros for more detail. Ctrl-F1 Displays the "Function Key Macros" as they appear in the last macro file to be loaded. If macros are "Named" then the display will show them as "buttons". Ctrl-F2 Displays the "Alt Key Macros" for registered users. -Page 11- FUNCTION KEY MACROS Macros can do two things. They can send text to the host and they can execute script commands. Since a script command can, among other things, execute any DOS command or batch file, function key macros can be as simple or as complex as you want. To aid in remembering which Function Key is assigned to which macro, Macro "Buttons" can optionally be displayed on screen. Each macro can be assigned a descriptive name which will be shown in the on-screen "button". (Once a macro file is loaded, you can toggle the macro "button" display with CTRL-F1.) (A sample macro file is included in the distribution called QCom.MAC. You may want to print it out and have it handy while reading this.) To maintain backward compatibility, we've kept the Macro Names feature optional. If there is no name associated with a macro, then it will not appear as one of the buttons on screen but it will still work. Macro File Layout: (Text within the [ ] brackets is optional) [] !Script Command [; comments] [] Text to send [; comments] In the following example, the password for the current Dialing Directory Entry will be sent to the Host when F1 is pressed, and my name when F2 is pressed. The "buttons", "Password" and "Name" will appear on screen when CTRL-F1 is pressed. It should be remembered that screen space is a restricted resource. Obviously, 10 long macro names will not fit across the screen, so keep the names short. Example: !A-P ;F1 send password with script cmd. Richard Turenne^M ;F2 Send my name to host !A-X ;F3 End QCom !A-Q Mail.SCR ;F4 Run a script to download mail Note the "!" telling QCom to execute ALT-P rather than send "!a-P". Also note no space characters can be included within the name portion of the macro. You can edit the sample Macro file to suit your requirements and make duplicate copies under other filenames to be edited for use with specific Dialing Entries. The default Macro is named in QCom.CFG. This macro file will load when QCom is started or when you dial an entry without a specified macro file. Each macro file can have ten lines. The lines relate directly to the function key it is assigned to. That is, line one will be assigned to F1, line 2 to F2 and so on to line 10 assigned to F10. If you wish to leave unassigned Function keys, then leave the line blank. Control codes can be sent with the use of the "^" character. Example: "^[" = an escape character "^M" = a carriage return "|" = a carriage return -Page 12- SCRIPTS: Scripts are used for automating repetitive tasks such as dialing, logging in to an online service, and transferring files or electronic mail. A script is generally made up of a series of commands for QCom to execute at the appropriate time. The script can tell QCom to send text to the host or it can make QCom execute one of its' internal functions. MAKING A SCRIPT: QCom has a built-in Script-save feature to simplify the creation of scripts. To create a typical login script you would do the following: 1. From the Dialing Directory dial the number. 2. When the host answers and immediately after the Dialing box clears, press Alt-S to start the script saver. It will prompt you to enter the name of your script. If, for example, you're calling CompuServe, you could name it CIS.SCR. 3. QCom will save each line of incoming text which prompts you for input. For example the host may prompt you... ENTER YOUR FULL NAME : To which you respond by typing in your name and pressing ENTER when the name is complete. Always type entries in, don't use Function key macros when saving a script. If/when prompted to press "ANY" key always press ENTER. QCom will store the host's prompt, and the text you have entered in the script. (Also Note: BBS software that has "HotKey" menu choices where the user is not required to press ENTER after selecting a letter is great BUT... when it comes to saving a script QCom will NOT save the line unless you press ENTER. So when saving a script turn off the Hotkey feature at the BBS end.) 4. QCom will also store any commands you give it such as ALT-L to turn on the capture function. 5. When you wish to stop saving a script press Alt-S again. 6. To have this new script execute when you call this number again, add the name of your script into that entry in the Dialing Directory. The next time you dial that number the script will be loaded and executed. Sample script : put a message on screen ;ECHO ^M This is the start of my script! ^M let's capture the session to file.txt ;a-L file.txt Do you want graphics (Enter)=no;^M What is your full name?;John Doe^M sends password from the Directory entry we just dialed Password (Dots will echo)?;a-P Scan Message Base Since 'Last Read' (Enter)=yes;^M Press (Enter) to continue;^M -Page 13- MAKING A SCRIPT Continued... receiving (downloading) a file min. left) Main Board Command?;d^M Filename to Download (Enter)=none?;file.arc^M downloads "file.arc" ;D/L file.arc Press (Enter) to continue;^M goodbye min. left) Main Board Command?;g^M give hangup command ;a-H Y execute another script ;a-Q MyBBS.SCR The following is an example of a script that connects to CompuServe through the DataPac network. ;ECHO Logging in to CompuServe. Please wait... send "..." when connected ;...^M send node id number when the word DATAPAC is received DATAPAC;P 12345678^M CompuServe Information Service Host Name:;CIS^M insert your user ID User ID:;12345,6789^M send password from dialing directory Password:;a-P check for mail or whatever Enter choice!;5^M etc, etc. See the included file QCOM.SCR for more examples on scripting. Note: When saving a script, QCom saves every line of incoming text on which the user is prompted for input AND which is terminated with a carriage return ( by pressing the ENTER key). Any line that prompts the user and does not require the ENTER key to be pressed, will NOT be saved in the script. Such lines would have to be manually typed into the script with a text editor. -Page 14- MAKING A SCRIPT Continued... In order to use a script automatically, put the name of the script file in the SCRIPT column in the Dialing Directory. One way to create a new script is to capture a session and then edit it to conform to the above format, using the semicolons to separate incoming and outgoing text. Any unnecessary text can be deleted from the capture file (such as news bulletins, etc.). Rename the file using ".SCR" as the extension in your script filename. COMMANDLINE SCRIPTS: Commandline scripts allow you to start Qcom, dial a number, transfer files, hangup and end Qcom automatically. To create such a COMMANDLINE script, run Qcom, press ALT-S before going into the Dialing Directory . Enter the name of your script, and proceed to step the program through the whole dialing and connection procedure. Qcom will save your commands as well as the text coming in and going out. To execute this script from the commandline use: "QCom /SMyScript.scr" The "/S" tells QCom that the following is the name of a script to execute. You must use the full script filename. When a script is executing you will see an upper case "S" on the Status line. To stop script execution at any time, press ALT©S. Note: When your script dials a directory entry that has another script specified, the second script will be ignored. You can, however, call another script by using the ALT-Q command. (eg. ";a-Q ANOTHER.SCR"). SCRIPT COMMANDS: Most Script commands consist of shorthand for the keystrokes you would use when manually running QCom. The ALT-Key commands that QCom understands can be entered into a script with ";a-" followed by the letter you wish to use. Eg. ALT-P would be ";a-p". Upper or lower case will work. Exceptions: ALT-- (ALT-Minus) and ALT-= cannot be saved or executed in a script. -Page 15- SCRIPT COMMANDS CONTINUED... The following are script commands that may be manually added to scripts. These are NOT included in Saved scripts. "ANY" - used to send a given response to text that is received repeatedly. eg. ;ANY Press any key;^M Whenever "Press any key" is received, a carriage return will be sent. This will remain in effect until the ANY command is used again in the script to specify new incoming text. eg. ANY This effectively "turns off" a previous ANY command. QCom will no longer respond to the previously specified incoming text. "DEBUG ON" -used in script debugging The Status line shows which line of incoming text the script is waiting for. This allows you to compare a script line to actual received text to check for spelling errors or typos in cases where a script is not working properly. Pressing ALT-V during a debug session will load your script into your editor so you can make corrections on the fly. "DEBUG OFF" -disables the debug function. "ECHO" -prints text on the local screen. eg. ";ECHO Please wait. Auto Logon in progress..." Text can be colorized and positioned on screen using ANSI escape codes. "LOG" - will save date, hostname, start time and duration of calls in optional specified filename. If no log file is specified, QCom defaults to "USAGE.LOG". eg. ";LOG CIS.LOG" could store a log of calls to CompuServe. Also provided is a utility to total the durations of calls, named QTT.EXE. Usage: QTT LogFile. "WAIT" - will pause the execution of a script for a specified number of seconds. Eg. ";WAIT 5" will pause everything for five seconds. Do not pause for too long if you expect to have incoming data during this time. Hitting any key will terminate a pause and continue the script. "DOS" Allows you to shell to Dos and execute batch files or whatever. Use the /WAIT switch after the commandline if you wish to pause the display before returning to QCom. eg: ;DOS vampire.bat /WAIT -Page 16- SCRIPT COMMANDS CONTINUED... "ASK" Used to get user input from the keyboard. This will display your "User Prompt" in a box and wait for user input. When the user presses Enter, QCom will compare the user's input to the text in "Answer". If it is the same then the script will go to the "Label". Otherwise the script will continue with the next line. Use commas to separate the prompt, answer and label. Usage: ;ASK User Prompt ,Answer,Label eg: ;ASK Download your mail? (Y/N) ,Y,DownLoad Mail ;GOTO No Download :DownLoad Mail ;... "GOTO" To branch to another part of the script. eg: ;GOTO Label 1 or... When this text is received;GOTO Label 2 "CALL" To go to another part of the script and execute until the RET (Return) command is encountered. It returns to the line following the Call. Calls can be nested 255 levels. eg: When this text is received;CALL Label 3 or... ;Call Label 3 ;END :Label 3 Look for this text;send something^M ;RET "RET" As above, used to return from a CALL. A RET must not be executed unless a CALL has been executed first. RET cannot be used with GOTO. Usage: ;RET "T/O" Timeout for incoming text. A given timeout value will apply to any script line waiting for incoming text which follows the T/O command. To enable timeout use: ;T/O Seconds To disable timeout use: ;T/O 0 Example: ;T/O 10 Wait for text for 10 seconds;Send if received before 10 secs Otherwise wait for this for 10 seconds;...etc. Disable timeout: ;T/O 0 -Page 17- SCRIPT COMMANDS CONTINUED... "ENQ" Have QCom do something upon receiving an ENQ character (^E). A typical use would be when transferring a file on Compuserve using the QuickB protocol. The following example shows how to have QCom shell out to OZBext (an external QuickB protocol) to transfer a file on Com port 2 when the ENQ character is received. Eg: ENQ;DOS OZBext /c2 /x Registered users may use port and file abbreviations, etc., where appropriate, as per their instruction sheet. After QCom receives this ENQ it stops looking for further ENQ's. "END" Used to stop script execution. eg: ;END or... When this text is received;END "TAG" Used for tagging or marking Dialing Directory entries for dialing. eg: ;TAG PCUG QCom will tag or mark all Dialing Directory entries starting with "PCUG". To tag only one of several entries with similar names it is necessary to have something unique in the name you wish to tag. eg: ";TAG PCUG Node 1" Note : When entries have been tagged with the above TAG command, use the DIAL command without a specified name. eg: ;TAG PCUG ;DIAL This will cause QCom to dial all tagged entries until a connection is made. "UNTAG" QCom will untag all marked Dialing entries. eg: ;UNTAG The following are script commands that may be manually added to scripts. These ARE included in Saved scripts. "DIAL" -dials the entry specified. Eg. ";DIAL CompuServe" "U/L" -uploads the specified file Eg. ";U/L Myfile.Zip" "D/L" -downloads the specified file Eg. ";D/L Myfile.Zip" "BREAK" -sends a BREAK signal to the host Eg. ";BREAK" -Page 18- Labels: Like labels in batch files, a label is preceded by a colon and can consist of one or more words or numbers. No semi colon is used as in other script lines. eg: :Label 1 :Label 2 SEMICOLONS: In a QCom script, the semicolon is all important. It divides each line into incoming and outgoing text. Lines beginning with a semi- colon are commands that QCom will execute (such as an ALT-Key command). Also note that only the first semicolon is used as a divider. Subsequent semicolons are treated as regular text. Any line of text in a script with no semicolon or colon is ignored by QCom and can be used as a comment line for clarification when viewing or editing the script. Script execution takes place only in the terminal screen. If your script executes something like ALT-B (ScrollBack) or ALT-Z (Help), manual input will be necessary to return to the terminal screen to continue script execution. FINAL NOTE ON SCRIPTS: When saving a script, incoming phone noise may be saved during a session and will have to be edited out before using the script. It's wise to double-check a newly created script for any unwanted characters. Any pure text editor can be used to edit or create a script file. -Page 19- SETTING NON-STANDARD COM PORTS: To setup QCom to recognize non©standard Com ports press ALT-O to edit the QCOM.CFG file. On the first line, after the com port number add /I=n /A=a (where n = the desired IRQ number and a = the desired port address in decimal). Example: 4 /I=3 /A=744 ; com port TROUBLE SHOOTING: Symptom: Modem returns "ERROR" when initializing. This simply means that one or more commands in the modem initialzation string is not understood by the modem. The modem initialzation string is stored in QCom's configuration file call QCom.CFG. You can view and edit this string if you wish. Press ALT-O to enter the Options screen where you will find the modem Init string. Refer to your modem instruction manual to compare the modem commands against those contained in the initialization string and delete those that your modem doesn't understand. Save and exit with F10. To test the string press ALT-M to reinitialize the modem. Symptom: "Cannot initialize Com Port x" error message. (x = 1 to 4) Meaning of error message: Qcom cannot find the Com Port that is specified in the configuration file (QCom.CFG). Possible causes: 1. Error in configuration file. The number specified there does not match the Com Port used by the modem. 2. Hardware problem. Two or more devices are configured for the same Com port or the Com port specified is not installed. Check that there is no conflict in hardware interrupt settings. If two serial devices attempt to use the same Interrupt (IRQ) setting chances are, neither will work. Typical settings would be: Com1 using IRQ 4, at I/O 3F8h Com2 using IRQ 3, at I/O 2F8h Com3 using IRQ 4, at I/O 3E8h Com4 using IRQ 3, at I/O 2E8h 3. Software conflict. A memory resident program that ties up the Com port has been previously executed and has not been deinstalled. Carbon Copy is an example of such a program. Symptom: Modem does not dial out. Modem does not receive some/all commands sent by QCom. Possible causes: 1. Baud rate specified in the configuration file is too high for the modem. Set the default baud rate to your modem's fastest speed. Modem will send back an "OK" when you initialize the modem (Alt-M) if all is well. - Page 20 - TROUBLE SHOOTING Continued... 2. External modem is not powered up or not connected properly. 3. Possible hardware conflicts with another installed serial device. Internal modem has been improperly installed or configured. 4. Modem initialization or dialing prefix strings are incorrect. Refer to the Modem instruction manual for the correct strings for your modem. 5. Modem is incorrectly configured. Refer to modem manual and set modem dip switches or NVRam for the following: a) Modem must track the actual state of DCD (Carrier) and not be forced. b) Modem should track DTR and not be forced. c) Modem MUST send back verbal result codes such as "OK" or "CONNECT", etc. 6. See the following Symptom: QCom status line says "Online" even when not. Cause: Modem Carrier Detect line is forced on. This MUST toggle on or off depending on the actual Carrier state. This is set with a modem dip switch or a command sent in the initialization string. Refer to the modem manual. Edit the initialization string if necessary and use Alt-M to manually send the string to the modem. Or toggle the Carrier detect dip-switch if present. Many modem factories typically set this to default to always on. One result of this is QCom will prompt you whether you want to initialize the modem at start-up which is an unnecessary annoyance (the prompt is necessary in the instance where QCom is used as a dumb terminal attached directly to another machine). Symptom: Pressing Alt-M to re-initialize the modem gets back "ERROR" from the modem. Cause: The modem initialization string (line six in the QCom.CFG file) contains command(s) that the modem does not understand. Or, the command string is too lengthy. Refer to the modem manual and remove any command not found in the manual. Long initialization strings can be broken up into two sections with "^M~~~AT" inserted about halfway. Symptom: QCom reports "Unable to find DSZ.COM or DSZ.EXE" Cause: DSZ.COM or DSZ.EXE are not found in the default directory (the same directory as QCom) or in the search path. Put DSZ into correct directory. - Page 21 - TROUBLE SHOOTING Continued... Symptom:Always get a fast busy signal after dialing. Cause: a) Call waiting string in Options is enabled when the feature is not present on the phone line. Disable the string by erasing it or prefix it with a semicolon. b) A pause character may need to be added after the string. Most modems recognize a comma as a half second pause. eg:"*70,," ONLINE SUPPORT BBS: To obtain further help, or for the latest update of Qcom, you can call the support BBS: ************************************************ * Programmer's Oasis, Ph. 1-204-478-3562. * ************************************************ When calling in, login as a new user with your full name and password of your choice. After answering a few questions you will be given the opportunity to go into the QCom area. Once there you will have 30 minutes to send or receive messages and download files. Direct all QCom related messages to the author, Richard Turenne. DISCLAIMER: This software is provided "as is" without warranty either express or implied. The user assumes all responsibility in determining its' usefulness and or fitness for any purpose, and assumes all risks and liabilities including damages for loss of business profits, business interruption, or loss of business information arising from the operation of this software. -Page 22- ************************************************** QCOM REGISTRATION If you use QCom, please register it. This software is the result of MUCH time and effort. Its' continued development depends entirely on users like yourself showing their support. WHY REGISTER ? Those who register will be shown how to set up and use the user defineable ALT-Key functions. Users can pre-define other external protocols, or DOS commands, and access them with a single keystroke. These instructions are essential to make the most of QCom. Additionally, you will be able to disable the nag screens and eliminate the start-up and end delays. The one-time-only registration fee is $20.00. All upgrades thereafter are no charge! To receive a copy of the absolute latest version on disk, send an additional $5.00 to cover cost of disk, packaging and mailing. Specify disk size desired and your current version. A quick mailer is provided in the file called Register. Send a check or money order to: RTFM Software 108 Egesz St. Winnipeg, Mb. Canada R2R 2E1 Your comments, questions, suggestions and bug reports are always welcome whether or not you register. Drop me a note, leave a message on CompuServe I.D. 72361,3117. Or, leave a message on Programmer's Oasis BBS, Ph. 1-204-478-3562. ************************************************** -Page 23-