home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / comm / record21.zip / RECORD.DOC < prev    next >
Text File  |  1994-04-09  |  15KB  |  384 lines
  1.  
  2.                               **** RECORD ****
  3.  
  4.                        A SALT Script Creator for Telix
  5.                                  Version 2.1
  6.  
  7.                                      by
  8.                                Mark P. Harrison
  9.                        Documentation by: Chris Johnson
  10.                                   04/09/94
  11.  
  12.         Copyright 1993,94 by Mark P. Harrison. All Rights Reserved.
  13.  
  14.  
  15.         ─────────────
  16.         LEGAL NOTICE:
  17.         ─────────────
  18.  
  19.         RECORD is a Shareware product. It is NOT freeware or public
  20.         domain.  If you use RECORD you are expected to pay for it.
  21.         You can register RECORD at a cost of $10.00 (U.S. currency).
  22.         In return for your registration, you will be provided a key
  23.         to remove the Exit Screen and other unregistered reminders
  24.         from this and any future versions.
  25.  
  26.         RECORD IS PROVIDED ON AN "AS IS" BASIS WITHOUT WARRANTY OF ANY
  27.         KIND EXPRESSED OR IMPLIED. IN NO EVENT WILL MARK P. HARRISON BE
  28.         LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST
  29.         SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
  30.         OF THE USE OF OR INABILITY TO USE THE PROGRAM, EVEN IF MARK P.
  31.         HARRISON HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR
  32.         FOR ANY CLAIM BY ANY OTHER PARTY.
  33.  
  34.         RECORD is a trademark of Mark P. Harrison
  35.  
  36.         SALT and Telix are trademarks of deltaComm Development.
  37.         Use of Telix(tm) for longer than 45 days without appropriate
  38.         payment to deltaComm Development for Telix is a violation of
  39.         international Copyright Law.
  40.  
  41.  
  42.         ────────────
  43.         Packing List
  44.         ────────────
  45.  
  46.           RECORD.SLC        15204      The RECORD Script Itself
  47.           RECORD.DOC        15372      This Documentation File
  48.           HISTORY.TXT       2429       Version History
  49.           REGISTER.TXT      2545       Registration Form
  50.           FILE_ID.DIZ       346        Description File
  51.  
  52.  
  53.         ──────────────────────────
  54.         Note to CompuServe Users's
  55.         ──────────────────────────
  56.  
  57.         If you downloaded RECORD from CompuServe, Please rename the
  58.         archive RECORD21.ZIP before uploading it anywhere.
  59.  
  60.  
  61.  
  62.         ──────────────────────────
  63.         Features/Fixes New to V2.1
  64.         ──────────────────────────
  65.  
  66.         *   RECORD can now edit your dialing directory with your new
  67.             linked script name if the record/compile session was
  68.             successful.
  69.  
  70.         *   You can now record keys at a blank screen (needed to
  71.             "wake up" some systems).
  72.  
  73.         *   You can now record turning the Telix capture file on/off
  74.  
  75.         *   Numbers can now be entered from the numeric keypad.
  76.  
  77.         *   The number of Prompt/Answer pairs allowed has been
  78.             increased.
  79.  
  80.         *   1 character prompts are now supported. (This was causing
  81.             double prompts to be written into the script).
  82.  
  83.         *   Added Carrier check to the WAIT() function to end the script
  84.             sooner if you get disconnected.
  85.  
  86.  
  87.         ───────────────
  88.         SPECIAL THANKS:
  89.         ───────────────
  90.  
  91.         There are several people I would like to thank for helping
  92.         make this version of RECORD what it is:
  93.  
  94.         Chris Johnson for the documentation.
  95.  
  96.         Phil Crown for the dialing directory code segment.
  97.  
  98.         Jerry Miller for extensive testing with blank screens.
  99.  
  100.         Crawford Dales for tracking down an odd bug.
  101.  
  102.         All of my registered users for their money <G>
  103.         and great suggestions on things to add.
  104.  
  105.         YOU for taking the time to give RECORD a try.
  106.  
  107.  
  108.  
  109.         ───────────────
  110.         What is RECORD?
  111.         ───────────────
  112.  
  113.         RECORD is a script written entirely in the Script Application
  114.         Language for Telix (SALT).  Its function is to automate the
  115.         process of logging on to bulletin boards (and other systems),
  116.         perform a desired task(s) and then log off. RECORD frees the
  117.         user from making keystrokes by doing routine tasks faster, saving
  118.         time and money.
  119.  
  120.  
  121.         ─────────────────
  122.         How Does it Work?
  123.         ─────────────────
  124.  
  125.         As its name suggests, RECORD makes an exact copy of the
  126.         functions you perform as you interact online with a BBS.  It
  127.         keeps track of the prompts sent by the BBS, in addition to
  128.         the user's responses.  Once the session has ended, RECORD then
  129.         invokes the SALT compiler to create an executable file.  The
  130.         name of this file will be placed in the Telix dialing directory
  131.         as a "linked script" which will be automatically run when the
  132.         selected dialing directory entry establishes a connection.
  133.  
  134.             NOTE:  When a BBS makes changes to their online
  135.                    prompts your RECORD script will obviously
  136.                    fail.  When this happens, RECORD will tell
  137.                    you what prompt it was expecting so you
  138.                    will know what caused the failure.  To fix
  139.                    this problem simply create a new script.
  140.  
  141.  
  142.         ────────────────────────────
  143.         What Can a RECORD Script Do?
  144.         ────────────────────────────
  145.  
  146.         RECORD scripts can be used for uploads and/or downloads.  For
  147.         example, you can upload a mail packet reply and download new
  148.         messages in the same RECORD session.  Only one upload is
  149.         permitted, but it can be a batch upload if you are using a
  150.         protocol that supports batch uploading.
  151.  
  152.             NOTE:  If you choose, RECORD can delete a successfully
  153.                    uploaded file.   This feature does not work for
  154.                    batch uploads.
  155.  
  156.         Scripts created with RECORD now have the ability to turn on and
  157.         off the Telix Capture File feature.  This feature can be very
  158.         useful for getting specific information from a BBS that is only
  159.         displayed on the screen.
  160.  
  161.  
  162.  
  163.         ─────────────────
  164.         Installing RECORD
  165.         ─────────────────
  166.  
  167.         This documentation assumes you are currently running Telix and
  168.         have completed all the necessary configurations (Alt-O) to
  169.         perform file transfers.  It is also assumed that you understand
  170.         the basics of editing the dialing directory, specifically the
  171.         "Linked Script" entry.  If any of the above seems a little
  172.         fuzzy, consult your Telix manual.
  173.  
  174.         1.__  Copy RECORD21.ZIP to your Telix defined script
  175.               directory,  Ex. c:\telix\scripts\ <-note trailing "\".
  176.               CS.EXE, the SALT compiler that comes with Telix must be
  177.               present in the same directory.
  178.  
  179.         2.__  Unzip RECORD21.ZIP. If you have a prior version of any of
  180.               these files present, you will be prompted if you want
  181.               them overwritten. You must answer yes to update your files.
  182.  
  183.         3.__  That's all there is to it!
  184.  
  185.  
  186.         ──────────────────
  187.         RECORDing a Script
  188.         ──────────────────
  189.  
  190.         Here are the steps for creating a RECORD script.  Since every
  191.         script is different, only the steps for logging on, compiling,
  192.         naming and defining the script are discussed.  What you do in
  193.         between is your own business. [g]
  194.  
  195.         1.__  With Telix running, <Press>Alt-D to call up the dialing
  196.               directory.
  197.  
  198.         2.__  <Highlight>an entry and <Press>E to edit.
  199.  
  200.         3.__  <Press>Enter until the "Linked Script" field is
  201.               highlighted, then <Type>RECORD
  202.  
  203.         4.__  <Press>Enter to save your entry and then exit the
  204.               edit screen by continuing to <Press>Enter until the
  205.               edit screen closes.
  206.  
  207.         5.__  <Press>D to make the call.
  208.  
  209.             **If the BBS you are calling requires you to enter one or
  210.               two Escapes when you connect, just <Press>Esc once.  The
  211.               second Esc will be entered for you.
  212.  
  213.             **If the BBS starts with a blank screen, <Press>Enter (or
  214.