=head1 NAME

gbatch_putredirlist - replace the redirection list in a job structure

=head1 SYNOPSIS

=for man
\&\fB#include <gbatch.h>\fR
.PP

=for html
<STRONG>#include &lt;gbatch.h&gt;</STRONG>
<br>

B<int gbatch_putredirlist(apiBtjob *>I<jobp>B<, const apiMredir
*>I<rdlist>B<, const unsigned>
I<num>B<)>

=head1 DESCRIPTION

The function B<gbatch_putredirlist> is used to replace the entire
redirection list for a job in one operation.

I<jobp> is a pointer to a structure which contains the job details.

I<rdlist> is a vector of redirections.

I<num> is the number of elements in I<rdlist>.

The new redirection list completely replaces the old.

=head1 RETURN VALUES

The function will return non-zero if successful otherwise zero if the
string table overflowed.  In the latter case the contents of the job
should no be relied upon, the job structure should be saved first if
in doubt.

=head1 SEE ALSO

gbatch_delarg(3),
gbatch_delenv(3),
gbatch_delredir(3),
gbatch_getarg(3),
gbatch_getdirect(3),
gbatch_getenv(3),
gbatch_getenvlist(3),
gbatch_gethenv(3),
gbatch_getredir(3),
gbatch_gettitle(3),
gbatch_putarg(3),
gbatch_putarglist(3),
gbatch_putdirect(3),
gbatch_putenv(3),
gbatch_putenvlist(3),
gbatch_putredir(3),
gbatch_puttitle(3),
gbatch_setqueue(3).

=head1 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.

=head1 AUTHOR

John M Collins, Xi Software Ltd.

=cut

## Local Variables:
## mode: nroff
## End:
