NAME

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


SYNOPSIS

#include <gbatch.h>

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)


DESCRIPTION

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:

GBATCH_FLAG_LOCALONLY

Search for jobs local to the server only.

GBATCH_FLAG_USERONLY

Search for jobs owned by the user only.

GBATCH_FLAG_GROUPONLY

Search for jobs owned by the group only.

GBATCH_FLAG_QUEUEONLY

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.


RETURN VALUES

The function returns 0 if successful, otherwise an error code as defined in the include file \fBgbatch.h\fR.


SEE ALSO

gbatch_jobdata(3), gbatch_joblist(3), gbatch_jobread(3), gbatch_jobupd(3).


COPYRIGHT

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.


AUTHOR

John M Collins, Xi Software Ltd.