**********************************************************************

  Logger
  ======

  A simple, WPS aware, utility for logging events.

  (C) Copyright Bjorn Fahller 1996.

**********************************************************************

WPS aware in what sense? 

             A log folder will be created on your desktop. This is
             where logs will be written. If you move or rename the
             folder, the logs will still get to the right place.
             The log folder can be opened by the logger utility,
             regardless of where the log folder resides.


**********************************************************************

Usage:
======

logger wr name "a message"

             Append the string "a message" (without the quotes) to the
             file named "name" in the log folder. If no file named
             "name" exists in the log folder, it will be created.
             Useful for reporting unexpected, odd, bad or unwanted,
             results in night-time REXX scripts.

logger wrp name

             Append from stdin to the file named "name" in the log
             folder. If no file named "name" exists in the log folder,
             it will be created. This is useful for "piping" info
             to a log.

             Example:
               dir c: | logger wrp dirc

               Will create a file named "dirc" in the log folder.
               The content of "dirc" will be the output of "dir c:"

logger oc

             Open the log folder if, and only if, there are files in
             it.


Example:

A small script to scan your local hard drives for viruses. If a
virus is found, the output of the virus scanner is logged to
a file named "virus".

/* rexx script to scan for viruses */

call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs'
call SysLoadFuncs

tmp=value('TMP',,'OS2ENVIRONMENT');
name=SysTempFileName(tmp'\scan???.rep');

'@os2scan.exe /adl /nobeep /noexpire /report' name '/rptcor /rpterr'
if rc \= 0 then
  'mylog wrp virus <' name

'del' name
exit

/* end of rexx script */

Use ExCal, cron, or some other timer utility to start this script at
night time, or when you're at work.

Then, early in the morning, or in the afternoon, have "logger oc"
started for you to open the log folder if there is anything
there.


**********************************************************************

Registration:
=============

None. There is no such thing for this program. If you like it,
tell others, and tell me. If you have ideas for enhancements,
tell me. If you like it very much indeed, send me a post card.
As a matter of fact, send me a post card anyway :-)
See "Contacting the Author" below for the address.


**********************************************************************

License agreement:
==================

Logger, the executable (logger.exe) and this file (logger.doc) is
the copyrighted property of Bjorn Fahller.

- You may use this software, for free, as much as you please, 
- You may copy and redistribute this software, as long as the
  recipient receives logger.zip unchanged, and there is no cost
  to the recipient, other than the cost of providing media and
  transmission.
- You may redistribute this software under other conditions than
  those above if, and only if, you have a personal agreement with
  Bjorn Fahller, to do so (See "Contacting the Author" below.)

THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY KIND.
BJORN FAHLLER SHALL NOT BE LIABLE FOR ANY DAMAGES ARISING OUT OF
YOUR USE, OR INABILITY TO USE, OR ABUSE, OF THIS PROGRAM, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BY YOUR USE OF THE
PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE.


**********************************************************************

Contacting the Author:
======================

e-mail:     bjorn@algonet.se
Phone:      +46 8 918297 (evenings, CET)
Fax:        +46 8 918297 (daytime, workdays, CET)
Snail-mail: Bjorn Fahller
            Siljansvagen 35
            S-120 55 Arsta
            SWEDEN


