LxREPEAT v3.02. Automate virus scanning
using Intel's LPScan program (part of the
LANProtect product). Scanning of workstation
drives is accomplished using a LAN Manager's
defined Date or Time interval. Also can
prevent user aborting LPScan using the
or keys. When a virus is found,
an alarm is sounded, a message is displayed
and the keyboard locked. Easy checkout with
supplied tools. From DATACHIP.

L-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]




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



INDEX


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

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


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


III. THE L-REPEAT and LxREPEAT Programs..................... 3.


IV. L-REPEAT and LxREPEAT Command Line Parameters.......... 4.


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


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


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


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


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


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




APPENDIX I. L-REPEAT/LxREPEAT Default Screens.............. 13.


APPENDIX II. L-REPEAT/LxREPEAT Errorlevels................. 15.


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







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


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

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

LxREPEAT.EXE is the shareware version of the main program. L-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 L-REPEAT
version. In this manual, LxREPEAT and L-REPEAT are used interchangeably
except when discussing custom error screens and keyboard actions.

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



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


The LxREPEAT and support programs consisting of L-CHKOUT.EXE, L-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 L-REPEAT and LxREPEAT Programs
---------------------------------------

L-REPEAT is a program that executes the virus scanning program LPScan.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.
L-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



When L-REPEAT is run, a command line interval parameter is used to tell
L-REPEAT how often the LPScan program should scan. If the difference between
the present time/date and the last time/date the personal computer was
successfully scanned is less than the command line interval parameter,
L-REPEAT will exit without running LPScan. L-REPEAT then exits with an
errorlevel of zero.

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

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

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

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



IV. L-REPEAT Command Line Parameters
------------------------------------

The command line for L-REPEAT is:

L-REPEAT AAA BBB /C-DDDD EEE EEE EEE /ESC

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

EXAMPLE: L-REPEAT F:\LPROTECT where LPScan is in the
F:\LPROTECT\ directory.


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

EXAMPLE: L-REPEAT LPScan where LPScan.EXE is in the same directory
as L-REPEAT.





Page 4.
L-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 LPScan.!LG will be used in the path specified.
If the path and Log File are both not included in the command line,
L-REPEAT will access or create a new Log File in the current
directory named LPScan.!LG.

EXAMPLE: L-REPEAT F:\LPROTECT C:\LPScan.!LG where C:\LPSCAN.!LG
is the log file.

EXAMPLE: L-REPEAT F:\LPROTECT C:\NEW where C:\NEW\LPScan.!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. LPScan 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 LPScan 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 LPScan 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
LPScan is called again.


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

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


When using the /T parameter, the LPScan 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.
L-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



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

Each parameter passed to the LPScan program must be separated by
a space on the command line. See the LPScan program documentation
for aid in choosing the desired LPScan 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.

/ESC is used to inhibit the key to prevent breaking out of LPScan.

EXAMPLES:

L-REPEAT F:\LPROTECT /D-0 /V /NC /ESC

LPScan.EXE is in the F:\LPROTECT directory. The log file
is LPScan.!LG in the current directory. The program
LPScan.EXE will be executed each time the L-REPEAT program
is run. All local drives will be scanned. If a virus is
found, it will be reported and not cleaned (suggested).
LPScan can not be aborted by pressing the key.


L-REPEAT G:\LPROTECT C:\ /D-1 E: /REPORT=C:\LPScan.RPT /NC /ESC

LPScan.EXE is in the G:\LPROTECT directory. The log file
name is C:\LPScan.!LG. LPScan will scan the first time
L-REPEAT is run on a new calendar day. E: drive will be
scanned and a report written to the file C:\LPScan.RPT. If
a virus is found it will not be automatically cleaned. The
key can not be used to break out of LPScan.


L-REPEAT G:\LPROTECT C:\ /T-5:2 E: /REPORT=C:\LPScan.RPT /NC /ESC

Same as above except LPScan will scan the first time
L-REPEAT is run after 5 hours and 2 minutes have elapsed
since the last successful scan.


L-REPEAT or L-REPEAT ?

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






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



V. Generating Custom Error Screens with LERROR.EXE
---------------------------------------------------
(L-REPEAT ONLY OPTION)

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

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

Using LERROR, an error screen can be created for each errorlevel returned by
the LPScan 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 LERROR is straight forward. Context sensitive help is available by
pressing the key.



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

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

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

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







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



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

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

The command line form for L-CHK is:

L-CHK AAA /B-CCC
where:

AAA is the path and filename of the Log File.

EXAMPLE: L-CHK C:\LPScan\LPScan.!LG
The log file name is C:\LPScan\LPScan.!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: L-CHK C:\LPScan\LPScan.!LG /T-02:03
The log file name is C:\LPScan\LPScan.!LG.
The time interval is 2 hours and 3 minutes.

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


If the date\time interval since the last successful scan has not been
exceeded, L-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 L-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: L-CHK C:\LPScan.!LG /D-1 >NUL









Page 8.
L-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 the L-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 L-REPEAT using a command line like:

F:\VRS\L-REPEAT F:\LPROTECT\LPScan C:\LPScan.!LG /D-4 /V /NC
(continuation line) /L=C:\LPScan.RPT /ESC

This command line will use the C:\LPScan.!LG Log File and cause LPScan to scan
all the workstation disks every 4 days. In this example, the LPScan programs
and the L-REPEAT.EXE and L-REPEAT.SCR files are in the F:\VRS directory. If a
virus is found, it will not be cleaned automatically. A LPScan report
will be written to the C:\LPScan.RPT file. The keyboard options can be
programmed using LERROR 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. The key is inhibited to prevent
stopping LPScan by pressing the key.
logging into the network and not scanning for viruses.

On a Novell network, the L-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 L-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 L-CHK.EXE program into the network menuing
scripts. Example:

L-CHK C:\LPScan.!LG /d-4 >NUL
IF ERRORLEVEL 1 GOTO SCAN
GOTO CONTINUE
:SCAN
F:\VRS\L-REPEAT F:\LPROTECT\LPScan C:\LPScan.!LG /D-4 /V /NC
(continuation line) /L=C:\LPScan.RPT /ESC
:CONTINUE

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






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



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

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

Upon registration of LxREPEAT, the USER will receive:

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

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

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

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

(5) L-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 L-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.
L-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.)

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

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

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

L-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.
L-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 LPSCAN program also referred to in this document as LPSCAN.EXE and
LPROTECT.EXE are copyrighted programs by Intel Corporation. Intel is a
registered trademark and LANProtect is a trademark of Intel Corporation.

















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

APPENDIX I. L-REPEAT DEFAULT SCREENS
------------------------------------

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


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

DISPLAY MESSAGE
--------------------------------------------------------------------------------
ERROR ERROR ERROR ERROR ERROR
The directory \DIR 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 LPScan.EXE or Log File location.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
ERROR ERROR ERROR ERROR ERROR
There is no Q: 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 L-REPEAT program has aborted!

The L-REPEAT program was incorrectly called with the following command line:
L-REPEAT F:\LPROTECT C:\ /D-9999999999 /V
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.
L-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------



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

DISPLAY MESSAGE
--------------------------------------------------------------------------------
ERROR ERROR ERROR ERROR ERROR
File L-REPEAT.SCR is missing. Check the L-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. LPSCAN virus scanning program was not run.
--------------------------------------------------------------------------------




F. Time interval not exceeded.

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


G. If a virus is found when using the LxREPEAT program and the /NC option, a
message is displayed by LxREPEAT and the keyboard locked. When using the
L-REPEAT program, the keyboard condition and display messages can be
customized using the LERROR program.


H. Help and error screens are displayed if there are no L-REPEAT or LxREPEAT
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 LPScan
program. If L-REPEAT detects a new errorlevel, the numeric value will be
displayed along with a special warning message.

With L-REPEAT, the LERROR program can be used to program an error display for
the new errorlevel. Since LxREPEAT is not user programmable, a new copy of
the program must be obtained. Check Compuserve and/or your favorite Bulletin
Boards for the latest version.
Page 14.
L-REPEAT version 3.x PROGRAM GROUP MANUAL
-------------------------------------------

APPENDIX II. L-REPEAT ERRORLEVELS
---------------------------------

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

0 Successful completion of L-REPEAT and LPSCAN (if run).

1 LPSscan command line option error.
(same as returned by the LPSCAN program)

2 LPScan unable to locate a valid virus pattern file.
(same as returned by the LPSCAN program)

4 Virus found in memory. (same as LPScan)

8 A boot sector virus was found. (same as LPScan)

16 Unable to locate the specified drive. (same as LPScan)

32 LPScan was aborted by pressing key. (same as LPScan)
(will not occur if the /ESC option is used)

200 All other errors causing termination of L-REPEAT.

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

202 The path to the LPScan program is not valid.

203 The Date or Time parameter is not valid.

204 The branch to the LPScan program was not successful.


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

Note: The and key combinations are inhibited while the
L-REPEAT program is running. By using the /ESC command line parameter, the
user will not be able to abort LPScan by pressing the key.














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

APPENDIX III. L-CHK DISPLAY SCREENS
-----------------------------------



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


A. Time or Date interval exceeded.

DISPLAY MESSAGE
--------------------------------------------------------------------------------
MESSAGE MESSAGE MESSAGE MESSAGE MESSAGE
L-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
L-CHK Log File not found.
Scanning needed.
--------------------------------------------------------------------------------




C. Date or Time interval not exceeded.

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













Page 16.