gbatch_delenv - delete an environment variable from a job structure

# NAME

gbatch_delenv - delete an environment variable from a job structure

# SYNOPSIS

#include <gbatch.h>

int gbatch_delenv(const apiBtjob *jobp, const char *name)

# DESCRIPTION

The function gbatch_getenv is used to delete an environment variable from a job string table.

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

The definition of the job structure is given in a previous section of this manual.

name is the environment varible to be deleted.

# RETURN VALUES

The result is non-zero if successful, or zero if the string table overflowed, an unlikely event in the case of a deletion.

No error is reported if the specified variable does not exist.

# NOTES

Environment variables common to all jobs may be held in a "static environment file" to which the job structure environment variables represent differences only. This routine will not affect entries in the static environment file.

# SEE ALSO

`gbatch_delarg(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_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.