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, 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.