NAME

gbatch_putarg - insert a new argument into a job structure


SYNOPSIS

#include <gbatch.h>

int gbatch_putarg(apiBtjob *jobp, const unsigned indx, const char *newarg)


DESCRIPTION

The function gbatch_putarg is used to replace or add a new argument to the argument list of a job.

jobp is a pointer to a structure containing the details of the job.

indx is the number of the argument to be replaced or added. This may be greater than any number of existing arguments if required, in which case any intervening arguments are created as empty strings.

newarg is the character string containing the new argument.


RETURN VALUES

The result is non-zero if successful or zero if the string table overflowed. In the latter case the contents of the string table should not be relied upon. The job structure should be saved first if in doubt.


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_gettitle(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.