PBS-Logs version 0.02
=====================

PBS::Logs - general parser for PBS log files

This module is designed to read the voluminous set of event or accounting
log files produced by a PBS (Portable Batch System) server.  These log
files typically have a filename which contain a datestamp (e.g. YYYYMMDD)
and which directory they are found in indicates their function.

The log file format has two formats:
 1) Accounting logs of the form -
	datetime;record_type;id;message

 2) Event logs of the form -
	datetime;event_code;server_name;object_type;object_name;message

The details as to the format and meaning can be found in the
"PBS Pro 5.4 Administrator Guide", and some info can be found
within this module.

The modules can filter on datetime and/or record_type and the class
methods can retrieve the data in a variety of formats (arrays, hashes,
or references of same).

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  Carp
  Time::Local

The test suite requires
  Test::More

You will need to grab Test-Simple-* and Test-Harness-2.* from
www.cpan.org if trying to install this module on a perl version < 5.8.

COPYRIGHT AND LICENCE

AUTHOR: Dr R K Owen, <rkowen@nersc.gov>
of the National Energy Research Scientific Computing Center (NERSC),
a Division of the Lawrence Berkeley National Laboratory (LBL),
funded by the U.S. Department of Energy.

Copyright (C) 2005 The Regents of the University of California

This library is free software; you can redistribute it
and/or modify it under the terms of the GNU Lesser General
Public License as published by the Free Software Foundation;
version 2.1 of the License.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
the GNU Lesser General Public License for more details,
which can be found at:

	license.txt
or	http://www.gnu.org/licenses/lgpl.html
or	http://www.gnu.org/copyleft/lesser.html
or	http://www.opensource.org/licenses/lgpl-license.php

If you find this software useful please send email to rkowen@nersc.gov
because the DOE likes to track how often DOE funded software is used
or downloaded.