home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / s / ssr115.zip / SSR115.DOC < prev    next >
Text File  |  1992-11-27  |  14KB  |  541 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                    SSREPEAT  -  SS Repeat v1.15 User's Manual
  29.  
  30.         (C) Copyright 1992, Jason M. Spangler and InterThought Software
  31.  
  32.                               All Rights Reserved
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                                                              
  54.  
  55.                                    Preface
  56.                            (A.K.A. Legal Mumbo-Jumbo)
  57.  
  58.  
  59.     The term "the author" refers to Jason M. Spangler and InterThought
  60. Software.  The term "SS Repeat" refers to the SSREPEAT program and the SS
  61. Repeat documentation, along with any other files included with the original
  62. archive, but not including any files added to the archive by anyone other than
  63. the author.
  64.  
  65.      SS Repeat is not Public Domain and is not free.  SS Repeat (TM) is 
  66. Copyright (C) 1992 by Jason M. Spangler and InterThought Software.  All rights 
  67. reserved.  SS Repeat and  InterThought Software are trademarks of Jason M. 
  68. Spangler.  The author reserves all rights to these materials, which are 
  69. protected under United States and International Copyright Laws.  No part of 
  70. these materials may be reproduced or modified without the prior express written
  71. permission of the author.  Other brand and product names are trademarks or 
  72. registered trademarks of their respective holders.
  73.  
  74.      SS Repeat is provided AS IS without any warranty, expressed or implied.  
  75. The author is not liable for any damages, whether direct, indirect, special, or
  76. consequential arising from a failure of this program or accompanying files to
  77. operate in a manner desired by the user.  The author shall not be liable for
  78. any damage to data or property which may be caused directly or indirectly by
  79. use of this program.
  80.  
  81.      In no event will the author be liable to the user for any damages,
  82. incidental or consequential, arising out of the user's use or misuse of this
  83. program.
  84.  
  85.      The unregistered evaluation version of SS Repeat may be freely distributed
  86. as long as the previous and following provisions are followed:
  87.  
  88.      1.   No fee is charged for its use.
  89.  
  90.      2.   No fee beyond normal media, duplication, and shipping costs may be
  91.           charged.
  92.  
  93.      3.   SS Repeat must be distributed in unmodified form, with the following
  94.           files contained in the archive:  SSR115.DOC, SSREPEAT.EXE,
  95.           SSRFILES.SSR, SSRRGSTR.FRM, and WORSTNM.EXE.
  96.  
  97.      4.   Shareware vendors and computer user groups which charge less than
  98.           $7.00 per disk may distribute SS Repeat, but the author must be       
  99.           supplied with a copy of the first catalog issue offering each new
  100.           revision of SS Repeat.
  101.  
  102.      5.   BBS SysOps of both pay access and free access systems are free to
  103.           distribute SS Repeat as long as all of the above stated files are
  104.           contained in the archive and all previous provisions are followed.
  105.  
  106.  
  107.  
  108.    SS Repeat v1.15                  Preface                                  i
  109.  
  110.  
  111.  
  112.       6.   Others may only distribute SS Repeat for a fee with the written
  113.            permission of the author.  In all cases, it must be clearly stated 
  114.            to the purchaser that he or she is receiving an unregistered copy of
  115.            a shareware product.
  116.  
  117.     If you use SS Repeat beyond the 30 day trial period, you must according to
  118. law pay for and register the program using the accompanying order form.  If you
  119. do not pay for and register the program, you must cease usage of SS Repeat
  120. until you pay for and register it.
  121.  
  122.     For the $10.00 registration fee, you will receive the current, registered
  123. version of SS Repeat.  You will be notified of significant upgrades to SS
  124. Repeat, and you will be placed on a mailing list to receive information about
  125. future products from InterThought Software.
  126.  
  127.     Registered users are entitled to updates for a nominal fee (around $5.00).
  128. Registered users are also entitled to obtain registered versions of other
  129. InterThought Software at a special reduced price.
  130.  
  131.     Shareware works because authors and users both believe in the system.
  132. Please do your part and register SS Repeat if you use it beyond the thirty day
  133. evaluation period;  register your copy!
  134.  
  135.  
  136.   ----------------------------Registered Version------------------------------
  137.  
  138.        The above license statement does not apply to the REGISTERED version
  139.        of SS Repeat.  The registered software of InterThought Software is
  140.        protected under United States Copyright and Trademark Laws.  It
  141.        must be treated just like a book with certain exceptions as follows:
  142.  
  143.        A. The author authorizes the making of archival copies of the
  144.           registered software for the sole purpose of backing-up your software
  145.           and protecting your investment from possible loss.
  146.  
  147.        B. The medium on which the registered software is recorded is
  148.           transferred to the customer, but not the title to the software.
  149.  
  150.        C. The customer may resell or distribute unmodified copies of the
  151.           registered software provided the customer has purchased from
  152.           the author one copy of the registered software for each one sold
  153.           or distributed.  The provisions of this software license shall also
  154.           be applicable to third parties receiving copies of the registered
  155.           software from the customer.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.   SS Repeat v1.15                   Preface                                iii
  163.  
  164.        D. By saying, "just like a book",  the author means that the registered
  165.           software may be used by any number of people and may be freely moved
  166.           from one computer location to another so long as there is ABSOLUTELY
  167.           NO POSSIBILITY of it being used at one location while being used at
  168.           another.  Just like a book that cannot be read by two different
  169.           people in two different locations at the same time.
  170.  
  171.                                   Site License
  172.  
  173.        If you plan on using SS Repeat in a corporate, government office, or in
  174.        any business environment whatsoever, registration is mandatory and
  175.        the thirty day limited license is strictly enforced.  For such users,
  176.        quantity discounts are available under a Site License agreement.
  177.  
  178.        To obtain information about or purchase a site license, contact the
  179.        author at the following address:
  180.  
  181.                                 InterThought Software
  182.                                 c/o Jason Spangler
  183.                                 45611 McHenry Rd.
  184.                                 Glenmoor, OH 43920-3984
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.   SS Repeat v1.15                   Preface                                 iv
  217.                                Table of Contents
  218.  
  219. Preface ................................................................... i
  220.  
  221. Introduction and Requirements ............................................. 1
  222.  
  223. SS Repeat ................................................................. 2
  224.      Function ............................................................. 2
  225.      Command Line Parameters .............................................. 2
  226.      Error Messages ....................................................... 4
  227.  
  228. Revision History and Information .......................................... 5
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  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.  SS Repeat v1.15                   Preface                                 v
  271.                         Introduction and Requirements
  272.  
  273.     SS Repeat is a utility which will scan for files matching specified search 
  274. arguments, and will execute a specified command file, replacing certain
  275. variables in each command line with either the found full file name, file name,
  276. file extension, or other miscellaneous data, for each file found matching each
  277. search argument.  This is useful in batch processing, such as system events on
  278. bulletin board systems, and for executing the same instruction on a large
  279. amount of files.
  280.     SS Repeat requires 256kb of conventional DOS memory and DOS 3.0 or later.
  281. A hard drive is highly recommended.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  SS Repeat v1.15          Introduction and Requirements                   1
  325.                               SSREPEAT - SS Repeat
  326.  
  327.                                    Function
  328.  
  329.  
  330.                            Command Line Parameters
  331.  
  332.     Usage: SSREPEAT switches search_argument [search_arguments] command_file
  333.  
  334.     The following switches are usable:
  335.  
  336.              /q  Quiet mode - SSREPEAT will not display any output
  337.              /b  BIOS video - SSREPEAT will use the BIOS screen output routines
  338.              /?  Help Display - SSREPEAT will display its help screen
  339.  
  340.     The search_argument and optional multiple [search_arguments] are standard
  341. DOS search arguments, such as "*.ZIP" or "??.IDX".  SS Repeat will use these
  342. search arguments to find any files to execute the command file on.
  343.  
  344.     The command file is a standard ASCII file containing normal DOS commands or
  345. programs to execute.  In this file, however the following parameters will be
  346. replaced with the data specified:
  347.  
  348.               %N will be replaced with the found file's full file name, such as
  349.                  "SSR115.ARJ"
  350.               %F will be replaced with the found file's file name, such as
  351.                  "SSR115"
  352.               %E will be replaced with the found file's extension, such as
  353.                  "ARJ"
  354.               %A will be replaced with the search argument number currently
  355.                  being used
  356.               %B will be replaced with the command number from the command file
  357.                  currently being used
  358.               %C will be replaced with the file number of the current file
  359.                  found matching the current search argument
  360.               %D will be replaced with the overall file number currently being
  361.                  used
  362.  
  363.     For example, if the command file CMDFILE.CMD contains the following
  364. commands:
  365.  
  366.               ARJ A %F %N
  367.               DEL %N
  368.  
  369.     And the current directory contained the files RBT315.DAT and SSR115.DAT,
  370. and the command line "SSREPEAT *.DAT CMDFILE.CMD" was executed, then the
  371. following commands would be executed:
  372.  
  373.               ARJ A RBT315 RBT315.DAT
  374.               DEL RBT315.DAT
  375.               ARJ A SSR115 SSR115.DAT
  376.               DEL SSR115.DAT
  377.  
  378.  SS Repeat v1.15                   SS Repeat                              2
  379.  
  380.     Batch processing like the above example can be helpful to BBS sysops who
  381. wish to add an "readme" file to each file in a new upload directory, or to
  382. people who need to compress a large amount of files into individual archives.
  383.  
  384.  
  385.  
  386.                                      Notes
  387.  
  388.     (1) - Help display overrides Quiet mode.
  389.  
  390.     (2) - All except the last non-switch arguments on the command line are
  391.           assumed to be search arguments.
  392.  
  393.     (3) - The last non-switch argument on the command line is assumed to be the
  394.           command file.
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  SS Repeat v1.15                   SS Repeat                              3
  433.  
  434.                               SSREPEAT - SS Repeat
  435.  
  436.                                 Error Messages
  437.  
  438.      (1)  -  Invalid switch
  439.  
  440.           An invalid switch was specified on the command line.
  441.  
  442.      (2)   -  Search Argument and/or Command File not defined
  443.  
  444.           At least one search argument, and only one command file must be
  445.           specified on the command line.
  446.  
  447.      (3)   -  Command file not found
  448.  
  449.           The specified command file could not be found.
  450.  
  451.      (4)   -  Command file is a zero byte file.
  452.  
  453.           The command file specified is a zero byte file, which has no commands
  454.           to execute.
  455.  
  456.      (5)   -  Can not open command file
  457.  
  458.           DOS reported that the command file could not be opened.
  459.  
  460.      (6)   -  Command line returned an error
  461.  
  462.           The executed command line returned an error.
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  SS Repeat v1.15          SS Repeat Error Messages                        4
  487.  
  488.                        Revision History and Information
  489.  
  490.  
  491.      Version:  1.00   First version, not released
  492.                1.10   Fixed "wouldn't read last character of command file" bug
  493.                1.15   Added %A through %D command arguments
  494.  
  495.  
  496.      I can be contacted through:
  497.  
  498.           Modem:      Your Worst Nightmare BBS  (216) 227-2172
  499.                         WishNet: 19:232/103
  500.                         Home of RBT!  Get the
  501.                         latest InterThought
  502.                         Software!
  503.                       Lincoln School BBS        (216) 424-1003
  504.                       Systems Plus BBS          (216) 385-3278
  505.  
  506.           Internet:   jspangler%ksuvxl@ksuvxa.kent.edu
  507.  
  508.           DECNet:     jspangler@ksuvxl
  509.  
  510.           U.S. Mail:  InterThought Software
  511.                       c/o Jason M. Spangler
  512.                       45611 McHenry Road
  513.                       Glenmoor, OH 43920-3984
  514.  
  515.     Suggestions and/or additional donations are welcome! (Compilers and
  516. books cost money!)  By the way, I'm seventeen years old, and I've also written
  517. RBT - ReBooT, a utility which allows you to switch between multiple sets of
  518. AUTOEXEC.BAT and CONFIG.SYS files.  Contact me at the above address for more
  519. information.
  520.     SS Repeat was written using Turbo C++, portions (C) Copyright Borland
  521. International.  Call Your Worst Nightmare BBS and drop me a line (My handle is
  522. Markus).
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  SS Repeat v1.15         Revision History and Information                 5
  541.