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 >
Wrap
Text File
|
1992-11-27
|
14KB
|
541 lines
SSREPEAT - SS Repeat v1.15 User's Manual
(C) Copyright 1992, Jason M. Spangler and InterThought Software
All Rights Reserved
Preface
(A.K.A. Legal Mumbo-Jumbo)
The term "the author" refers to Jason M. Spangler and InterThought
Software. The term "SS Repeat" refers to the SSREPEAT program and the SS
Repeat documentation, along with any other files included with the original
archive, but not including any files added to the archive by anyone other than
the author.
SS Repeat is not Public Domain and is not free. SS Repeat (TM) is
Copyright (C) 1992 by Jason M. Spangler and InterThought Software. All rights
reserved. SS Repeat and InterThought Software are trademarks of Jason M.
Spangler. The author reserves all rights to these materials, which are
protected under United States and International Copyright Laws. No part of
these materials may be reproduced or modified without the prior express written
permission of the author. Other brand and product names are trademarks or
registered trademarks of their respective holders.
SS Repeat is provided AS IS without any warranty, expressed or implied.
The author is not liable for any damages, whether direct, indirect, special, or
consequential arising from a failure of this program or accompanying files to
operate in a manner desired by the user. The author shall not be liable for
any damage to data or property which may be caused directly or indirectly by
use of this program.
In no event will the author be liable to the user for any damages,
incidental or consequential, arising out of the user's use or misuse of this
program.
The unregistered evaluation version of SS Repeat may be freely distributed
as long as the previous and following provisions are followed:
1. No fee is charged for its use.
2. No fee beyond normal media, duplication, and shipping costs may be
charged.
3. SS Repeat must be distributed in unmodified form, with the following
files contained in the archive: SSR115.DOC, SSREPEAT.EXE,
SSRFILES.SSR, SSRRGSTR.FRM, and WORSTNM.EXE.
4. Shareware vendors and computer user groups which charge less than
$7.00 per disk may distribute SS Repeat, but the author must be
supplied with a copy of the first catalog issue offering each new
revision of SS Repeat.
5. BBS SysOps of both pay access and free access systems are free to
distribute SS Repeat as long as all of the above stated files are
contained in the archive and all previous provisions are followed.
SS Repeat v1.15 Preface i
6. Others may only distribute SS Repeat for a fee with the written
permission of the author. In all cases, it must be clearly stated
to the purchaser that he or she is receiving an unregistered copy of
a shareware product.
If you use SS Repeat beyond the 30 day trial period, you must according to
law pay for and register the program using the accompanying order form. If you
do not pay for and register the program, you must cease usage of SS Repeat
until you pay for and register it.
For the $10.00 registration fee, you will receive the current, registered
version of SS Repeat. You will be notified of significant upgrades to SS
Repeat, and you will be placed on a mailing list to receive information about
future products from InterThought Software.
Registered users are entitled to updates for a nominal fee (around $5.00).
Registered users are also entitled to obtain registered versions of other
InterThought Software at a special reduced price.
Shareware works because authors and users both believe in the system.
Please do your part and register SS Repeat if you use it beyond the thirty day
evaluation period; register your copy!
----------------------------Registered Version------------------------------
The above license statement does not apply to the REGISTERED version
of SS Repeat. The registered software of InterThought Software is
protected under United States Copyright and Trademark Laws. It
must be treated just like a book with certain exceptions as follows:
A. The author authorizes the making of archival copies of the
registered software for the sole purpose of backing-up your software
and protecting your investment from possible loss.
B. The medium on which the registered software is recorded is
transferred to the customer, but not the title to the software.
C. The customer may resell or distribute unmodified copies of the
registered software provided the customer has purchased from
the author one copy of the registered software for each one sold
or distributed. The provisions of this software license shall also
be applicable to third parties receiving copies of the registered
software from the customer.
SS Repeat v1.15 Preface iii
D. By saying, "just like a book", the author means that the registered
software may be used by any number of people and may be freely moved
from one computer location to another so long as there is ABSOLUTELY
NO POSSIBILITY of it being used at one location while being used at
another. Just like a book that cannot be read by two different
people in two different locations at the same time.
Site License
If you plan on using SS Repeat in a corporate, government office, or in
any business environment whatsoever, registration is mandatory and
the thirty day limited license is strictly enforced. For such users,
quantity discounts are available under a Site License agreement.
To obtain information about or purchase a site license, contact the
author at the following address:
InterThought Software
c/o Jason Spangler
45611 McHenry Rd.
Glenmoor, OH 43920-3984
SS Repeat v1.15 Preface iv
Table of Contents
Preface ................................................................... i
Introduction and Requirements ............................................. 1
SS Repeat ................................................................. 2
Function ............................................................. 2
Command Line Parameters .............................................. 2
Error Messages ....................................................... 4
Revision History and Information .......................................... 5
SS Repeat v1.15 Preface v
Introduction and Requirements
SS Repeat is a utility which will scan for files matching specified search
arguments, and will execute a specified command file, replacing certain
variables in each command line with either the found full file name, file name,
file extension, or other miscellaneous data, for each file found matching each
search argument. This is useful in batch processing, such as system events on
bulletin board systems, and for executing the same instruction on a large
amount of files.
SS Repeat requires 256kb of conventional DOS memory and DOS 3.0 or later.
A hard drive is highly recommended.
SS Repeat v1.15 Introduction and Requirements 1
SSREPEAT - SS Repeat
Function
Command Line Parameters
Usage: SSREPEAT switches search_argument [search_arguments] command_file
The following switches are usable:
/q Quiet mode - SSREPEAT will not display any output
/b BIOS video - SSREPEAT will use the BIOS screen output routines
/? Help Display - SSREPEAT will display its help screen
The search_argument and optional multiple [search_arguments] are standard
DOS search arguments, such as "*.ZIP" or "??.IDX". SS Repeat will use these
search arguments to find any files to execute the command file on.
The command file is a standard ASCII file containing normal DOS commands or
programs to execute. In this file, however the following parameters will be
replaced with the data specified:
%N will be replaced with the found file's full file name, such as
"SSR115.ARJ"
%F will be replaced with the found file's file name, such as
"SSR115"
%E will be replaced with the found file's extension, such as
"ARJ"
%A will be replaced with the search argument number currently
being used
%B will be replaced with the command number from the command file
currently being used
%C will be replaced with the file number of the current file
found matching the current search argument
%D will be replaced with the overall file number currently being
used
For example, if the command file CMDFILE.CMD contains the following
commands:
ARJ A %F %N
DEL %N
And the current directory contained the files RBT315.DAT and SSR115.DAT,
and the command line "SSREPEAT *.DAT CMDFILE.CMD" was executed, then the
following commands would be executed:
ARJ A RBT315 RBT315.DAT
DEL RBT315.DAT
ARJ A SSR115 SSR115.DAT
DEL SSR115.DAT
SS Repeat v1.15 SS Repeat 2
Batch processing like the above example can be helpful to BBS sysops who
wish to add an "readme" file to each file in a new upload directory, or to
people who need to compress a large amount of files into individual archives.
Notes
(1) - Help display overrides Quiet mode.
(2) - All except the last non-switch arguments on the command line are
assumed to be search arguments.
(3) - The last non-switch argument on the command line is assumed to be the
command file.
SS Repeat v1.15 SS Repeat 3
SSREPEAT - SS Repeat
Error Messages
(1) - Invalid switch
An invalid switch was specified on the command line.
(2) - Search Argument and/or Command File not defined
At least one search argument, and only one command file must be
specified on the command line.
(3) - Command file not found
The specified command file could not be found.
(4) - Command file is a zero byte file.
The command file specified is a zero byte file, which has no commands
to execute.
(5) - Can not open command file
DOS reported that the command file could not be opened.
(6) - Command line returned an error
The executed command line returned an error.
SS Repeat v1.15 SS Repeat Error Messages 4
Revision History and Information
Version: 1.00 First version, not released
1.10 Fixed "wouldn't read last character of command file" bug
1.15 Added %A through %D command arguments
I can be contacted through:
Modem: Your Worst Nightmare BBS (216) 227-2172
WishNet: 19:232/103
Home of RBT! Get the
latest InterThought
Software!
Lincoln School BBS (216) 424-1003
Systems Plus BBS (216) 385-3278
Internet: jspangler%ksuvxl@ksuvxa.kent.edu
DECNet: jspangler@ksuvxl
U.S. Mail: InterThought Software
c/o Jason M. Spangler
45611 McHenry Road
Glenmoor, OH 43920-3984
Suggestions and/or additional donations are welcome! (Compilers and
books cost money!) By the way, I'm seventeen years old, and I've also written
RBT - ReBooT, a utility which allows you to switch between multiple sets of
AUTOEXEC.BAT and CONFIG.SYS files. Contact me at the above address for more
information.
SS Repeat was written using Turbo C++, portions (C) Copyright Borland
International. Call Your Worst Nightmare BBS and drop me a line (My handle is
Markus).
SS Repeat v1.15 Revision History and Information 5