uk.ac.soton.itinnovation.grid.comms.job
Interface JobService

All Superinterfaces:

GridService, IdentifiableResource, ManagedGridService, ReportAPI, WSRFService

All Known Subinterfaces:

JobServiceSOAP, RemoteJobService

All Known Implementing Classes:

JobServiceModule

@WebService(targetNamespace="http://www.it-innovation.soton.ac.uk/2004/grid/job",
            name="JobService",
            serviceName="JobService",
            wsdlLocation="jobservice.wsdl")
public interface JobService
extends ManagedGridService, WSRFService, ReportAPI, GridService

Field Summary

Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService

FREE_SERVICE

Method Summary

JobStatus	createJob(String applicationURI, MatchRule owner) Deprecated. See createJobJSDL(org.w3c.dom.Document, uk.ac.soton.itinnovation.grid.types.MatchPattern). Create a new job. Billing information should be passed in a SOAP header.
Document	createJobJSDL(Document jsdl, MatchPattern owner) Create a new job.
Document	getApplicationDescription(String applicationURI) Deprecated. in version 5.2 see getApplicationMetadataDetailed(java.lang.String)
Document	getApplicationMetadata(String applicationURI) Deprecated. in version 5.1 see getApplicationDescription(java.lang.String)
Document	getApplicationMetadataDetailed(String applicationURI) Get the 5.2 style meta-data for a particular application.
String[]	getApplications() List the applications available on this service.

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService

addTrustedAccountService, getAdditionalFederationMethods, getAdditionalFederations, getFederatedMethods, getTrustedAccountServices, removeTrustedAccountService, setAdditionalFederation

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.wsrf.WSRFService

GetResourceProperty

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.reportapi.ReportAPI

getMessages, getMessagesN

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.GridService

getResources, getServiceProviderID, getServiceProviderIssuer

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.IdentifiableResource

getServiceMatchPattern

Method Detail

createJob

@Deprecated
@WebMethod(usesBillingHeader=true)
JobStatus createJob(String applicationURI,
                                                          MatchRule owner)
                    throws RemoteException

Deprecated. See createJobJSDL(org.w3c.dom.Document, uk.ac.soton.itinnovation.grid.types.MatchPattern). Create a new job. Billing information should be passed in a SOAP header.

Parameters:

applicationURI - the type of the application to be run

owner - A rule to allow access for the owner role

Returns:

a JobStatus including the EPR of the job and its inputs and outputs

Throws:

RemoteException

createJobJSDL

@WebMethod(usesBillingHeader=true)
Document createJobJSDL(Document jsdl,
                                                  MatchPattern owner)
                       throws RemoteException

Create a new job. Billing information should be passed in a SOAP header.

Parameters:

jsdl - a JSDL document describing the job

owner - a rule to allow access for the owner role

Returns:

an updated JSDL document including the EPR of the job and its inputs and outputs (data stagers). The EPR for the job is stored as an additional element within the . The EPR for each data stager is stored as an additional element within a element. In addition, each element will include either a or element, containing the fully qualified Conversation ID of the data stager.

Throws:

RemoteException

getApplications

@WebMethod
String[] getApplications()
                         throws RemoteException

List the applications available on this service.

Throws:

RemoteException

getApplicationMetadata

@WebMethod(serverReturnDocumentStyleHack=true)
@Deprecated
Document getApplicationMetadata(String applicationURI)
                                throws RemoteException

Deprecated. in version 5.1 see getApplicationDescription(java.lang.String)

Get the meta-data for a particular application.

Parameters:

applicationURI - the globally unique identifier for the application type

Returns:

a document containing the contents of the ApplicationMetadata.xml file.

Throws:

RemoteException

getApplicationMetadataDetailed

@WebMethod
Document getApplicationMetadataDetailed(String applicationURI)
                                        throws RemoteException

Get the 5.2 style meta-data for a particular application. If the application is a legacy 5.1 application, the metadata will be converted into the new 5.2 format before it is returned.

Parameters:

applicationURI - the globally unique identifier for the application type

Returns:

a document containing the contents of the ApplicationMetadata.xml file.

Throws:

RemoteException

getApplicationDescription

@WebMethod
Document getApplicationDescription(String applicationURI)
                                   throws RemoteException

Deprecated. in version 5.2 see getApplicationMetadataDetailed(java.lang.String)

Get the 5.1 style meta-data for a particular application. If the application is a newer 5.2 style application, the metadata will be converted into the older 5.1 format before it is returned.

Parameters:

applicationURI - the globally unique identifier for the application type

Returns:

a document containing the contents of the ApplicationMetadata.xml file.

Throws:

RemoteException

Since:

version 5.1