dLife Home Page

Package dlife.tools.xgrid

Classes for interacting with Apple's Xgrid Technology.

See:
          Description

Class Summary
ClearGrid Command line utility for deleting all of the jobs on a specified xgrid.
RunCommands A simple command line tool for running commands on a specified xgrid.
XgridBatch A collection of XgridCommands that can be submitted to the Xgrid as a batch.
XgridCommand A command to be submitted to the Xgrid as a job.
XgridResult The results from the submission of an XgridCommand to the Xgrid.
XgridUtils This class contains a collection of general utility methods for use with the xgrid.
 

Exception Summary
BadXgridCommandException An Exception that is thrown when an error occurs during submission of a job to the xgrid.
XGridFailureException Exception that is thrown when
 

Error Summary
XgridCommunicationError An Error that is thrown when an unrecoverable error occurs during communication with the xgrid controller.
 

Package dlife.tools.xgrid Description

Classes for interacting with Apple's Xgrid Technology. Apple's Apple's Xgrid Technology is a grid computing solution that comes standard with Mac OS X. In order to use this package you will need to have access to an Xgrid Controller and your machine must be enabled as an Xgrid client.

The text below describes the overall structure of the dlife.tools.xgrid package and how its classes and interfaces interact. The examples.dlife.tools.xgrid package contains a working example that uses the dlife.tools.xgrid package.

Overview:

The core of the dlife.tools.xgrid package is formed by three main classes:

Additional Utilities:

In addition to the above classes that are useful for interacting with Xgrid programmatically, this package contains a few small command line tools that may be useful:

The classes in this package provide support for the use of Apple's Xgrid computing technology (xgrid). The three important classes in this package are the XgridCommand , XgridBatch and XgridResult classes. The XgridCommand class represents a command that can be submitted to be run on the xgrid. It is basically an interface to Apple's xgrid command line tool. More information on the command line tool can be found via man xgrid . The XgridBatch class is a collection of XgridCommand objects that can be submitted, manipulated, retrieved and deleted as a batch. Most often the interaction with the xgrid will be mediated by an XgridBatch object. The XgridResult class provides access to information about the results of executing an XgridCommand such as its submission time, completion time and the results of the execution.

Typical Use:

Typical use of the classes in dlife.tools.xgrid will be to create one XgridCommand object for each job to be run on the xgrid. All of these XgridCommand objects will be added to a XgridBatch object and submitted to the grid. When all of the jobs have completed, a list of XgridResult objects containing the results of each job can be retrieved from the XgridBatch object. See the The examples.dlife.tools.xgrid package for a working example.


dLife Home Page