home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / COMM / MISC / QCOM290.ZIP / QCOM.DOC next >
Encoding:
Text File  |  1992-04-06  |  40.4 KB  |  980 lines

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