gbatch_gettitle - get the job title from a job structure
const char *gbatch_gettitle(const int fd, const apiBtjob *jobp)
The function gbatch_gettitle may be used to extract the title from a job as a character string. Optionally the queue name (as set by gbatch_setqueue(3)) may be elided from the title.
fd is a file descriptor which was previously returned by a
successful call to gbatch_open(3)
, or -1
to disregard the queue name.
jobp is a pointer to a structure containing the details of the job.
The result is the title of the job as a const
character string.
If a valid file descriptor is provided, and this has a queue name set
using gbatch_setqueue(3)
, and the queue name is the same as that in the
job title, then the queue name is deleted from the title returned to
the user.
gbatch_delarg(3)
,
gbatch_delenv(3)
,
gbatch_delredir(3)
,
gbatch_getarg(3)
,
gbatch_getdirect(3)
,
gbatch_getenv(3)
,
gbatch_getenvlist(3)
,
gbatch_getredir(3)
,
gbatch_open(3)
,
gbatch_putarg(3)
,
gbatch_putarglist(3)
,
gbatch_putdirect(3)
,
gbatch_putenv(3)
,
gbatch_putenvlist(3)
,
gbatch_putredir(3)
,
gbatch_putredirlist(3)
,
gbatch_puttitle(3)
,
gbatch_setqueue(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.