home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / CONCPY.ZIP / CONCOPY.DOC next >
Text File  |  1991-01-31  |  7KB  |  151 lines
  1.  
  2.                                 CONCOPY/2 1.00
  3.                                 --------------
  4.  
  5.      CONCOPY/2 is an OS/2 program that duplicates standard output and
  6.      standard error to a disk file.  It is similar in concept to
  7.      redirecting program output to a disk file, except that (1) it
  8.      continues to work until you end it, and (2) you can still see the
  9.      data being sent to the screen.  Thus, you can work interactively
  10.      while CONCOPY is active, yet still maintain a disk record of screen
  11.      activity.
  12.  
  13.      CONCOPY/2 is adapted from CONCOPY, a similar program for DOS by the
  14.      same author.
  15.  
  16.  
  17.      Running CONCOPY/2
  18.      -----------------
  19.      To start copying console output to a file, just type
  20.  
  21.             CONCOPY [d:][path]file[.ext] [command {arguments}]
  22.  
  23.      The optional [command] is discussed in the next section.
  24.  
  25.      Normal usage is quite simple; for example, the command
  26.  
  27.             CONCOPY c:\temp\screen.dat
  28.  
  29.      will copy screen output to a disk file called SCREEN.DAT in directory
  30.      C:\TEMP.  CONCOPY opens the disk file and executes a secondary copy
  31.      of the command shell (normally CMD.EXE); you'll see the OS/2 logo and
  32.      command prompt.  You can then execute as many programs and commands
  33.      as you wish, run batch files, use standard redirection, etc.;
  34.      anything sent to the console using standard OS services will be
  35.      copied to the disk file.
  36.  
  37.      If the specified disk file already exists, the new data will be
  38.      appended to it.
  39.  
  40.      To terminate CONCOPY, type EXIT at the OS/2 command prompt.
  41.  
  42.      CONCOPY affects only the session in which it was started.  If you
  43.      want to use CONCOPY in a separate session, START it from the command
  44.      prompt:
  45.  
  46.             START "concopy" CONCOPY c:\temp\screen.dat
  47.  
  48.      Executing specific commands
  49.      ---------------------------
  50.      If you specify a command on the CONCOPY command line, CONCOPY will
  51.      have CMD.EXE execute that command rather than display a prompt.
  52.      You won't see the OS/2 logo or prompt, and you won't have to type
  53.      EXIT to terminate CONCOPY.  For example:
  54.  
  55.             CONCOPY screen.dat someprog
  56.  
  57.      In this case, CONCOPY will run SOMEPROG (using CMD.EXE) and record
  58.      its screen activity in SCREEN.DAT.  As soon as SOMEPROG ends, CONCOPY
  59.      will also be terminated.
  60.  
  61.      Note in particular that the command can be a batch file.  If you have
  62.      a batch file called BIGBAT.CMD:
  63.  
  64.             CONCOPY screen.dat bigbat
  65.  
  66.      CONCOPY will run BIGBAT.BAT for you and record screen activity.
  67.  
  68.      The use of specific commands allows you to automate the process of
  69.      capturing screen data if it's necessary for you to do this on a
  70.      regular basis.
  71.  
  72.  
  73.      What gets copied to disk
  74.      ------------------------
  75.      CONCOPY will capture any data sent to the console device using
  76.      standard DOS file I/O services.  Both STDOUT (file handle 1) and
  77.      STDERR (file handle 2) are captured.  Like standard output
  78.      redirection, data written using the "Vio" services will not be copied
  79.      to the file.  The general rule is, if output redirection (either > or
  80.      2>) won't work, then CONCOPY won't either.
  81.  
  82.      If any of your programs use ANSI escape sequences to control the
  83.      screen, these control sequences will copied into the file.  If you
  84.      later TYPE the file, the sequences will be re-interpreted by
  85.      ANSI.SYS, duplicating the original effects (screen clearing, color
  86.      changes, cursor movement, etc.).  However, if you use a non-ANSI
  87.      technique to look at the file (text editors, file browsers,, etc.),
  88.      you'll see the ANSI control sequences mixed in with the text.
  89.      Likewise, printing the file may present problems, because your
  90.      printer may try to interpret the ANSI sequences as its own control
  91.      codes.
  92.  
  93.      The file to which the screen data is being copied is continuously
  94.      open while CONCOPY is running.  We suggest that you avoid examining,
  95.      manipulating, or deleting this file while CONCOPY is running; you'll
  96.      probably get a file sharing violation if you try to do so, anyway.
  97.  
  98.  
  99.      Release history
  100.      ---------------
  101.      Version 1.00 - 1/31/91
  102.         Initial release
  103.  
  104.  
  105.      Copyright/License/Warranty
  106.      --------------------------
  107.      This document and the program file CONCOPY.EXE ("the software") are
  108.      copyrighted by the author.  The copyright owner hereby licenses you
  109.      to:  use the software; make as many copies of the program and
  110.      documentation as you wish; give such copies to anyone; and distribute
  111.      the software and documentation via electronic means.  There is no
  112.      charge for any of the above.
  113.  
  114.      However, you are specifically prohibited from charging, or requesting
  115.      donations, for any such copies, however made; and from distributing
  116.      the software and/or documentation with commercial products without
  117.      prior written permission.  An exception is granted to not-for-profit
  118.      user's groups, which are authorized to charge a small fee (not to
  119.      exceed $7) for materials, handling, postage, and general overhead.
  120.      NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO CHARGE ANY AMOUNT FOR
  121.      DISTRIBUTION OF COPIES OF THE SOFTWARE OR DOCUMENTATION, OR TO
  122.      INCLUDE COPIES OF THE SOFTWARE OR DOCUMENTATION WITH SALES OF THEIR
  123.      OWN PRODUCTS.
  124.  
  125.      THIS INCLUDES A SPECIFIC PROHIBITION AGAINST FOR-PROFIT ORGANIZATIONS
  126.      DISTRIBUTING THE SOFTWARE, EITHER ALONE OR WITH OTHER SOFTWARE, AND
  127.      CHARGING A "HANDLING" OR "MATERIALS" FEE OR ANY OTHER SUCH FEE FOR
  128.      THE DISTRIBUTION.  NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO
  129.      INCLUDE THE SOFTWARE ON ANY MEDIA FOR WHICH MONEY IS CHARGED.
  130.  
  131.      There is no restriction on the use of this software in commercial or
  132.      institutional environments.
  133.  
  134.      No copy of the software may be distributed or given away without this
  135.      document; and this notice must not be removed.
  136.  
  137.      There is no warranty of any kind, and the copyright owner is not
  138.      liable for damages of any kind.  By using this free software, you
  139.      agree to this.
  140.  
  141.      The software and documentation are:
  142.  
  143.                              Copyright (C) 1991 by
  144.                             Christopher J. Dunford
  145.                             The Cove Software Group
  146.                                  P.O. Box 1072
  147.                            Columbia, Maryland 21044
  148.  
  149.                                 (301) 992-9371
  150.                         CompuServe 76703,2002 [IBMNET]
  151.