gbatch_putenv - insert an environment varible into a job.

# NAME

gbatch_putenv - insert an environment varible into a job.

# SYNOPSIS

#include <gbatch.h>

const char *gbatch_putenv(const apiBtjob *jobp, const char *name)

# DESCRIPTION

The function gbatch_putenv is used to insert an environment variable into a job string table.

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

name is the environment varible required, in the form `NAME=VALUE`.

# RETURN VALUES

This function will return non-zero if successful otherwise zero if the string table overflowed. In the latter case the contents of the job structure should not be relied upon. If in doubt copy the job structure first.

# 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_putarg(3), gbatch_putarglist(3), gbatch_putdirect(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.