gbatch_jobfind - obtain the details of a job by the job number

# 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.