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:

Accounting logs of the form -
datetime;record_type;id;message
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.

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.