home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / comms / qcom310.arj / QCOM.DOC < prev    next >
Text File  |  1994-02-20  |  46KB  |  1,021 lines
  1.                                     
  2.    
  3.    
  4.    
  5.    
  6.    
  7.        QCOM.EXE   
  8.        Revision 3.10
  9.        Feb 1994
  10.    
  11.    
  12.        ------------------------------------------   
  13.    
  14.    
  15.    
  16.        Copyright 1990-1994 by RTFM Software and Richard W. Turenne
  17.        Winnipeg, Mb.  All Rights Reserved   
  18.    
  19.    
  20.    
  21.        All users are granted a limited license to try QCom for thirty  
  22.        day evaluation period to determine its' suitability.   
  23.    
  24.    
  25.        QCom is USER SUPPORTED.  It is not Public Domain and is not free.   
  26.        This means, if you decide to use this program, please show your   
  27.        support by registering it with the author.   
  28.    
  29.    
  30.        To add INCENTIVE, those who register will be shown how to utilize   
  31.        the user defineable functions.  Users can pre-define other   
  32.        external dos functions, or other external protocols, or batch files,  
  33.        and access them with a single keystroke.  Additionally, they will be  
  34.        able to eliminate the "nag" screen when QCom ends.   
  35.    
  36.    
  37.    
  38.    
  39.    
  40.        ------------------------------------------------------------------   
  41.    
  42.    
  43.    
  44.    
  45.    
  46.    
  47.    
  48.    
  49.    
  50.    
  51.    
  52.                                   -Page 1-    
  53.    
  54.   SYSTEM REQUIREMENTS:   
  55.    
  56.      Minimum of one floppy drive, 256K or more memory, and a modem of   
  57.      course.   
  58.    
  59.    
  60.   QCom Features:   
  61.    
  62.      + Compact and VERY EASY to use.
  63.      + Easy Modem Setup.
  64.      + Modem finder.
  65.      + Mouse support.
  66.      + User Defined Main menu.
  67.      + Configurable Com Port IRQ and address.
  68.      + Easy Scripting. No programming experience required.
  69.      + Extensive help.
  70.      + Auto-Script maker.
  71.      + FIFO (16550) UART support.
  72.      + Transfer Protocols including Ascii, Xmodem, Xmodem1k, Ymodem,
  73.        YmodemG, Zmodem and any externals.
  74.      + Terminal Emulation for TTY, ANSI, ANSI-BBS, VT100.
  75.      + Auto download/upload triggering for ZModem and CIS QuickB.
  76.      + AutoSend, AutoHangup Timers and AutoEnd.
  77.      + Dialing Directory size limited only by available conventional memory.
  78.      + 500 line Scroll Back Buffer with text quoter.
  79.      + File tagging for batch Uploads.
  80.      + QCom Mail Processor offline mail reader.
  81.      + Function key and Alt-Key Macros.
  82.    
  83.    
  84.    
  85.    
  86.    
  87.    
  88.    
  89.                                   -Page 2-    
  90.   FIRST TIME SETUP AND CONFIGURATION:   
  91.    
  92.     Run QCom.  QCom will execute the configuration utility, QComCFG.
  93.     If you're familiar with your communications hardware you can edit
  94.     the Com Port, modem string, etc in the Edit QCom.CFG screen.
  95.     
  96.     Press F1 to go to the pull-down Menus.
  97.     Selecting from the various menus you can set your Com Port, Modem type
  98.     and any other options you wish. To exit, select the File Menu,
  99.     Save your changes, then Exit. Qcom will continue where it left off.
  100.     
  101.     Wait a few moments while the modem is being initialized.   
  102.     An error message usually means the modem has not been properly   
  103.     initialized.  Correct modem initialization is critical to all   
  104.     operations that involve the modem.  If the string from QCom Setup   
  105.     is incorrect, please advise the author so that corrections can be   
  106.     made.  Refer to the Trouble Shooting section for solutions.
  107.  
  108.     Special Character codes in QCom.CFG:   
  109.     The "|" character will send a carriage return to the modem.  The   
  110.     "~" is a half-second pause to allow the modem time to execute the   
  111.     commands in the initialization string.  Some modems need more time   
  112.     than others.  The pause is executed by QCom and the modem will not   
  113.     actually receive the "~" character.   
  114.     Function key definitions are shown in the last ten lines.  You can   
  115.     configure your own "macros" here.  Control codes can be sent with   
  116.     the use of the "^" character.   
  117.     Example:           ^[ = an escape character   
  118.                        ^M = a carriage return   
  119.     Refer to any good ASCII chart for others.   
  120.                                   -Page 3-    
  121.   COMMANDLINE PARAMETERS:   
  122.    
  123.     In addition to specifying a script,  the user can specify an   
  124.     alternate configuration file and an alternate phone directory file.   
  125.     This allows network users to have CFG and FON files tailored to   
  126.     their individual needs.   
  127.    
  128.     Switches are:   
  129.            /S = load and execute script file   
  130.            /C = load alternate configuration file   
  131.            /P = load alternate phone directory   
  132.            /B = force monochrome  
  133.     Usage is: QCOM [/Sfilename.SCR] [/Cfilename.CFG] [/Pfilename.FON] [/B]  
  134.    
  135.     Users may use the options in any sequence.  The switches (/S,/C,/P)   
  136.     must NOT have a space preceding the filename.  When the commandline   
  137.     options are not used, QCom defaults to QCom.CFG and QCom.FON.   
  138.    
  139.   TERMINAL EMULATION:   
  140.    
  141.     This version has built-in support for ANSI-BBS and straight TTY.   
  142.     Pressing ALT-K will toggle between the two.   
  143.    
  144.   STATUS LINE EXPLANATION:   
  145.    
  146.     ----------------------------------------------------------------------   
  147.     Alt-Z:Help SEC  Host system name     Online 05:55:55 Z COM1:2400N8   
  148.     ----------------------------------------------------------------------   
  149.         |       ||||         |                |       |     |       |   
  150.         |       ||||         |                |       |     |       |   
  151.     Commands    ||||         |                |       |     |       |   
  152.     Script on -- |||         |                |       |     |       |   
  153.     Echo On ----- ||         |                |       |     |       |   
  154.     Capture On --- |         |                |       |     |       |   
  155.     Alarm Off -----          |                |       |     |       |   
  156.     Host name ---------------                 |       |     |       |   
  157.     Carrier status ---------------------------        |     |       |   
  158.     Time connected -----------------------------------      |       |   
  159.     Transfer protocol --------------------------------------        |   
  160.     Communication port, baud, parity and databits ------------------   
  161.    
  162.    
  163.    
  164.    
  165.    
  166.    
  167.    
  168.    
  169.    
  170.    
  171.    
  172.                                   -Page 4-    
  173.   FILE TRANSFER PROTOCOLS:   
  174.    
  175.     Transfer protocols are used as a method of flow-control and error
  176.     checking when transferring files.  These protocols are specified when 
  177.     adding to the Dialing Directory.  The Dialing Directory is displayed 
  178.     when you press ALT-D. The use of ZModem protocol is recommended if 
  179.     the host computer has the option available.   
  180.     QCom will default to using the built-in protocol unless an external 
  181.     protocol is otherwise specified when editing the Dialing Directory
  182.     or when doing a file transfer.
  183.   
  184.   EXTERNAL PROTOCOLS:   
  185.    
  186.     QCom can be set up to use external protocols.  In QCom Configuration
  187.     select the XFer Options under the Protocols Menu. From the Pop-up
  188.     list of protocols you can select and edit existing protocol options,
  189.     or add a new one by selecting an unused entry marked with " ******* ". 
  190.     Options for the protocols supplied with QCom need not be modified.
  191.     Options for the DSZ examples can be modified to suit your requirements
  192.     but remember that QCom automatically sends the port number, baud
  193.     rate and appropriate pathname to these choices.
  194.     For other external protocols, options such as port, baud rate
  195.     and pathnames will have to manually entered where required.
  196.     Registered users are shown a shortcut way to pass these parameters
  197.     making it unnecessary to edit them whenever a baud rate or pathname
  198.     changes.    
  199.     Note: An unregistered copy of QCom is not "crippled".  The instruct-   
  200.     ions for this feature of QCom are provided to all those who register.   
  201.    
  202.   SCREEN COLORS:   
  203.    
  204.     Screen colors can be changed in QComCFG by selecting the Colors choice 
  205.     under the Terminal Menu. 
  206.  
  207.                                    -Page 5-    
  208.   VARIOUS FUNCTIONS:   
  209.    
  210.     ALT-A:   
  211.          Toggles the sound functions on or off.   
  212.     ALT-B:   
  213.          Allows the user to scroll back up to 500 lines of received data.   
  214.          Search capabilities are provided for finding particular text and   
  215.          the whole buffer can be written to disk using the Save command,   
  216.          "S" (the filename defaults to "QComBuff.Txt") or erase the buffer   
  217.          with "E". "Q" is for quoting previously received text. When "Q" is  
  218.          pressed another menu of choices is presented and one line of text   
  219.          will be highlighted. This highlighted line can be moved through   
  220.          the buffer with the cursor keys, Home, End, PgUp, or PgDn.  Lines   
  221.          can be tagged or untagged by pressing "T" or the SPACE bar.  Once   
  222.          text is selected, it can be save to disk with "F" or immediately   
  223.          sent to the host with "S".  This last feature allows you to quote   
  224.          lines from a message and return them to the host's editor when   
  225.          answering that message online.  "U" will untag all tagged lines   
  226.          as will sending or filing.   
  227.     ALT-C:   
  228.          Communication parameters can be modified here.  These changes   
  229.          are in effect until changed again or until QCom ends.   
  230.          Com Port must be set in QCOm.CFG. Port changes will not take   
  231.          effect unless QCom is restarted.   
  232.    
  233.    
  234.                                   -Page 6-    
  235.   VARIOUS FUNCTION CONTINUED...   
  236.    
  237.     ALT-D:   
  238.          Displays the dialing directory.  Use the arrow keys to select   
  239.          a number and ENTER to dial that number.  Other keys that are   
  240.          PGUP, PGDN, HOME and END.  HOT TIP: Pressing ALT and a letter   
  241.          will put the cursor on the first line beginning with that   
  242.          letter.   
  243.          Add a new entry with "A" or edit an existing one with "E".  To   
  244.          delete an entry press "D".  You can dial the phone with a   
  245.          manually entered number using "M".   
  246.          Phone entries can be tagged or untagged with the Space bar.   
  247.          This will cause QCom to continuously dial all tagged numbers   
  248.          until a connection is made.  Dialing of tagged numbers will   
  249.          commence when the Enter key is pressed.  Once a connection is   
  250.          made and broken you will be returned to the Dialing Directory.   
  251.          Continuous dialing will resume where it left off if Enter is   
  252.          pressed again.   
  253.     ALT-E:   
  254.          Toggles local echo on or off.  This is used when the host does   
  255.          not echo back the characters that you enter.  An "E" is   
  256.          displayed in the left-hand box on the status line when local   
  257.          echo is on.   
  258.     ALT-F:  
  259.          Toggles adding linefeeds to incoming and outgoing lines.  
  260.     ALT-G:   
  261.          Toggles output to printer on and off.  Allows all incoming text to  
  262.          be sent to the printer.  Make sure the printer is online.   
  263.     ALT-H:   
  264.          Sends the hang-up string to the modem and toggles DTR.   
  265.     ALT-I:   
  266.          Will save the current screen image to a text file as specified   
  267.          in the QCom.CFG file.  Default filename is QCOM.SCN which can   
  268.          be changed by editing the QCom.CFG file (use ALT-O).   
  269.     ALT-J:   
  270.          Allows shelling out to DOS without ending QCOM.  External   
  271.          programs can be executed while on-line.  The user could make   
  272.          use of other external file transfer protocols here if desired.   
  273.          Though there is a better way.  See registration section.   
  274.     ALT-K:   
  275.          Toggles between ANSI and TTY terminal emulation.   
  276.     ALT-L:   
  277.          Toggles the "capture" function.  If on, all incoming text will   
  278.          be saved in a file named as specified in the QCom.CFG file.   
  279.          Default is QCOM.CAP.  IF the file  does not exist in the   
  280.          default directory, it will be created.  Otherwise data is   
  281.          appended to an existing capture file.  A "C" is displayed in   
  282.          the left-hand box on the status line when capture is on.   
  283.     ALT-M:   
  284.          Sends the modem initialization string to the modem.  This   
  285.          string is automatically sent upon start-up (providing no   
  286.          carrier is present).   
  287.                                   -Page 7-    
  288.  VARIOUS FUNCTIONS Continued...   
  289.    
  290.     ALT-N:   
  291.          Split-screen separates incoming and outgoing keystrokes   
  292.          during a "chat" session.   
  293.     ALT-O:   
  294.          Brings up the QCOM.CFG file to the screen for editing.   
  295.          Press F10 to save the file and to set the Communication   
  296.          parameters as shown in the file.  Esc exits and makes no   
  297.          changes.   
  298.          If it were necessary to change baud or any other Communication   
  299.          parameter while online, use ALT-O to edit and F10 to set   
  300.          parameters.  Changing the port specified here will have no   
  301.          effect unless QCom is  restarted.   
  302.     ALT-P:   
  303.          Sends the current password from an entry of the Dialing   
  304.          directory when you have dialed and connected to that entry.   
  305.     ALT-Q:   
  306.          Load and execute a script.   
  307.     ALT-R:   
  308.          Re-dials the last phone number dialed when no entries are   
  309.          "Tagged", or if entries are "Tagged", it will continue dialing   
  310.          those.   
  311.     ALT-S:   
  312.          Toggles the Script Save function.  See the Script section for   
  313.          more information on making and using scripts.   
  314.     ALT-T:   
  315.          Allows changing of the transfer protocol currently in effect.   
  316.          This can be done while on-line.   
  317.     ALT-V:   
  318.          Allows the use of an external editor or file viewer.  The   
  319.          editor (or file viewer) of choice is defined in the   
  320.          configuration file.   
  321.     ALT-U:   
  322.          Will send a pure ascii text file to the host with no error-   
  323.          checking.  Ascii transfer is used to send a text file to the   
  324.          host PC.  For example, you might use it when sending a message   
  325.          to an electronic mail service.  Instead of editing the message   
  326.          on-line, you can prepare your message in advance.  Once on-   
  327.          line, go into the message editing screen on the host and then   
  328.          use ALT-U to upload your file.   
  329.     ALT-W:   
  330.          Wipes the screen clear.   
  331.     ALT-X:   
  332.          Ends QCOM.   
  333.    
  334.    
  335.                                   -Page 8-    
  336.   VARIOUS FUNCTIONS Continued...   
  337.    
  338.     ALT-Y:   
  339.         QCom becomes the host computer.  It will wait for any incoming   
  340.         phone calls until ESC is pressed.  When a call is received, QCom   
  341.         will answer the phone.  QCom sends the file HELLO.HOS 
  342.          to the caller's PC.  You can edit this file to suit your own   
  343.          needs using an ANSI "editor" like TheDraw.   
  344.          After this message file is sent, the caller is shown the   
  345.          menu contained in the file "MENU.HOS" 
  346.     
  347.          The caller can select one of the choices or the Host can enter   
  348.          selections.   
  349.          "Help"  sends a brief help screen, HELP.HOS to the user.   
  350.          "Area"  allows the user to change to a different subdirectory.   
  351.          When a caller selects the Area command, a file called AREAS.HOS   
  352.          is displayed on the caller's screen.  This is intended to show   
  353.          which "areas" (subdirectories in fact) the caller can have access    
  354.          to. A sample AREAS.HOS file is included.  Users will want to edit  
  355.          this file to suit their systems.  
  356.          "Files" allows the user to list specified files in that   
  357.          subdirctory.   
  358.          "Chat"  will allow  a dialogue between each PC.  To end Chat   
  359.          and return to the menu, the Host must press ESC.   
  360.          "Upload"  will send a file to the Host using DSZ ZModem.   
  361.          "Download" will send a file to the caller in a similar manner.   
  362.          If the caller specifies the correct path and filename, he will   
  363.          be able  to download a file from anywhere on the Host system.   
  364.          "Proto" will allow the caller to select XModem, YModem or   
  365.          ZModem protocols when transferring files.   
  366.          "Goodbye" will send BYE.HOS and terminate the connection .   
  367.          As Host, you can also terminate the call by pressing ALT-H to   
  368.          hangup. QCom will then wait for the next caller.  ALT-X will   
  369.          also terminate the call and in addition, end QCom.   
  370.          A local Host mode test is available: Press ENTER when waiting   
  371.          for incoming calls.  This allows preparation and preview  of   
  372.          your own host welcome messages or help screens.   
  373.    
  374.      PGUP:   
  375.          Uploads (sends) a file to the other system.  You will be   
  376.          prompted to enter a filename to upload.  The file can be   
  377.          preceded by a path only if NO upload path is specified in   
  378.          QCOM.CFG.  If the host supports batch uploads then you can   
  379.          take advantage of DSZ's capabilities; when prompted for a file   
  380.          to upload enter the name of a file containing a list of the   
  381.          files you wish to upload.  Precede the filename with an "@" .   
  382.          Example: "@files.lst".  Or you can use QCom to create a list   
  383.          file for you.  When prompted for a file to upload press ENTER   
  384.          with any global file specification (*.* or *.zip). You will   
  385.  
  386.  
  387.                                   -Page 9-   
  388.   
  389.  
  390.   VARIOUS FUNCTIONS CONTINUED...    
  391.          be shown a box containing filenames based on that specification.   
  392.          From here simply use the cursor keys to select a files and Mark   
  393.          them with "M".  When finished marking press ENTER and QCom will   
  394.          create "Files.LST" and pass that to DSZ for you.   
  395.    
  396.      PGDN:   
  397.          Downloads (receives) a file from the host computer.  If XModem   
  398.          or YModem are the protocols in effect, you'll be prompted to   
  399.          enter the filename to receive.  QCom tries to guess the   
  400.          filename based on recently entered text and places its' guess   
  401.          at the prompt.   
  402.          If ZModem is in effect, entry of filenames is not required and   
  403.          in fact, pressing PGDN is not required because QCom will call   
  404.          DSZ automatically when it receives the Zmodem Receive string.   
  405.      ALT-=:   
  406.          Toggles "Doorway" mode.  This removes the status line when in   
  407.          Doorway mode and gives full screen display for using remote   
  408.          applications.   
  409.          Allows you to make full use of all keys while online.  All   
  410.          Alt-key combinations except ALT-= are sent out and their usual   
  411.          functions are disabled in this mode.   For example, PgUp,   
  412.          PgDn, Home, End and the cursor key codes are transmitted.  You   
  413.          might make use of this when using a full-screen editor while   
  414.          online or when using your PC as a dumb terminal on a non-DOS   
  415.          system such as Unix.  Status line and all key functions are   
  416.          restored when Doorway mode is turned off.   
  417.      ALT-Minus:   
  418.          Enables/disables debugging during script execution.  Status   
  419.          line displays the next line of text which QCom is looking for.   
  420.      ALT-Space:
  421.           Enables the user defined Main menu when at the terminal screen.     
  422.      Ctrl-END   
  423.          Sends Break signal to host.  Used for terminating some mainframe   
  424.          connections.   
  425.      F1-F10:   
  426.          Sends the text as listed in the last ten lines of QCom.CFG.   
  427.          You can put your name, password, special key codes or whatever   
  428.          you wish here. 80 characters max on each line.   
  429.      Ctrl-F1   
  430.          Displays the "Function Key Macros" as they appear in QCom.CFG.   
  431.      Ctrl-F2   
  432.          Displays the "Alt Key Macros" for registered users.   
  433.    
  434.    
  435.    
  436.    
  437.    
  438.    
  439.    
  440.    
  441.    
  442.                                   -Page 10-    
  443.    SCRIPTS:   
  444.        Scripts are used for automating repetitive tasks such as dialing,   
  445.        logging in to an online service, and transferring files or     
  446.        electronic mail.  A script is generally made up of a series of    
  447.        commands for QCom to execute at the appropriate time.  The script    
  448.        can tell QCom to send text to the host or it can make QCom execute    
  449.        one of its' internal functions.   
  450.    
  451.    MAKING A SCRIPT:   
  452.       QCom has a built-in Script-save feature to simplify the creation of   
  453.       scripts. To create a typical login script you would do the    
  454.       following:   
  455.       1.  From the Dialing Directory dial the number.   
  456.       2.  When the host answers and immediately after the Dialing box   
  457.           clears, press Alt-S to start the script saver.  It will prompt    
  458.           you to enter the name of your script.  If, for example, you're    
  459.           calling CompuServe, you could name it CIS.SCR.   
  460.       3.  QCom will save each line of incoming text which prompts you for   
  461.           input.  For example the host may prompt you...   
  462.                    ENTER YOUR FULL NAME :   
  463.           To which you respond by typing in your name and pressing ENTER   
  464.           when the name is complete.  Always type entries in, don't use   
  465.           Function key macros when saving a script. If/when prompted to   
  466.           press "ANY" key always press ENTER.  QCom will store the host's   
  467.           prompt, and the text you have entered in the script.   
  468.           (Also Note: BBS software that has "HotKey" menu choices where    
  469.           the user is not required to press ENTER after selecting a letter    
  470.           is great BUT... when it comes to saving a script QCom will NOT    
  471.           save the line unless you press ENTER.  So when saving a script    
  472.           turn off the Hotkey feature at the BBS end.)   
  473.       4.  QCom will also store any commands you give it such as ALT-L   
  474.           to turn on the capture function.   
  475.       5.  When you wish to stop saving a script press Alt-S again.   
  476.       6.  To have this new script execute when you call this number again,   
  477.           add the name of your script into that entry in the Dialing   
  478.           Directory. The next time you dial that number the script will be   
  479.           loaded and executed.   
  480.    
  481.       Sample script :   
  482.       put a message on screen   
  483.       ;ECHO ^M This is the start of my script! ^M   
  484.    
  485.       let's capture the session to file.txt   
  486.       ;a-L file.txt   
  487.    
  488.       Do you want graphics (Enter)=no;^M   
  489.       What is your full name?;John Doe^M   
  490.    
  491.       sends password from the Directory entry we just dialed   
  492.       Password (Dots will echo)?;a-P   
  493.       Scan Message Base Since 'Last Read' (Enter)=yes;^M   
  494.       Press (Enter) to continue;^M   
  495.                                   -Page 11-    
  496.    
  497.    MAKING A SCRIPT Continued...   
  498.    
  499.       receiving (downloading) a file   
  500.       min. left) Main Board Command?;d^M   
  501.       Filename to Download (Enter)=none?;file.arc^M   
  502.    
  503.       downloads "file.arc"   
  504.       ;D/L file.arc   
  505.       Press (Enter) to continue;^M   
  506.    
  507.       goodbye   
  508.       min. left) Main Board Command?;g^M   
  509.    
  510.       give hangup command   
  511.       ;a-H Y   
  512.    
  513.       execute another script   
  514.       ;a-Q MyBBS.SCR   
  515.    
  516.       The following is an example of a script that connects to   
  517.       CompuServe through the DataPac network.   
  518.    
  519.       ;ECHO  Logging in to CompuServe.  Please wait...   
  520.    
  521.       send "..." when connected   
  522.       ;...^M   
  523.    
  524.       send node id number when the word DATAPAC is received   
  525.       DATAPAC;P 12345678^M   
  526.    
  527.       CompuServe Information Service   
  528.       Host Name:;CIS^M   
  529.    
  530.       insert your user ID   
  531.       User ID:;12345,6789^M   
  532.    
  533.       send password from dialing directory   
  534.       Password:;a-P   
  535.    
  536.       check for mail or whatever   
  537.       Enter choice!;5^M   
  538.       etc, etc.   
  539.    
  540.       See the included file QCOM.SCR for more examples on scripting.   
  541.    
  542.       Note: When saving a script, QCom saves every line of incoming text on   
  543.       which the user is prompted for input AND which is terminated with a   
  544.       carriage return ( by pressing the ENTER key).  Any line that prompts   
  545.       the user and does not require the ENTER key to be pressed, will NOT   
  546.       be saved in the script.  Such lines would have to be manually typed   
  547.       into the script with a text editor.   
  548.                                   -Page 12-    
  549.    MAKING A SCRIPT Continued...   
  550.    
  551.       In order to use a script automatically, put the name of the   
  552.       script file in the SCRIPT column in the Dialing Directory.   
  553.       One way to create a new script is to capture a session and then   
  554.       edit it to conform to the above format, using the semicolons to   
  555.       separate incoming and outgoing text.  Any unnecessary text can be   
  556.       deleted from the capture file (such as news bulletins, etc.).   
  557.       Rename the file using ".SCR" as the extension in your script   
  558.       filename.   
  559.    
  560.    COMMANDLINE SCRIPTS:   
  561.    
  562.       Commandline scripts allow you to start Qcom, dial a number, transfer   
  563.       files, hangup and end Qcom automatically.   
  564.    
  565.       To create such a COMMANDLINE script, run Qcom, press ALT-S before   
  566.       going into the Dialing Directory .  Enter the name of your script,    
  567.       and proceed to step the program through the whole dialing and    
  568.       connection procedure.  Qcom will save your commands as well as the    
  569.       text coming in and going out.   
  570.    
  571.       To execute this script from the commandline use:   
  572.    
  573.       "QCom /SMyScript.scr"   
  574.    
  575.       The "/S" tells QCom that the following is the name of a script to   
  576.       execute. You must use the full script filename.   
  577.       When a script is executing you will see an upper case "S" on the   
  578.       Status line.  To stop script execution at any time, press ALT-S.   
  579.    
  580.       Note:   
  581.       When your script dials a directory entry that has another script   
  582.       specified, the second script will be ignored.  You can, however,   
  583.       call another script by using the ALT-Q command.   
  584.       (eg. ";a-Q ANOTHER.SCR").   
  585.    
  586.    SCRIPT COMMANDS:   
  587.    
  588.       Most Script commands consist of shorthand for the keystrokes   
  589.       you would use when manually running QCom.  The ALT-Key commands   
  590.       that QCom understands can be entered into a script with  ";a-"   
  591.       followed by the letter you wish to use. Eg. ALT-P would be ";a-p".   
  592.       Upper or lower case will work.   
  593.    
  594.       Exceptions: ALT-- (ALT-Minus) and ALT-= cannot be saved or executed   
  595.       in a script.   
  596.    
  597.    
  598.    
  599.    
  600.    
  601.                                   -Page 13-    
  602.    SCRIPT COMMANDS CONTINUED...   
  603.    
  604.       The following are script commands that may be manually added to   
  605.       scripts.  These are NOT included in Saved scripts.   
  606.    
  607.       "ANY"     - used to send a given response to text that is received   
  608.                 repeatedly.   
  609.                 eg. ;ANY Press any key;^M   Whenever "Press any key" is   
  610.                 received, a carriage return will be sent. This will remain   
  611.                 in effect until the ANY command is used again in the script   
  612.                 to specify new incoming text.   
  613.                 eg. ANY   
  614.                 This effectively "turns off" a previous ANY command. QCom   
  615.                 will no longer respond to the previously specified incoming   
  616.                 text.   
  617.    
  618.      "DEBUG ON" -used in script debugging   
  619.                 The Status line shows which line of incoming text the    
  620.                 script is waiting for. This allows you to compare a script    
  621.                 line to actual received text to check for spelling errors    
  622.                 or typos in cases where a script is not working properly.   
  623.                 Pressing ALT-V during a debug session will load your script   
  624.                 into your editor so you can make corrections on the fly.   
  625.    
  626.      "DEBUG OFF" -disables the debug function.   
  627.    
  628.      "ECHO"     -prints text on the local screen.   
  629.                 eg. ";ECHO Please wait. Auto Logon in progress..."   
  630.                 Text can be colorized and positioned on screen   
  631.                 using ANSI escape codes.   
  632.    
  633.      "LOG"      - will save date, hostname, start time and duration   
  634.                 of calls in optional specified filename. If no log file   
  635.                 is specified, QCom defaults to "USAGE.LOG".   
  636.                 eg. ";LOG CIS.LOG"  could store a log of calls to   
  637.                 CompuServe. Also provided is a utility to total the   
  638.                 durations of calls, named QTT.EXE. Usage: QTT LogFile.   
  639.    
  640.      "WAIT"     - will pause the execution of a script for a specified   
  641.                 number of seconds.  Eg. ";WAIT 5"  will pause everything   
  642.                 for five seconds.  Do not pause for too long if you expect   
  643.                 to have incoming data during this time.  Hitting any key   
  644.                 will terminate a pause and continue the script.   
  645.    
  646.      "DOS"      Allows you to shell to Dos and execute batch files or   
  647.                 whatever.  Use the /WAIT switch after the commandline if   
  648.                 you wish to pause the display before returning to QCom.   
  649.                 eg:   
  650.                 ;DOS vampire.bat /WAIT   
  651.    
  652.    
  653.    
  654.                                   -Page 14-   
  655.   SCRIPT COMMANDS CONTINUED...   
  656.    
  657.       "ASK"     Used to get user input from the keyboard.  This will display  
  658.                 your "User Prompt" in a box and wait for user input.  When    
  659.                 the user presses Enter, QCom will compare the user's input    
  660.                 to the text in "Answer". If it is the same then the script    
  661.                 will go to the "Label". Otherwise the script will continue    
  662.                 with the next line. Use commas to separate the prompt,    
  663.                 answer and label.    
  664.                 Usage: ;ASK User Prompt ,Answer,Label    
  665.                 eg:   
  666.                 ;ASK Download your mail? (Y/N) ,Y,DownLoad Mail   
  667.                 ;GOTO No Download   
  668.                 :DownLoad Mail   
  669.                 ;...   
  670.    
  671.       "GOTO"    To branch to another part of the script.   
  672.                 eg:   
  673.                 ;GOTO Label 1   
  674.                 or...   
  675.                 When this text is received;GOTO Label 2   
  676.    
  677.       "CALL"    To go to another part of the script and execute until the    
  678.                 RET (Return) command is encountered. It returns to the line   
  679.                 following the Call. Calls can be nested 255 levels.   
  680.                 eg:   
  681.                 When this text is received;CALL Label 3   
  682.                 or...   
  683.                 ;Call Label 3   
  684.                 ;END   
  685.                 :Label 3   
  686.                 Look for this text;send something^M   
  687.                 ;RET   
  688.    
  689.       "RET"     As above, used to return from a CALL. A RET must not be    
  690.                 executed unless a CALL has been executed first. RET cannot    
  691.                 be used with GOTO.   
  692.                 Usage: ;RET   
  693.    
  694.       "T/O"     Timeout for incoming text.  A given timeout value will apply  
  695.                 to any script line waiting for incoming text which follows    
  696.                 the T/O command.    
  697.                 To enable timeout use: ;T/O Seconds   
  698.                 To disable timeout use: ;T/O 0   
  699.       
  700.         Example:   
  701.                 ;T/O 10   
  702.                 Wait for text for 10 seconds;Send if received before 10 secs  
  703.                 Otherwise wait for this for 10 seconds;...etc.   
  704.                 Disable timeout:   
  705.                 ;T/O 0    
  706.                                   -Page 15-      
  707.   SCRIPT COMMANDS CONTINUED...   
  708.        
  709.       "ENQ"     Have QCom do something upon receiving an ENQ character (^E).  
  710.       A typical use would be when transferring a file on Compuserve using   
  711.       the QuickB protocol. The following example shows how to have QCom   
  712.       shell out to OZBext (an external QuickB protocol) to transfer a file   
  713.       on Com port 2 when the ENQ character is received.   
  714.       Eg:  ENQ;DOS OZBext /c2 /x    
  715.    
  716.       Registered users may use port and file abbreviations, etc., where    
  717.       appropriate, as per their instruction sheet.   
  718.       After QCom receives this ENQ it stops looking for further ENQ's.   
  719.        
  720.       "END"    Used to stop script execution.   
  721.             eg:   
  722.             ;END   
  723.             or...   
  724.             When this text is received;END    
  725.  
  726.       "TAG" Used for tagging or marking Dialing Directory entries for 
  727.             dialing.
  728.             eg:
  729.             ;TAG PCUG 
  730.             QCom will tag or mark all Dialing Directory entries starting with  
  731.             "PCUG". To tag only one of several entries with similar names it is 
  732.             necessary to have something unique in the name you wish to tag.
  733.             eg: ";TAG PCUG Node 1"
  734.  
  735.             Note : When entries have been tagged with the above TAG command,   
  736.             use the DIAL command without a specified name.
  737.             eg:
  738.             ;TAG PCUG
  739.             ;DIAL
  740.             This will cause QCom to dial all tagged entries until a connection 
  741.             is made.
  742.     
  743.        "UNTAG" QCom will untag all marked Dialing entries.
  744.             eg:
  745.             ;UNTAG
  746.   
  747.       The following are script commands that may be manually added to   
  748.       scripts.  These ARE included in Saved scripts.   
  749.    
  750.       "DIAL"    -dials the entry specified. Eg. ";DIAL CompuServe"   
  751.       "U/L"     -uploads the specified file Eg. ";U/L Myfile.Zip"   
  752.       "D/L"     -downloads the specified file Eg. ";D/L Myfile.Zip"   
  753.       "BREAK"   -sends a BREAK signal to the host Eg. ";BREAK"   
  754.  
  755.  
  756.  
  757.  
  758.  
  759.                                    -Page 16-
  760.    
  761.    Labels:   
  762.       Like labels in batch files, a label is preceded by a colon and can   
  763.       consist of one or more words or numbers.  No semi colon is used as   
  764.       in other script lines.   
  765.       eg:   
  766.       :Label 1   
  767.       :Label 2   
  768.    
  769.    SEMICOLONS:       
  770.       In a QCom script, the semicolon is all important. It divides each   
  771.       line into incoming and outgoing text. Lines beginning with a semi-   
  772.       colon are commands that QCom will execute (such as an ALT-Key   
  773.       command).   
  774.       Also note that only the first semicolon is used as a divider.   
  775.       Subsequent semicolons are treated as regular text.   
  776.    
  777.       Any line of text in a script with no semicolon or colon is ignored    
  778.       by QCom and can be used as a comment line for clarification when    
  779.       viewing or editing the script.   
  780.    
  781.       Script execution takes place only in the terminal screen. If your   
  782.       script executes something like ALT-B (ScrollBack) or ALT-Z (Help),   
  783.       manual input will be necessary to return to the terminal screen to   
  784.       continue script execution.   
  785.    
  786.     FINAL NOTE ON SCRIPTS:   
  787.       When saving a script, incoming phone noise may be saved during a   
  788.       session and will have to be edited out before using the script.   
  789.       It's wise to double-check a newly created script for any unwanted   
  790.       characters.  Any pure text editor can be used to edit or create a   
  791.       script file.   
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.                                    -Page 17-
  806.    
  807.     TROUBLE SHOOTING:   
  808.       Symptom: Modem returns "ERROR" when initializing.
  809.       This simply means that one or more commands in the modem initialzation    
  810.       string is not understood by the modem. The modem initialzation string is  
  811.       stored in QCom's configuration file call QCom.CFG. You can view and edit  
  812.       this string if you wish. Press ALT-O to enter the Options screen where
  813.       you will find the modem Init string.
  814.       Refer to your modem instruction manual to compare the modem commands 
  815.       against thoise contained in the initialization string and delete those
  816.       that your modem doesn't understand. Save and exit with F10.
  817.       To test the string press ALT-M to reinitialize the modem.   
  818.    
  819.       Symptom:  "Cannot initialize Com Port x" error message. (x = 1 to 4)   
  820.       Meaning of error message: Qcom cannot find the Com Port that is   
  821.       specified in the configuration file (QCom.CFG).   
  822.       Possible causes:   
  823.       1. Error in configuration file.  The number specified there does not   
  824.          match the Com Port used by the modem.   
  825.       2. Hardware problem.  Two or more devices are configured for the same   
  826.          Com port or the Com port specified is not installed.   
  827.          Check that there is no conflict in hardware interrupt settings.   
  828.          If two serial devices attempt to use the same Interrupt (IRQ)   
  829.          setting chances are, neither will work. Typical settings would be:   
  830.    
  831.                            Com1 using IRQ 4, at I/O 3F8h   
  832.                            Com2 using IRQ 3, at I/O 2F8h   
  833.                            Com3 using IRQ 4, at I/O 3E8h   
  834.                            Com4 using IRQ 3, at I/O 2E8h   
  835.    
  836.       3. Software conflict. A memory resident program that ties up the Com   
  837.          port has been previously executed and has not been deinstalled.   
  838.          Carbon Copy is an example of such a program.   
  839.    
  840.       Symptom: "Modem not responding"   
  841.       Meaning of message: Modem did not respond with "OK" within the   
  842.       alotted time.   
  843.       Possible causes:  See the following:   
  844.    
  845.       Symptom: Modem does not dial out.  Modem does not receive some/all   
  846.       commands sent by QCom.   
  847.       Possible causes:   
  848.       1. Baud rate specified in the configuration file is too high for the   
  849.          modem. Set the default baud rate to your modem's fastest speed.  Modem 
  850.          will send back an "OK" when you initialize the modem (Alt-M) if   
  851.          all is well.   
  852.       2. External modem is not powered up or not connected properly.   
  853.       3. Possible hardware conflicts with another installed serial device.   
  854.          Internal modem has been improperly installed or configured.   
  855.       4. Modem initialization or dialing prefix strings are incorrect.          
  856.          Refer to the Modem instruction manual for the correct strings for   
  857.          your modem.   
  858.                                   -Page 18-    
  859.    TROUBLE SHOOTING Continued...   
  860.    
  861.       5. Modem is incorrectly configured.  Refer to modem manual and set   
  862.          modem dip switches or NVRam for the following:   
  863.          a) Modem must track the actual state of DCD (Carrier) and not be   
  864.             forced.   
  865.          b) Modem should track DTR and not be forced.   
  866.          c) Modem MUST send back verbal result codes such as "OK" or   
  867.             "CONNECT", etc.   
  868.    
  869.       6. See the following   
  870.          Symptom:  QCom status line says "Online" even when not.   
  871.          Cause:   
  872.          Modem Carrier Detect line is forced on.  This MUST toggle on or    
  873.          off depending on the actual Carrier state.  This is set with a    
  874.          modem dip switch or a command sent in the initialization string.     
  875.          Refer to the modem manual.  Edit the initialization string if    
  876.          necessary and use Alt-M to manually send the string to the modem.    
  877.  
  878.          Or toggle the Carrier detect dip-switch if present.   
  879.          Many modem factories typically set this to default to always on.   
  880.          One result of this is QCom will prompt you whether you want to   
  881.          initialize the modem at start-up which is an unnecessary annoyance   
  882.          (the prompt is necessary in the instance where QCom is used as a   
  883.          dumb terminal attached directly to another machine).   
  884.    
  885.    
  886.          Symptom: Pressing Alt-M to re-initialize the modem gets back    
  887.          "ERROR" from the modem.   
  888.          Cause:   
  889.          The modem initialization string (line six in the QCom.CFG file)   
  890.          contains command(s) that the modem does not understand.  Or, the   
  891.          command string is too lengthy.  Refer to the modem manual and    
  892.          remove any command not found in the manual.  Long initialization    
  893.          strings can be broken up into two sections with "^M~~~AT" inserted   
  894.          about halfway.   
  895.    
  896.          Symptom: QCom reports "Unable to find DSZ.COM or DSZ.EXE"   
  897.          Cause:   
  898.          DSZ.COM or DSZ.EXE are not found in the default directory (the    
  899.          same directory as QCom) or in the search path.  Put DSZ into    
  900.          correct directory.   
  901.           
  902.          Symptom:Always get a fast busy signal after dialing. 
  903.          Cause:  
  904.          a) Call waiting string in Options is enabled when the feature 
  905.          is not present on the phone line.  Disable the string by erasing 
  906.          it or prefix it with a semicolon. 
  907.          b) A pause character may need to be added after the string. Most   
  908.          modems recognize a comma as a half second pause. eg:"*70,," 
  909.    
  910.                                       -Page 19-    
  911.    
  912.     ONLINE SUPPORT BBS:   
  913.    
  914.          To obtain further help, or for the latest update of Qcom, you   
  915.          can call the support BBS:   
  916.    
  917.          ************************************************   
  918.          *   Programmer's Oasis, Ph.  1-204-478-3562.   *   
  919.          ************************************************   
  920.    
  921.          
  922.          When calling in, login as a new user with your full name and   
  923.          password of your choice. After answering a few questions you   
  924.          will be given the opportunity to go into the QCom area.   
  925.          Once there you will have 30 minutes to send or receive messages   
  926.          and download files.  Questions about QCom should be directed   
  927.          to the author, not the Sysops.   
  928.    
  929.          Sysops Brian Lowe and Bernie Minuk are to be commended for   
  930.          all their effort and enthusiasm in setting up and maintaining   
  931.          this support area on their BBS.  Thanks guys, for doing an   
  932.          outstanding job.   
  933.    
  934.       DISCLAIMER:   
  935.    
  936.       This software is provided "as is" without warranty either express or   
  937.       implied.  The user assumes all responsibility in determining its'   
  938.       usefulness and or fitness for any purpose, and assumes all risks and   
  939.       liabilities including damages for loss of business profits, business   
  940.       interruption, or loss of business information arising from the   
  941.       operation of this software.   
  942.    
  943.    
  944.    
  945.    
  946.    
  947.    
  948.    
  949.    
  950.    
  951.    
  952.    
  953.    
  954.     
  955.   
  956.  
  957.   
  958.  
  959.   
  960.  
  961.   
  962.  
  963.                                   -Page 20-   
  964.  
  965.                                         
  966.  
  967.                                         
  968.  
  969.              **************************************************  
  970.  
  971.                               QCOM REGISTRATION  
  972.  
  973.                                         
  974.  
  975.                  If you use QCom,  please register it.  This  
  976.                 software is the result of a great deal of time  
  977.             and effort.  Please support its' continued development  
  978.                           and the Shareware concept.  
  979.  
  980.                                 WHY REGISTER ?           
  981.        Those who register will be shown how to set up and use the 
  982.        user defineable ALT-Key functions.  Users can pre-define other  
  983.       external protocols, or DOS commands, and access them with a single  
  984.      keystroke. These instructions are essential to make the most of QCom. 
  985.      Additionally, registrations are the ONLY motivation to continued
  986.      development of QCom. The time spent on QCom development is directly
  987.      proportional to the number of registrations. Your support matters.
  988.                                          
  989.  
  990.               The one-time registration fee is a modest $20.00.  
  991.               To receive a copy of the absolute latest version on  
  992.                  disk, send an additional $5.00 to cover cost  
  993.                  of disk, packaging and mailing.  Specify disk  
  994.                    size desired and your current version.  
  995.  
  996.            A quick mailer is provided in the file called Register.  
  997.                   
  998.                         Send a check or money order to:  
  999.                                      
  1000.                                 RTFM  Software  
  1001.                                 108 Egesz St.  
  1002.                                 Winnipeg, Mb. Canada  
  1003.                                 R2R 2E1  
  1004.                                     
  1005.              Your comments, questions, suggestions and bug reports  
  1006.                 are always welcome whether or not you register.  
  1007.         Drop me a note, leave a message on CompuServe I.D. 72361,3117.  
  1008.       Or, leave a message on Programmer's Oasis BBS, Ph.  1-204-478-3562.  
  1009.  
  1010.              **************************************************  
  1011.  
  1012.                                         
  1013.                                     
  1014.                                       
  1015.                                        
  1016.                         
  1017.                            
  1018.                      
  1019.                                   -Page 21- 
  1020.              
  1021.