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 parameters:

-host

The optional host that the server may be on. Defaults to 'localhost'.

qdisable(...)

This method will disable a queue or if the queue is not given, batch processing at the server. It takes the following parameters:

-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 parameters:

-queue

The optional name of the queue.

-host

The optional host that the queue may be on. Defaults to 'localhost'.

SEE ALSO

XAS::Lib::Batch
XAS

AUTHOR

Kevin L. Esteb, <kevin@kesteb.us>

COPYRIGHT AND LICENSE

Copyright (c) 2012-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.