NAME
BatchSystem::SBS - a Simple Batch System
DESCRIPTIONESCRIPTION
A light, file based batch system.
SYNOPSIS
a short example
submiting command
You can submit either comman or scripts.
Script submited on a resource of type 'machine' will be sshed on the host
Once a resource is attributed to a job, the script is transformed, changing the following varaibles (see examples/*.sh)
- $(machinefile} (for cluster type resource)
- ${nbmachines} (for cluster type resource)
- ${host} (for machine type resource)
- ${jobid}
At submition time, a directory with the job number (incremented integer) is created, where stdout/err will be written.
There will also have a batch.properties file (pids, start time etc. etc.)
EXPORT
FUNCTIONS
METHODS
my $sbs=BatchSystem::SBS->new();
Accessors
$sbs->scheduler
Returns the scheduler (BatchSystem::SBS::DefaultScheduler)
$sbs->workingDir([$val])
Get set the working directory
$sbs->
$sbs->
Actions
$sbs->job_submit(command=>cmd, queue=>queuename);
Returns a jobid
$sbs->job_remove(id=>job_id);
Remove the job from the list, the scheduler, kill processes
$sbs->job_infoStr(id=>job_id);
Returns a string (or undef if no job exist) with the job info
$sbs->job_info(id=>job_id);
Returns a hash (or undef if no job exist) with the job info
$sbs->jobs_dir([clean=>1]);
Get the job directory;
clean=>1 argument will clean the whole job directory
$sbs->jobs_list()
Returns an n x 4 array (each row contains jobid, queuename, scripts)
I/O
$sbs->readConfig(file=>file.xml)
Read its config from an xml file (see examples/ dir)
AUTHOR
Alexandre Masselot, <alexandre.masselot@genebio.com>
BUGS
Please report any bugs or feature requests to bug-batchsystem-sbs@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=BatchSystem-SBS. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
ACKNOWLEDGEMENTS
COPYRIGHT & LICENSE
Copyright (C) 2004-2006 Geneva Bioinformatics (www.genebio.com) & Jacques Colinge (Upper Austria University of Applied Science at Hagenberg)
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; either version 2.1 of the License, or (at your option) any later version.
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.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA