GBCH-CJLIST(8)

NAME
gbch-cjlist - dump out GNUbatch jobs to directory

SYNOPSIS
gbch-cjlist [ -D dir ] [ -v n ] [ -e n ] [ -u ] [ -s ] [ -f ] job file outfile workdir

DESCRIPTION
gbch-cjlist converts GNUbatch job files held in the batch spool directory to an executable shell script which may be used to recreate them. This may be useful for backup purposes or for one stage in upgrading from one release of GNUbatch to another.

The jobs are copied into the backup directory workdir, and the generated shell script file outfile refers to files in that directory.

gbch-cjlist understands the format of the saved job file for versions of GNUbatch and Xi-Batch going back to release 5, and when presented with a saved file, will attempt to work out from the format which release it relates to. If required, it will skip apparent errors in the job file.

In addition to options, three arguments are always supplied to gbch-cjlist.

Job list file
    This is the file containing the attributes of the jobs, btsched_jfile in the spool directory.

Output file
    This file is created by gbch-cjlist to contain the executable shell script which may be used to create the jobs.

Backup directory
    This directory is used to hold the job data.

Note that saved jobs make use of the -U option to gbch-r(1) to set the ownership correctly.

OPTIONS

-D directory
    Specifies the source directory for the jobs and job file rather than the current directory. 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-cjlist -D '${SPOOLDIR-/var/spool/gnubatch}' ...

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

-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 (invalid strings etc) in the saved job file up to the number of total errors given by the -e option. Offending jobs are skipped.

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

-u  Do not check user names in the saved job file.

-v number
    Tell gbch-cjlist that the job file is for release number of Xi-Batch, where number is 5 to 6.

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

SEE ALSO
gbch-ciconv(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.