home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progc / alib12.arj / DESCRIBE.DOC < prev    next >
Text File  |  1992-03-30  |  9KB  |  277 lines
  1.  
  2.  
  3.  
  4.  
  5.      DESCRIBE.DOC
  6.  
  7.      Contents
  8.  
  9.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  10.  
  11.      Program Name  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  12.  
  13.      Keywords  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  14.  
  15.      Category  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  16.  
  17.      Product Group . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  18.  
  19.      System Requirements . . . . . . . . . . . . . . . . . . . . . . .    2
  20.  
  21.      Very Short Description  . . . . . . . . . . . . . . . . . . . . .    2
  22.  
  23.      Short Description . . . . . . . . . . . . . . . . . . . . . . . .    2
  24.  
  25.      Long Description  . . . . . . . . . . . . . . . . . . . . . . . .    3
  26.  
  27.      Sample Customer Applications  . . . . . . . . . . . . . . . . . .    3
  28.  
  29.      Quotes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  30.  
  31.      Registration Information  . . . . . . . . . . . . . . . . . . . .    4
  32.  
  33.      Author/Publisher Information  . . . . . . . . . . . . . . . . . .    5
  34.  
  35.  
  36.      Introduction
  37.  
  38.      This file includes sample descriptions which vendors and sysop's may
  39.      use to describe the AutoLibrary Program-Playback Tool package. 
  40.      Additional information can be found in VENDOR.DOC and SYSOP.DOC. 
  41.      Individual and Company Users can find additional information in
  42.      LICENSE.DOC, SITELICE.DOC, and REGISTER.DOC.
  43.  
  44.      Also, see the introduction and tutorial section in MANUAL.DOC. 
  45.      CONSULT.DOC also has a lot of information even if you are not
  46.      interested in consulting or contracting services.
  47.  
  48.      Program Name
  49.  
  50.           The AutoLibrary(tm) Program-Playback Tool
  51.  
  52.  
  53.      Keywords
  54.  
  55.  
  56.                                                                           1
  57.  
  58.  
  59.  
  60.  
  61.           Automation, automate, playback, rs232, testing, communication
  62.  
  63.  
  64.      Category
  65.  
  66.           Automation/Testing/Communication
  67.  
  68.      Product Group
  69.  
  70.           This product fits into a product group called: Program-Playback
  71.           tools.  This group is very similar to Capture-Playback tools. 
  72.           Capture-Playback tools capture keystrokes to script files to be
  73.           played back later.  Program-Playback tools do not capture
  74.           keystrokes, instead, keystrokes are manually programmed into C
  75.           programs.  When the program is executed, the automation is played
  76.           back.  Capture-Playback tools are used mostly for testing,
  77.           whereas, Program-Playback tools are used for all types of
  78.           automation.  This includes automated testing, programs written to
  79.           automate CompuServe, automating host-target protocols, and so on.
  80.  
  81.           Program-Playback tools do not replace Capture-Playback tools. 
  82.           Instead, Program-Playback tools should be used when a C program
  83.           is the best way to automate.
  84.  
  85.  
  86.      System Requirements
  87.  
  88.           a)   Turbo C v2.0
  89.           b)   COM1 or COM2 serial port.
  90.           c)   IBM PC or compatible.
  91.  
  92.  
  93.      Very Short Description
  94.  
  95.      The AutoLibrary(tm) Program-Playback tool is a C function library for
  96.      automation.  Automation is coded into programs then played back when
  97.      the program executes.
  98.  
  99.  
  100.      Short Description
  101.  
  102.      The AutoLibrary(tm) Program-Playback tool gives C programs an easy way
  103.      to automate communications.  Automation is coded into programs then
  104.      played back when the program executes.  This tool is an automation
  105.      layer, which can interface to virtually any type of serial
  106.      communications protocol, such as, RS-232, RS-422, network,
  107.      proprietary, and so on. (A basic RS-232 asynchronous interface library
  108.      is provided.)  Program-Playback automation is similar to Capture-
  109.  
  110.  
  111.                                                                           2
  112.  
  113.  
  114.  
  115.      Playback automation.  With Capture-Playback automation keystrokes are
  116.      captured to script files as you type.  Later, the script files are
  117.      played back.  With Program-Playback automation the keystrokes are
  118.      manually coded into C programs and then played back when the program
  119.      executes.  Use this tool when you want to write a C program to
  120.      automate.
  121.  
  122.  
  123.      Long Description
  124.  
  125.      The history behind the AutoLibrary Program-Playback Tool started in
  126.      1985.  This was when I was given the assignment to write a monitoring
  127.      program that would automatically test to see if network resources were
  128.      available.  Without any experience in automation, I first wrote this
  129.      monitoring program using a terminal emulator's script language. 
  130.      However, after writing the script language version, I found that what
  131.      I really wanted was the ability to implement the automation scripts in
  132.      the C programming language, instead of, in an interpretive language. 
  133.      Within C, I was able to write a normal program, using subroutines and
  134.      data structures.  I was also able to use the C library functions and
  135.      take advantage of commercially available C libraries.
  136.  
  137.      Because of the history behind this automation tool, the current
  138.      version is packed with functionality.  For example, I found that
  139.      successful automation requires two types of timeouts.  A 'Repeating
  140.      Timeout' and an 'Ending Timeout.'  Before defining these terms, notice
  141.      that the basic model of automation requires timeouts.  Automation is
  142.      programmatically sending a keystroke sequence, then scanning the
  143.      output for a list of expected responses.  When none of the expected
  144.      responses are found, a timeout must occur.  (The program will enter an
  145.      endless loop without a timeout feature.)
  146.  
  147.      Now, I will define both types of timeouts.  A repeating timeout starts
  148.      over after each received character.  Therefore, if a repeating timeout
  149.      of 10 seconds is specified, the timeout will not occur unless there is
  150.      communication silents for 10 seconds.  A timeout will never occur if
  151.      characters are continuously received.  An ending timeout, on the other
  152.      hand, is not reset with each newly received character.  If an ending
  153.      timeout of 20 seconds is specified, a timeout will occur in 20 seconds
  154.      regardless, assuming none of the expected responses are received.
  155.  
  156.      The AutoLibrary(tm) Program-Playback tool gives C programs an easy way
  157.      to automate communications.  If your application uses serial
  158.      communications to communicate to a program or interface that is
  159.      normally operated by a human, then there is a good chance that the
  160.      AutoLibrary(tm) Program-Playback tool would be useful for you.
  161.  
  162.  
  163.      Sample Customer Applications
  164.  
  165.  
  166.                                                                           3
  167.  
  168.  
  169.  
  170.  
  171.      1)   A monitoring program that tests the accessibility of host
  172.           computers.
  173.  
  174.      2)   An application that accesses remote services automatically like
  175.           CompuServe or online news services.
  176.  
  177.      3)   A test suite written to test equipment.  (Medical equipment, for
  178.           example)
  179.  
  180.      4)   A test suite written to test other software packages.
  181.  
  182.      4)   Automate a "host-target" relationship, such as, a target debug
  183.           monitor.
  184.  
  185.      5)   Automating manual operations that normally require visual checks
  186.           from equipment or terminals.
  187.  
  188.      6)   Automating an existing test suite.
  189.  
  190.  
  191.      Quotes
  192.  
  193.      Lindsey Godfrey, of Boeing Computer Services, Richland Inc., has
  194.      started using The AutoLibrary Program-Playback Tool and says, "It's a
  195.      Good Product.  I have developed interface libraries for the Blaise
  196.      communication package and our Ungermann-Bass network, which was
  197.      important for us."
  198.  
  199.  
  200.      Registration Information
  201.  
  202.      The AutoLibrary(tm) Program-Playback tool is distributed as Shareware
  203.      and comes complete in this form.  Registration is 58 dollars and you
  204.      will receive the source code and 3 months of pre-registered support.
  205.  
  206.      For complete user registration information please refer to the
  207.      REGISTER.DOC text file.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.                                                                           4
  222.  
  223.  
  224.  
  225.  
  226.      Author/Publisher Information
  227.  
  228.      Avid Software is a small, privately held, software company owned and
  229.      operated by Wayne McDaniel.
  230.  
  231.      Please feel free to contact me (Wayne McDaniel) if you have any
  232.      questions, comments or suggestions.
  233.  
  234.      Wayne McDaniel                Voice:         (503) 626-6652
  235.      Avid Software                 CompuServe:    70372,2513
  236.      P.O. Box 1871                 Internet:      70372.2513@compuserve.com
  237.      Beaverton, OR 97075-1871
  238.      U.S.A.
  239.  
  240.      Member: Association of Shareware Professionals
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                                                                           5
  277.