|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface GridSession
A central interface of jLite API which represents a grid session
with certain user/proxy credentials.
It provides methods for VOMS proxy creation, job submission,
monitoring, output retrieval etc.
Grid session is configured by a GridSessionConfig object,
instantiated via a GridSessionFactory and implemented by a GridSessionImpl.
Method Summary | |
---|---|
void |
cancelJob(java.lang.String jobId)
Requests cancellation of a job. The WMProxy service endpoint is determined by the default VO of the proxy certificate. |
void |
cancelJob(java.lang.String wmProxyURL,
java.lang.String jobId)
Requests cancellation of a job. |
org.globus.gsi.GlobusCredential |
createProxy(java.lang.String[] vomsArgs,
int lifetime,
int proxyType,
boolean limited)
Creates a VOMS user proxy certificate (advanced version). |
org.globus.gsi.GlobusCredential |
createProxy(java.lang.String vo,
int lifetime)
Creates a VOMS user proxy certificate. If you want to request specific ACs or create a limited proxy, check the advanced version. |
void |
delegateProxy(java.lang.String delegationId)
Delegates a proxy certificate linked to the session to WMProxy service. The WMProxy service endpoint is determined by the default VO of the proxy certificate. |
void |
delegateProxy(java.lang.String wmProxyURL,
java.lang.String delegationId)
Delegates a proxy certificate linked to the session to the specified WMProxy service. |
void |
destroyProxy()
Destroys a proxy certificate linked to the session. |
void |
getJobOutput(java.lang.String jobId,
java.lang.String outputDir,
boolean purge)
Retrieves the output of a job via GridFTP. The WMProxy service endpoint is determined by the default VO of the proxy certificate. Throws GridAPIException if the job is not in DONE state. |
void |
getJobOutput(java.lang.String wmProxyURL,
java.lang.String jobId,
java.lang.String outputDir,
boolean purge)
Retrieves the output of a job via GridFTP. Throws GridAPIException if the job is not in DONE state. |
java.lang.String |
getJobState(java.lang.String jobId)
Retrieves current job state of a job. Possible job states are: SUBMITTED, WAITING, READY, SCHEDULED, RUNNING, DONE, ABORTED, CANCELED, CLEARED (refer to gLite documentation). |
org.glite.wsdl.types.lb.JobStatus |
getJobStatus(java.lang.String jobId)
Retrieves the status of a job. |
org.globus.gsi.GlobusCredential |
getProxy()
Returns a proxy certificate linked to the session. |
java.util.List<java.lang.String> |
listJobOutput(java.lang.String jobId)
Returns URIs of the job output files on the server. The WMProxy service endpoint is determined by the default VO of the proxy certificate. Throws GridAPIException if the job is not in DONE state. |
java.util.List<java.lang.String> |
listJobOutput(java.lang.String wmProxyURL,
java.lang.String jobId)
Returns URIs of the job output files on the server. Throws GridAPIException if the job is not in DONE state. |
java.util.List<MatchedCE> |
listMatchedCE(java.lang.String jdl)
Matches available grid resources (computing elements, CE) to requirements specified in the job description. The WMProxy service endpoint is determined by the default VO of the proxy certificate. Returns a list of matched CEs sorted in decreasing rank order. |
java.util.List<MatchedCE> |
listMatchedCE(java.lang.String wmProxyURL,
java.lang.String jdl)
Matches available grid resources (computing elements) to requirements specified in the job description. Returns a list of matched CEs sorted in decreasing rank order. |
java.lang.String |
submitJob(java.lang.String jdl)
Submits a job via WMProxy service. The WMProxy service endpoint is determined by the default VO of the proxy certificate. |
java.lang.String |
submitJob(java.lang.String jdl,
java.lang.String inputDir)
Submits a job via WMProxy service. The WMProxy service endpoint is determined by the default VO of the proxy certificate. |
java.lang.String |
submitJob(java.lang.String wmProxyURL,
java.lang.String jdl,
java.lang.String inputDir)
Submits a job via WMProxy service. |
Method Detail |
---|
org.globus.gsi.GlobusCredential createProxy(java.lang.String vo, int lifetime) throws GridAPIException
vo
- VO namelifetime
- proxy validity time in seconds
GridAPIException
org.globus.gsi.GlobusCredential createProxy(java.lang.String[] vomsArgs, int lifetime, int proxyType, boolean limited) throws GridAPIException
vomsArgs
- a list of VOMS commands in the form lifetime
- proxy validity time in secondsproxyType
- version of proxy certificate {2,3,4} (use 2 for default gLite behavior)limited
- creates a limited proxy (use false for default gLite behavior)
GridAPIException
org.globus.gsi.GlobusCredential getProxy()
void destroyProxy() throws GridAPIException
GridAPIException
void delegateProxy(java.lang.String delegationId) throws GridAPIException
delegationId
- delegation identifier
GridAPIException
void delegateProxy(java.lang.String wmProxyURL, java.lang.String delegationId) throws GridAPIException
wmProxyURL
- WMProxy service endpointdelegationId
- delegation identifier
GridAPIException
java.util.List<MatchedCE> listMatchedCE(java.lang.String jdl) throws GridAPIException
jdl
- job description in JDL format
GridAPIException
java.util.List<MatchedCE> listMatchedCE(java.lang.String wmProxyURL, java.lang.String jdl) throws GridAPIException
wmProxyURL
- WMProxy service endpointjdl
- job description in JDL format
GridAPIException
java.lang.String submitJob(java.lang.String jdl) throws GridAPIException
jdl
- job description in JDL format
GridAPIException
java.lang.String submitJob(java.lang.String jdl, java.lang.String inputDir) throws GridAPIException
jdl
- job description in JDL formatinputDir
- all input files with relative paths
will be searched in the specified directory
GridAPIException
java.lang.String submitJob(java.lang.String wmProxyURL, java.lang.String jdl, java.lang.String inputDir) throws GridAPIException
wmProxyURL
- WMProxy service endpointjdl
- job description in JDL formatinputDir
- search input files in the specified directory
GridAPIException
org.glite.wsdl.types.lb.JobStatus getJobStatus(java.lang.String jobId) throws GridAPIException
jobId
- job identifier
GridAPIException
java.lang.String getJobState(java.lang.String jobId) throws GridAPIException
jobId
- job identifier
GridAPIException
void getJobOutput(java.lang.String jobId, java.lang.String outputDir, boolean purge) throws GridAPIException
jobId
- job identifieroutputDir
- directory to store retrieved filespurge
- purge job output from the server after retrieval
(use true for default gLite behavior)
GridAPIException
void getJobOutput(java.lang.String wmProxyURL, java.lang.String jobId, java.lang.String outputDir, boolean purge) throws GridAPIException
wmProxyURL
- WMProxy service endpointjobId
- job identifieroutputDir
- directory to store retrieved filespurge
- purge job output from the server after retrieval
(use true for default gLite behavior)
GridAPIException
java.util.List<java.lang.String> listJobOutput(java.lang.String jobId) throws GridAPIException
jobId
- job identifier
GridAPIException
java.util.List<java.lang.String> listJobOutput(java.lang.String wmProxyURL, java.lang.String jobId) throws GridAPIException
wmProxyURL
- WMProxy service endpointjobId
- job identifier
GridAPIException
void cancelJob(java.lang.String jobId) throws GridAPIException
jobId
- job identifier
GridAPIException
void cancelJob(java.lang.String wmProxyURL, java.lang.String jobId) throws GridAPIException
wmProxyURL
- WMProxy service endpointjobId
- job identifier
GridAPIException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |