← Back to branch summary

~ubuntu-branches/ubuntu/utopic/gridengine/utopic

« back to all changes in this revision

Viewing changes to source/libs/japi/japi.html

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2008-06-25 22:36:13 UTC
  • Revision ID: james.westby@ubuntu.com-20080625223613-tvd9xlhuoct9kyhm
Tags: upstream-6.2~beta2
Import upstream version 6.2~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
source/libs/japi/japi.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
 
2
<HTML>
 
3
<HEAD>
 
4
        <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
 
5
        <TITLE></TITLE>
 
6
        <META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Solaris Sparc)">
 
7
        <META NAME="AUTHOR" CONTENT=" ">
 
8
        <META NAME="CREATED" CONTENT="20010611;14564800">
 
9
        <META NAME="CHANGEDBY" CONTENT=" ">
 
10
        <META NAME="CHANGED" CONTENT="20010716;16471800">
 
11
</HEAD>
 
12
<BODY>
 
13
<H1><FONT SIZE=6 STYLE="font-size: 28pt">JAPI library - Job Application programming interface</FONT></H1>
 
14
<H1>Overview</H1>
 
15
<P>The JAPI library is a layer on top of 
 
16
<A HREF="http://gridengine.sunsource.net/unbranded-source/browse/%7Echeckout%7E/gridengine/source/libs/gdi/gdi.html?content-type=text/html">libgdi</A>, 
 
17
<A HREF="http://gridengine.sunsource.net/unbranded-source/browse/%7Echeckout%7E/gridengine/doc/devel/eventclient.html?content-type=text/html">libevc</A> 
 
18
. JAPI collects the specific qualities of both modules to provide a to-the-point interface 
 
19
providing those operations a typical Grid Engine end user depends upon. That is submission 
 
20
of jobs and array-jobs, enquire and control of job status, synchronizing with jobs end as 
 
21
well as examining the manner how a job finished. In contrast to this manipulating the 
 
22
configuration of a Grid Engine queue is typically not done by end users. The design of the 
 
23
core JAPI functions was vitally influenced by the interface specification the 
 
24
<A HREF="http://www.drmaa.org">GGF DRMAA working group</A>
 
25
developed. Note that currently only qsub(1)-ish jobs can be submitted through JAPI.</P>
 
26
<H1>Implementation</H1>
 
27
<P>Constraints of the protocol used by libevc, made it necessary to run a service thread 
 
28
in background of JAPI. The purpose of this thread is to wait for new events
 
29
sent by Grid Engine qmaster, acknowledge received events to qmaster and provide 
 
30
information related to job states in a shared data structure that is maintained 
 
31
to implement services certain JAPI calls base upon (i.e. japi_wait(3)). The JAPI 
 
32
library is a MT safe library allowing any number of application threads to use JAPI 
 
33
services without explicit synchronization.</P>
 
34
<P ALIGN=CENTER STYLE="text-decoration: none">Copyright 2003 Sun
 
35
Microsystems, Inc. All rights reserved.</P>
 
36
<H1><BR><BR>
 
37
</H1>
 
38
<P><BR><BR>
 
39
</P>
 
40
<P><BR><BR>
 
41
</P>
 
42
<H1><BR><BR>
 
43
</H1>
 
44
</BODY>
 
45
</HTML>