NAME
XAS::Lib::Batch::Server - A class for the XAS environment
SYNOPSIS
use XAS::Lib::Batch::Server;
my $server = XAS::Lib::Batch::Server->new();
my $stat = $server->qstat();DESCRIPTION
This module provides an interface for manipulating servers in a Batch System. Each available method is a wrapper around a given command. A command line is built, executed, and the return code is checked. If the return code is non-zero an exception is thrown. The exception will include the return code and the first line from stderr.
Since each method is a wrapper, there is a corresponding man page for the actual command. They should also be checked when problems arise.
METHODS
new
This method initializes the module and takes these parameters:
- -interface
-
The command line interface to use. This defaults to 'XAS::Lib::Batch::Interface::Torque'.
qstat(...)
This method returns that status of a server. This status will be a hash reference of the parsed output on stdout. It takes the following paramters:
qdisable(...)
This method will disable a queue or if the queue is not given, batch processing at the server. It takes the following paramters:
- -queue
-
The optional name of the queue.
- -host
-
The optional host that the queue may be on. Defaults to 'localhost'.
qenable(...)
This method will enable a queue or if the queue is not given, batch processing at the server. It takes the following paramters:
- -queue
-
The optional name of the queue.
- -host
-
The optional host that the queue may be on. Defaults to 'localhost'.
SEE ALSO
AUTHOR
Kevin L. Esteb, <kevin@kesteb.us>
COPYRIGHT AND LICENSE
Copyright (c) 2015 Kevin L. Esteb
This is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0. For details, see the full text of the license at http://www.perlfoundation.org/artistic_license_2_0.