gbatch_jobfind - obtain the details of a job by the job number
gbatch_jobfindslot - obtain the slot number of a job from the job number
int gbatch_jobfind(const int fd, const unsigned flags, const jobno_t jobnum, const netid_t nid, slotno_t *slot, apiBtjob *jobd)
int gbatch_jobfindslot(const int fd, const unsigned flags, const jobno_t jobnum, const netid_t nid, slotno_t *slot)
The function gbatch_jobfind is used to retrieve the details of a job, starting from the job number, in one operation.
The function gbatch_jobfindslot is used to retrieve just the slot number of a job, starting from the job number.
fd is a file descriptor which was previously returned by a
successful call to gbatch_open(3)
.
flags is zero or the logical OR of one or more of the following bits:
Search for jobs local to the server only.
Search for jobs owned by the user only.
Search for jobs owned by the group only.
Search for jobs with the queue name specified by gbatch_setqueue(3)
only.
jobnum is the job number to be searched for.
nid is the IP address (in network byte order) of the host on which
the searched-for job is to be located. It should be correct even if
GBATCH_FLAG_LOCALONLY
is specified.
slot is assigned the slot number corresponding to the job. It may be null is not required, but this would be nearly pointless with gbatch_jobfindslot (other than reporting that the job was unknown).
jobp is a pointer to a structure to contain the details of the job for gbatch_jobfind.
The definition of the job structure is given in a previous section of this manual.
The function returns 0 if successful, otherwise an error code as defined in the include file \fBgbatch.h\fR.
gbatch_jobdata(3)
,
gbatch_joblist(3)
,
gbatch_jobread(3)
,
gbatch_jobupd(3)
.
Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
John M Collins, Xi Software Ltd.