gbatch_gettitle(3)

NAME
gbatch_gettitle - get the job title from a job structure

SYNOPSIS
#include <gbatch.h>

const char *gbatch_gettitle(const int fd, const apiBtjob *jobp)

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

RETURN VALUES
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.

SEE ALSO
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
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.