NAME

gbch-cvlist - dump out GNUbatch variables to a shell script


SYNOPSIS

gbch-cvlist [ -D dir ] [ -v n ] [ -e n ] [ -s ] [ -f ] var file outfile


DESCRIPTION

gbch-cvlist converts GNUbatch variables held in the batch spool directory to an executable shell script which may be used to re-install them. This may be useful for backup purposes or for one stage in upgrade from one release of GNUbatch to another.

gbch-cvlist understands the format of the saved variable file for versions of Xi-Batch going back to release 4, and when presented with a saved file, will attempt to work out from the format which release it relates to.

In addition to options, two arguments are always supplied to gbch-cvlist.

Variable list file

This is the file containing the attributes of the variables, btsched_vfile in the batch spool directory, by default /usr/spool/batch, or as relocated by re-specifying SPOOLDIR.

Output file

This file is created by gbch-cvlist to contain the executable shell script, containing gbch-var(1) commands, which may be used to recreate the variables.


OPTIONS

-D directory

Specifies the source directory for the variables and var file if not the current directory. It can be specified as $SPOOLDIR or ${SPOOLDIR-/var/spool/gnubatch} etc and the environment and/or /etc/gnubatch.conf will be interrogated to interpolate the value of the environment variable given.

If you use this, don't forget to put single quotes around it thus:

 gbch-cvlist -D '${SPOOLDIR-/var/spool/gnubatch}' ...

otherwise the shell will try to interpret the $ construct and not gbch-cvlist.

-e n

Tolerate n errors of the kinds denoted by the other options before giving up trying to convert the file.

-f

Ignore format errors in the saved variable file, skip over invalid entries up to the limit given by the -e option.

-s

Ignore file size errors in the saved variable file (up to the number of total errors given by the -e option).

-v number

Tell gbch-cvlist that the variable file is for release number of Xi-Batch, where number is 4 to 6.

This may be necessary where the variable file is corrupted and gbch-cvlist cannot guess what is meant.


SEE ALSO

gbch-ciconv(8), gbch-cjlist(8), gbch-uconv(8).


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.