GBCH-CICONV(8)

NAME
gbch-ciconv - dump out GNUbatch command interpreters to a shell script

SYNOPSIS
gbch-ciconv [ -D dir ] [ -v n ] [ -e n ] [ -u ] [ -s ] [ -f ] ci file outfile

DESCRIPTION
gbch-ciconv converts GNUbatch command interpreters 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-ciconv understands the format of the saved job file for versions of GNUbatch 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.

Command interpreter list file
    This is the file containing the attributes of the variables, cifile in the batch spool directory, or as relocated by re-specifying "SPOOLDIR".

Output file
    This file is created by gbch-ciconv to contain the executable shell script, containing gbch-cichange(1) commands, which may be used to recreate the command interpreters.

OPTIONS

-D directory
    specifies the source directory for the command interpreter file. It can be specified as $SPOOLDIR or "${SPOOLDIR-/var/spool/gnubatch}" etc and the environment and/or 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-ciconv -D '${SPOOLDIR-/var/spool/gnubatch}' ...

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

-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 command interpreter file up to the limit of errors given in the -e option.

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

-u  Do not check user names (not used, but included for consistency with gbch-cjlist(8) and gbch-cvlist(8)).

-v number
    Tell gbch-ciconv that the job file is for release number of GNUbatch, where number is 4 to 6.

    This may be necessary where the command interpreter file is corrupted and gbch-ciconv cannot guess what is meant.

SEE ALSO
gbch-cjlist(8), gbch-cvlist(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.