uubatch

Section: User Commands (1)
Updated: local
Index Return to Main Contents
 

NAME

uubatch - mail jobs batcher  

SYNOPSIS

uubatch [ -c ] [ -B n ] [ -C n ] [ -S n ] [ -T n ] node { [ node2 ] ... }  

DESCRIPTION

This program will attempt to batch the given uucp nodes' queued jobs into uudebat or uucdebat jobs. It takes care of the entire batching process including uucp locking (via an external uucplock program).

External uubatch program binaries (specificaly uucplock) are assumed be runnable with the same path header uubatch was run with (as parsed from argv[0]). This means that uucplock should usually be in the same directory as uubatch.

The program scans each spool directory for C.<> files, which are taken as the names of jobs to consider for batching (if they meet the batching criteria below). Each queued job will be examined to see if the job should be batched. If a job need not be batched then the program simply skips over it. If the job needs to be batched, and the batching succeeds and the batch is sccessfully uuxe'd, the job's data files are deleted.  

BATCHING CRITERIA

rmail jobs with Data less than MAX_BYTES bytes and more than min_time_before_batch min. old will be batched.

uudebat jobs with Data less than MAX_BYTES and more than min_time_before_batch min. old will be batched.

uucdebat jobs with compressed data less than MAX_CBYTES and more than min_time_before_batch min. old will be batched.

Only jobs created more than min_time_before_batch ago are considered for batching, to avoid possible locking problems.

Batching will ONLY be done if at least one rmail job is encountered in the node's spool directory. This saves on unneeded re-batching of uudebat and uucdebat jobs.  

OPTIONS

-c
compression on (default is off)
-B n
MAX_BYTES = n (default DF_MAX_BYTES)
MAX_BYTES is the maximum size (in bytes) of an rmail message or a uudebat job that may be added to a batch Jobs larger than this parameter are not batched.
-C n
MAX_CBYTES = n (default DF_MAX_CBYTES)
MAX_FILE_CBYTES is the maximum size (in bytes) of a uucdebat job's compressed data file that may be added to a batch. uucdebat jobs with compressed data files larger than this parameter are not rebatched.
-S n
CRITICAL_SIZE = n (default DF_CRITICAL_SIZE)
CRITICAL_BATCH_SIZE is the batch size (in bytes) after which we send the batch off and start a new one. Be aware of the fact that the actual MAXIMUM batch size is actually the greater one of :
CRITICAL_BATCH_SIZE + MAX_BYTES_FOR_BATCH
CRITICAL_BATCH_SIZE + uncompressed(MAX_CBYTES_FOR_BATCH)
-T n
min_time_before_batch = n seconds (defaults to MIN_TIME_BEFORE_BATCH)
This is the age of a job (in seconds) before it may be considered for batching.
 

DIAGNOSTICS

uubatch Diagnostic n s

uubatch Error n s

[5]
jobname too long.
[10]
jobname must be C.<jobid>
[15]
Can't open specified job file
[20]
Only one line in command file
[25]
No lines in command file
[30]
Oops, no S in line 1 of command file.
[35]
Oops, no S in line 2 of command file.
[40]
X. data file name too long.
[45]
Can't open X. data file.
[50]
Too many lines in X. data file.
[55]
No rmail, uudebat or uucdebat in X. data file...
[60]
More than one rmail or uudebat, I won't do it!
[65]
D. data file name too long.
[70]
Can't open D. data file.
[75]
Data file is too new ( n sec), next time maybe.
[78]
Cannot cd to node's spool directory
(Remember that uuclean on some systems removes empty uucp spool directories of valid uucp nodes).

[80]
file to big, not put in batch.
[82]
Can't open temporary batch file
[85]
error closing batch file
[90]
Can't open temporary batch file
[93]
error while uncompressing/appending batch
[95]
error closing batch file
[100]
No rmail jobs, skip batching.
[110]
unlock failed on node
[112]
Oops, no space after first file name in command file.
[113]
Oops, wrong remote name prefix in command file.
[114]
Oops, remote file name with no end in command file...
[115]
error while uux'ing batch
[120]
lock failed on node
[122]
error while removing batch file
[125]
error while deleting batched files
 

SEE ALSO

uudebat(1) uucplock(1) uubatch(4)  

CURRENT VERSION

1.0.5  

AUTHORS

Gil Tene
devil@HellNet.org
Baruch Cochavy
blue@dduster.HellNet.org
 

BUGS

Bugs ? What bugs ?


 

Index

NAME
SYNOPSIS
DESCRIPTION
BATCHING CRITERIA
OPTIONS
DIAGNOSTICS
SEE ALSO
CURRENT VERSION
AUTHORS
BUGS

This document was created by man2html, using the manual pages.
Time: 13:00:26 GMT, November 04, 2024