MxREPEAT 3.02. Automates virus scanning
using McAfee Associates VIRUSCAN program.
** VERY useful on LANs. ** Scanning is
accomplished using a user defined Date or
Time interval. FREEWARE for personal,
non-commercial use. EVALUATION COPY for
commercial and/or business use. Information
and documentation included for both MxREPEAT
and M-REPEAT (the registered, customizable
version).

M-REPEAT Program Group
Version 3.x
Copyright 1993 by DATACHIP
ALL RIGHTS RESERVED
JUNE 1993







DATACHIP
6618 Maryland Avenue
Hammond, Indiana 46323
Compuserve [74720,224]



M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



INDEX


DESCRIPTION PAGE
----------------------------------------------------------------

I. Overall Description ..................................... 3.


II. License and Registration................................ 3.


III. THE M-REPEAT and MxREPEAT Programs..................... 3.


IV. F-REPEAT and MxREPEAT Command Line Parameters.......... 4.


V. Custom Error Screens using the MERROR Program............ 7.


VI. System Checkout using the M-CHKOUT Program.............. 7.


VII. Quick TIME/DATE Interval Checking using M-CHK.......... 8.


VIII. Networking Suggestions................................ 9.


IX. Ordering Information.................................... 10.


X. Warranty................................................ 12.




APPENDIX I. M-REPEAT/MxREPEAT Default Screens.............. 13.


APPENDIX II. M-REPEAT/MxREPEAT Errorlevels................. 15.


APPENDIX III. M-CHK Display Screens........................ 16.







Page 2.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------


I. OVERALL DESCRIPTION
-----------------------

BACKGROUND
The M-REPEAT program group is a group of programs to automate and manage virus
scanning using McAfee Associates' VIRUSCAN program (SCAN.EXE). M-REPEAT can
be used on both stand-alone as well as networked personal computers.
The M-REPEAT program will run the SCAN.EXE program to scan for viruses if a
specified time/date interval has been exceeded. M-REPEAT is NOT a TSR. It is
a shell for the SCAN program.

MxREPEAT.EXE is the shareware version of the main program. M-REPEAT.EXE is
the registered version of the main program. They are identical EXCEPT the
error screens and keyboard actions can only be customized in the M-REPEAT
version. In this manual, MxREPEAT and M-REPEAT are used interchangeably
except when discussing custom error screens and keyboard actions.

Additional programs provided include:
MERROR.EXE (M-REPEAT only) used to generate custom error screens.
M-CHKOUT.EXE used to checkout the operation of M-REPEAT.
M-CHK.EXE used to quickly check if a virus scan is needed.



II. Licensing and Registration
------------------------------

The MxREPEAT and support programs consisting of M-CHKOUT.EXE, M-CHK.EXE and
the documentation files may be used free of charge by anyone on their own
personally owned computer. The computer must not be used for any commercial
and/or business purpose. These programs may be used for evaluation during a
single 30 day evaluation period on any computer and/or computer system used
for commercial and/or business purposes.

For use continued use in a government, commercial and/or business system, this
software must be registered. Registration provides additional features for
customizing displays and keyboard actions. These features are not available
with the unregistered version.

See Section IX. ORDERING INFORMATION for more details on registering this
software.



III. The M-REPEAT and MxREPEAT Programs
---------------------------------------

M-REPEAT is a program that executes the virus scanning program SCAN.EXE
based on a time or date interval passed as a command line parameter. The date
and time of the last successful scan is encrypted and stored in a Log File.



Page 3.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



When M-REPEAT is run, a command line interval parameter determines how often
M-REPEAT calls the SCAN program to check for viruses. If the command line
interval is greater than the difference between the present time/date and the
last time/date the personal computer was successfully scanned, the M-REPEAT
program will exit without running SCAN. A zero errorlevel will be returned by
M-REPEAT.

If the time/date difference is greater than the command line parameter,
M-REPEAT runs the SCAN program. When the SCAN program completes scanning, it
returns an errorlevel to the M-REPEAT program. If the errorlevel returned is
zero (successful completion of SCAN with no viruses detected), the M-REPEAT
program updates the time/date in the Log File then exits with an errorlevel of
zero. If the errorlevel returned by SCAN is not zero, M-REPEAT displays an
appropriate error screen and sets a predetermined keyboard condition. When
M-REPEAT exits, it returns the same errorlevel as returned by SCAN.

Only the error screens and keyboard actions for M-REPEAT can be customized.
This customized information is contained in the M-REPEAT.SCR file. This file
must be in the same directory as M-REPEAT.

The MxREPEAT program does not have an option for custom error screens.

Some default error screens and keyboard actions for both M-REPEAT and MxREPEAT
are listed in APPENDIX I.



IV. M-REPEAT Command Line Parameters
------------------------------------

The command line for M-REPEAT is:

M-REPEAT AAA BBB /C-DDDD EEE EEE EEE

where:
AAA is the full path to the SCAN program. The path does not have
to specify the SCAN program itself.

EXAMPLE: M-REPEAT C:\VIRUS where SCAN is in the
C:\VIRUS\ directory.

NOTE: If the SCAN.EXE program and related files are located in the
same directory as M-REPEAT, only SCAN has to be specified
for AAA.

EXAMPLE: M-REPEAT SCAN where SCAN.EXE is in the same directory
as M-REPEAT.





Page 4.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



BBB is optional. If included, it is the path or path and file name
of the Log File. If the path but not the Log File name is given,
a Log File named SCAN.!LG will be used in the path specified.
If the path and Log File are both not included in the command line,
M-REPEAT will access or create a new Log File in the current
directory named SCAN.!LG.

EXAMPLE: M-REPEAT C:\VIRUS C:\SCAN.!LG where C:\SCAN.!LG
is the log file.

EXAMPLE: M-REPEAT C:\VIRUS C:\NEW where C:\NEW\SCAN.!LG is
the log file IF directory C:\NEW exists. If directory
C:\NEW does not exist, C:\NEW is the log file.


C is the time/date parameter T or D. T is used to specify a time
interval and D is used to specify a date interval.


DDD is the time or date interval parameter. SCAN will be called
only if the time or date interval parameter has been exceeded.

If the T time/date parameter is specified, the minimum time
between the SCAN scans is given in hours and minutes (minutes
are optional).

EXAMPLE: /T-12:32 means that at least 12 hours and 32 minutes
must pass before SCAN is called again.

If the D time/date parameter is used, the interval is specified in
days:

EXAMPLE: /D-2 means at least 2 calendar days must pass before
SCAN is called again.


NOTE: /D-1 and /T-24 are not the same. /D-1 will execute SCAN
the first time M-REPEAT is executed on a new calendar day.
However, /T-24 will execute SCAN only after a minimum
24 hour interval has elapsed.

Specifying a time or date interval of 0 will result in
SCAN being called each and every time M-REPEAT is run.

When using the /T parameter, the SCAN program will be called
automatically if the workstation's time/date is earlier than
the time/date in the log file. When using the /D parameter,
only the workstation date is compared to the log file date.




Page 5.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------

EEE represents the command line parameters to be passed to the SCAN
virus scanning program.

Each parameter passed to the SCAN program must be separated by
a space on the command line. See the SCAN program documentation
for aid in choosing the desired SCAN parameters.

NOTE: DOS limits the maximum command line length that can be parsed.
Use of environmental variables on the command line can increase the
maximum effective command line length.

EXAMPLES:

M-REPEAT C:\SCANNING /D-0 /AD

SCAN.EXE is in the C:\SCANNING directory.
The log file is SCAN.!LG in the current directory.
The program SCAN.EXE program will be executed each time
the M-REPEAT program is run. All local drives will be
scanned.


M-REPEAT C:\SCANNER C:\ /D-1 E: /REPORT=C:\SCAN.RPT

SCAN.EXE is in the C:\SCANNER directory.
The log file name is C:\SCAN.!LG.
SCAN will scan the first time M-REPEAT is run on a new
calendar day.
E: drive will be scanned a report written to the file
C:\SCAN.RPT.


M-REPEAT SCAN F:\SCAN.LOG /T-5:2 D:

SCAN will be executed from the current directory.
The Log File name is F:\SCAN.LOG.
SCAN will scan the first time M-REPEAT is run after 5
hours and 2 minutes have elapsed since the successful scan.


M-REPEAT SCAN F:\SCAN.LOG /T-5:2 %ABC%

Same as above except the environmental variable ABC contains
the parameters to be passed to SCAN.


M-REPEAT or M-REPEAT ?

Either of these commands or a command line error will
display the M-REPEAT help screens.




Page 6.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



V. Generating Custom Error Screens with MERROR.EXE
----------------------------------------------------
(M-REPEAT ONLY OPTION)

Custom error screens and keyboard actions are contained in the M-REPEAT.SCR
file. This file must be in the same directory as the M-REPEAT.EXE program.

The MERROR.EXE program is used to create, modify and delete custom error
screens and keyboard actions in the M-REPEAT.SCR file.

Using MERROR, an error screen can be created for each errorlevel returned by
the SCAN program. An additional error screen can be created for all other
non-zero errorlevels.

In addition to displaying error screens, the following keyboard conditions can
be programmed for any errorlevel:
1. Pause until a key is pressed,
2. Lock the keyboard (requires a reboot to unlock) or
3. Normal keyboard condition (no pauses or lock-ups).

An audible alarm can also be programmed for any non-zero errorlevel.

Use of MERROR is straight forward. Context sensitive help is available by
pressing the key.



VI. SYSTEM CHECKOUT USING THE M-CHKOUT PROGRAM
----------------------------------------------

A special program, M-CHKOUT.EXE, is supplied to checkout the operation
of M-REPEAT. During checkout, M-CHKOUT.EXE is automatically executed instead
of SCAN.EXE. When this occurs, a special screen is displayed requesting the
user to input an errorlevel (0 to 255) which will be returned to M-REPEAT. By
inputting all possible values for errorlevels returned by SCAN, the actions of
M-REPEAT can be verified.

To use M-CHKOUT.EXE, first copy it to the same directory as the M-REPEAT
program. Next, run M-REPEAT with the command line desired. If a Log File
name is not specified on the M-REPEAT command line, the log file name will be
M-CHKOUT.!LG.

After checkout has been completed, removed M-CHKOUT.EXE from the directory
containing M-REPEAT. Also, if no Log File was specified, delete the
M-CHKOUT.!LG file.







Page 7.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



VII. Quick TIME/DATE Interval Checking using M-CHK
--------------------------------------------------

The M-CHK.EXE program can be used in Menu scripts to "quickly" check if a
virus scan is needed. The M-CHK program contains only minimal error checking.

The command line form for M-CHK is:

M-CHK AAA /B-CCC
where:

AAA is the path and filename of the Log File.

EXAMPLE: M-CHK C:\SCAN\SCAN.!LG
The log file name is C:\SCAN\SCAN.!LG


B is the date/time parameter T or D. T designates a time interval and
D designates a date interval.


CCC is the time or date interval.

EXAMPLE: M-CHK C:\SCAN\SCAN.!LG /T-02:03
The log file name is C:\SCAN\SCAN.!LG.
The time interval is 2 hours and 3 minutes.

EXAMPLE: M-CHK C:\SCAN\SCAN.!LG /D-3
The log file name is C:\SCAN\SCAN.!LG.
The date interval is 3 days.


If the date\time interval since the last successful scan has not been
exceeded, M-CHK will return an errorlevel of zero. If the interval has been
exceeded, an errorlevel of one will be returned. If the Log File does not
exist or there is an error level in the command line, an errorlevel of one
will be returned.

When M-CHK exits, short status messages are displayed. To prevent these
messages from being displayed the output can be redirected to the DOS NUL
file.

EXAMPLE: M-CHK C:\SCAN.!LG /D-1 >NUL









Page 8.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



VIII. Networking Suggestions
----------------------------

Suggestion 1: Require each workstation to be scanned for viruses every 4
days before normal network activities are permitted.

Solution: Place SCAN and the M-REPEAT programs in a network directory. Give
normal users only Read and Find rights in the directory. When logging into
the network, have the workstation execute M-REPEAT using a command line like:

F:\VRSCAN\M-REPEAT F:\VRSCAN\SCAN C:\SCAN.!LG /D-4 /HARD /REPORT=C:\SCAN.RPT

This command line will use the C:\SCAN.!LG Log File and cause SCAN to be scan
all the workstation hard disks every 4 days. In this example, the SCAN
programs and the M-REPEAT.EXE and M-REPEAT.SCR files are in the F:\VRSCAN
directory. A scan report will be written to the C:\SCAN.RPT file. The
keyboard options can be programmed using MERROR to lock the keyboard for any
non-zero errorlevel. This will effectively keep any non-scanned workstation
from logging into the network and not scanning for viruses.

On a Novell network, the M-REPEAT.EXE file can also be given the Only> attribute. This helps prevent any changes to the program by a user with
supervisor rights.


If this M-REPEAT command line is executed on all file servers, logging into a
new file server will not require re-scanning. The same Log File on the
workstation hard disk is used when logging into any of the file servers.

Suggestion 2: Incorporate the M-CHK.EXE program into the network menuing
scripts. Example:

M-CHK C:\SCAN.!LG /d-4 >NUL
IF ERRORLEVEL 1 GOTO SCAN
GOTO CONTINUE
:SCAN
F:\VRSCAN\M-REPEAT F:\VRSCAN\SCAN C:\SCAN.!LG /D-4 /HARD /REPORT=C:\SCAN.RPT
:CONTINUE

A non-zero errorlevel will be returned if more than 4 days have elapsed since
the last successful virus scan. This will cause M-REPEAT to call SCAN as
explained in Suggestion 1.

Suggestion 3: If the command line becomes too long for DOS to parse, use
environmental variables to increase the effective line length that can be
parsed.







Page 9.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



IX. Ordering Information
------------------------

No registration of MxREPEAT is required for personal use. After a 30 day
evaluation period, registration is required for all commercial, government,
or business use.

Upon registration of MxREPEAT, the USER will receive:

(1) M-REPEAT - A customized version of MxREPEAT which permits user
customized error code screens and keyboard conditions to
be programmed for different SCAN conditions.

(2) MERROR - A program to customize the error code screens and keyboard
conditions.

(3) M-CHKOUT - A program that can be used to temporarily checkout and test
the actions of M-REPEAT as configured by the user.

(4) M-CHK - A program that can be used in LAN Menus to "quickly" check
if the Log File encrypted Time/Date has expired.

(5) M-REPEAT.SCR - A collection of suggested error code screens for the

the user's reference.

(6) Documentation in both WordPerfect 5.1 for DOS and an ASCII text file
format as well as a printout of the WordPerfect file.

IN ADDITION, the next major program upgrade will be provided free.
Details on additional upgrades will be provided to registered users.


PRICING INFORMATION
(Prices valid through 1993. Write or eMail for pricing after 1993.)

$50 per each 250 user or less LAN File Server with no restrictions on
the number of concurrent program users on the LAN.

$90 for each LAN file servers with more than 250 concurrent users.

$1 per Personal Computer in other installations with a minimum of $50.

$225 for an unlimited site-license of the M-REPEAT program group.

$350 for an unlimited site-license of the F-REPEAT, M-REPEAT, L-REPEAT
and REPEATIT program groups. These programs are for use with the
copyrighted programs F-PROT by Frisk International, VIRUSCAN by
McAfee Associates, LPScan by INTEL Corporation and for generic
programs, respectively. This includes use on both LANs and
stand-alone computers at a single physical site.


Page 10.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------
To register, please fill out the information requested below:

From: Name:_____________________________________________________________

(Title):__________________________________________________________

Company:__________________________________________________________

Address:__________________________________________________________

City, State, Zip Code:____________________________________________

Country:__________________________________________________________

Phone Number:__(____)_____________________________________________

Licensed to:______________________________________________________
(suggested license display when running program.)

Today's Date:_______________________


(Prices valid through 1993. Write or eMail for pricing after 1993.)

M-REPEAT for use on a 250 user or less File Server $50.__________

M-REPEAT for use on a greater than 250 user File Server $90.__________

M-REPEAT for use on a personal computer ($1 per Personal
Computer with a minimum of $50.) __________

M-REPEAT unlimited site-license $225 __________

Unlimited site-license package of the F-REPEAT,
M-REPEAT, L-REPEAT and REPEATIT program groups $350 __________

Indiana residents add 5% sales tax __________


TOTAL ENCLOSED: ___________________

Diskette format (choose one):

5.25" 1.2 meg disk ____

3.5" 720K disk ____

3.5" 1.44 meg disk ____

Payment Terms: Check or Money Order.

Mail to: DATACHIP
6618 Maryland Avenue
Hammond, IN 46323

Page 11.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



X. Warranty
-----------

Datachip warrants that the physical diskettes and documentation enclosed
to be free of defects in materials and workmanship for a period of sixty days
from date of purchase. In event of a defect in material or workmanship during
the warranty period, Datachip will replace the defective diskette(s) or
documentation.

Datachip will not be liable for any special, incidental, consequential,
indirect or similar damages, even if Datachip has been advised of the possibly
of such damages. In no event will Datachip's liability for any damages ever
exceed the price paid for the license to use software, regardless of the form
of the claim.


For customer support, contact DATACHIP on Compuserve (address [74720,224]) or
write to:

DATACHIP
6618 Maryland Avenue
Hammond, Indiana 46323










NOTE: The Viruscan program also referred to in this document as SCAN and
SCAN.EXE are copyrighted programs by McAfee Associates.


















Page 12.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------

APPENDIX I. M-REPEAT DEFAULT SCREENS
------------------------------------

The following are the default screens for common M-REPEAT errors and
conditions (the MxREPEAT screens are same except replace all occurrences of M-
REPEAT with MxREPEAT).


A. ERROR: Incorrect directory for SCAN.EXE program.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
ERROR ERROR ERROR ERROR ERROR
The directory \VIRUS could not be found.
Please check the command line parameters.
Please contact your PC or LAN Manager.

Press any key to continue.
--------------------------------------------------------------------------------




B. ERROR: Incorrect drive letter for SCAN.EXE or Log File location.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
ERROR ERROR ERROR ERROR ERROR
There is no P: drive. Please check the command line parameters.
Please contact your PC or LAN Manager.

Press any key to continue.
--------------------------------------------------------------------------------




C. ERROR: Date or Time interval too large (overflow).

DISPLAY MESSAGE
--------------------------------------------------------------------------------
##############################################################################
The M-REPEAT program has aborted!

The M-REPEAT program was incorrectly called with the following command line:
M-REPEAT C:\VIRUS C:\ /D-9999999999 C:\DOS /AD
The Date\Time Integer is too large a number...........
##############################################################################
# #
# To clear this display, press . #
# Press any other key to display the M-REPEAT Help Screens. #
# #
##############################################################################
--------------------------------------------------------------------------------
Page 13.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



D. ERROR: The M-REPEAT.SCR file is not in the same directory as M-REPEAT (This
message is for M-REPEAT only).

DISPLAY MESSAGE
--------------------------------------------------------------------------------
ERROR ERROR ERROR ERROR ERROR
File M-REPEAT.SCR is missing. Check the M-REPEAT program instructions.
Notify your PC or Network Manager

Press any key to continue with DEFAULT error screens.
--------------------------------------------------------------------------------




E. Date interval not exceeded.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
Date parameter not exceeded. SCAN virus scanning program was not run.
--------------------------------------------------------------------------------




F. Time interval not exceeded.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
Time parameter not exceeded. SCAN virus scanning program was not run.
--------------------------------------------------------------------------------



G. If a virus is found when using the MxREPEAT program, a message is displayed
and the keyboard locked. When using the M-REPEAT program, the keyboard
condition and display message can be customized using the MERROR program.

H. Help and error screens are displayed if there are no M-REPEAT or MxREPEAT
command line arguments or the command line arguments are incorrect.

I. Due to changes and enhancements in the future, it is possible that
additional error levels not now programmed will be added to the SCAN program.
If M-REPEAT detects a new errorlevel, the numeric value will be displayed
along with a special warning message.

With M-REPEAT, the MERROR program can be used to program an error display for
the new errorlevel. Since MxREPEAT is not user programmable, a new copy of
the program must be obtained. Check Compuserve and your favorite Bulletin
Boards for the latest version.


Page 14.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------


APPENDIX II. M-REPEAT ERRORLEVELS
----------------------------------



The following errorlevels are returned by M-REPEAT.EXE:

0 Successful completion of M-REPEAT and SCAN (if run).

1 One or more viruses found. (same as returned by the SCAN program)

2 SCAN program abnormal termination (program error). (same as SCAN)

3 One or more uncertified files found. (same as SCAN)

4 -C or -Break aborted scan - same as SCAN.

200 All other errors causing termination of M-REPEAT.

201 The Log File could not be opened after running the SCAN program.

202 The path to the SCAN program is not valid.

203 The Date or Time parameter is not valid.

204 The branch to the SCAN program was not successful.



The M-REPEAT program normally returns the same errorlevel as it receives from
the SCAN program. Exceptions are errorlevels 200 through 204 listed above.
These are used to signify problems experienced by the M-REPEAT program.





















Page 15.
M-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------


APPENDIX III. M-CHK DISPLAY SCREENS
-----------------------------------



The following are the display screens for M-CHK conditions.


A. Time or Date interval exceeded.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
MESSAGE MESSAGE MESSAGE MESSAGE MESSAGE
M-CHK Date\Time Parameter Exceeded.
Scanning needed.
--------------------------------------------------------------------------------




B. Log File does not exist or could not be found.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
MESSAGE MESSAGE MESSAGE MESSAGE MESSAGE
M-CHK Log File not found.
Scanning needed.
--------------------------------------------------------------------------------




C. Date or Time interval not exceeded.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
MESSAGE MESSAGE MESSAGE MESSAGE MESSAGE
M-REPEAT program Date\Parameter not exceeded.
No Scanning Needed.
--------------------------------------------------------------------------------













Page 16.