Return to bscbatch.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / usr.bin / bsc / doc

Power 6/32 Unix version 1.21

.TH BSCBATCH 1C 1.4 DLBA
.SH NAME 
bscbatch \- BISYNC Batch Job Submission and Query
.SH SYNOPSIS
.I
bscbatch [-to=hostname] [-copy] [-mail] [-transp] [file ...]
.br
.I
bscbatch -q[=hostname] [-t=time] [-l=lines]
.br
.SH DESCRIPTION 
.P
The 
.I bscbatch 
utility is used to submit files to the BISYNC daemon 
.I (bscd) 
for transmission to a
host, and to search among files received from a specific host for
a particular file.
.SS "Sending Files."
.P
The first form of invocation queues files or the standard input for
sending to a specific host 
.I (hostname), 
or to the
.I default 
host.  Ordinarily, if file names are specified instead of standard input,
.I bscbatch 
will queue the files by name; the
.I -copy 
parameter forces 
.I bscbatch 
to make a copy of the file as is.  The 
.I -mail 
flag instructs the BISYNC daemon to
send mail to the invoker upon successful completion of transmission;
normally, mail is only sent if there is a problem in the transmission.
The 
.I -transp 
flag forces transmission of the file
in transparent mode; usually, the daemon checks the file as it is
being transmitted to see if it contains any control characters which
would force it to be sent in transparent mode.
.P
Specifying multiple files to 
.I bscbatch 
has the same effect as specifying one file per
.I bscbatch 
invocation -- the files will be sent
as individual files. In order to send several files together as one
file, one may use:
.br
     cat file1 file2 ... | bscbatch
.br
.SS "Receiving Files."
.P
The second form of invocation is used to search files received from
a specific host for one belonging to the invoker. Unless an installation
exit has been supplied (see 
.I batch(8)) 
which can
tell one user's output from another, received files will be left
for a period of time (determined by the system administrator) in
the BISYNC daemon's spool area for that host; if this is the case,
users should use this form of invocation to locate their files and
either link to or copy those files.
.P
The 
.I -q 
parameter indicates this is a search operation.
The host name is optional; as in sending files, there is a default
host.
The 
.I -t=hh[mm] 
parameter is used to limit the search to those files received within the last 
.I hh 
hours (and, optionally,
.I mm 
minutes). The default is to display all files received from that host.
.P
When invoked in the search mode, the name and
first few lines of each file
received (according to any time limits set via -t) are displayed.
The default is to display 20 lines; this may be overridden via the
.I -l=lines 
parameter.
.I Bscbatch 
stops after each display and displays the message:
.IP
">>>> Rename? (Y/N): "
.LP
This gives the invoker a chance to examine the file. 
The invoker may enter Y, to rename the file, or N, to go on to the
next file. 
.I Bscbatch
displays the message:
.IP
">>>> Press Return to Continue <<<<"
.P
and waits for a newline from standard input before continuing if the invoker
enters N.
.P
If the file is to be renamed,
.I bscbatch
displays the message:
.IP
">>>> Enter New File Name: "
.LP
The new file name may then be entered. 
.I Bscbatch
checks whether or not the file already exists, asking whether it should be
overwritten if it does. If the file doesn't exist or it's okay to overwrite
it, the message:
.IP
">>>> Verify move <old file name> to <new file name> (y/n):"
.LP
is displayed. If y is entered, the file is renamed. 
.I Bscbatch
then displays the message
.IP
">>>> Press Return to Continue <<<<"
.LP
and waits
for a newline entry from standard input. 
When the invoker has processed the proper file(s),
.I bscbatch 
may be interrupted.
.SH FILES
.TP
/usr/lib/bscbatch/<host>
Host configuration parameters
.TP
/usr/spool/bscbatch/<host>/C*
Transmission control file
.TP
/usr/spool/bscbatch/<host>/D*
Data file to be sent, if -copy specified or standard input used
.TP
/usr/spool/bscbatch/<host>/P*
Files received from host
.TP
/usr/spool/bscbatch/<host>/AUDIT
Optional audit trail entry made when file(s) submitted
.SH "SEE ALSO"
.IP bscpr(1c)
batch file print utility
.IP bsclog(8)
batch audit trail utility
.IP batch(8)
BISYNC batch facility
.SH DIAGNOSTICS
.P
bscbatch: host <hostname> unknown.
.IP
The host name mentioned in the 
.I -to= 
or the
.I -q= 
parameter was not found in /usr/lib/bscbatch.
Contact the system administrator for a list of valid host names.
.P
bscbatch: can't create <filename>.
.IP
An attempt to create the mentioned file in the host's spool area
was unsuccessful. Contact the system administrator; directory modes
or permissions are awry.
.P
bscbatch: don't know who you are!
.IP
The password file was searched for your user number so that your
name would be known for any necessary mail.  Either you aren't in
the password file, or 
.I bscbatch 
can't read it.
.P
bscbatch: file <filename> not found.
.IP
The named file was given as a parameter, but does not seem to exist.
General read permission should probably be available on the file
so that the BISYNC daemon can read it.
.P
bscbatch: host <hostname> can't receive transparent files.
.IP
The 
.I -transp 
flag was specified, however, according to the host's configuration file,  
the named host can't receive transparent files.
.P
bscbatch: file system nearly full. Response file from host may be
delayed.
.IP
The system administrator has specified a minimum amount of space
which should be available on the file system before any receive activity
takes place. The file system is nearly down to that minimum level,
so the daemon could be forced to refuse from the host if the situation
gets worse. This is a warning only.
.P
bscbatch: can't copy your files -- file system too full.
.IP
See the preceeding message. There is less than the minimum amount
of free space left in the file system, so your files can't be copied
to the host's spool area. You may, however, be able to queue your
file(s) by giving an explicit file name and no copy option.
.P
bscbatch: not a number (<flag>)
.IP
The 
.I -t 
or 
.I -l 
parameters require
numeric values. What was given (shown in parentheses) was not numeric.
.P
bscbatch: unrecognized option (<flag>)
.IP
The parameter shown in parentheses was not one from those shown in the
SYNOPSIS.
.P
bscbatch: options -copy, -mail, and -transp can't be used with -q
.P
bscbatch: options -l and -t can't be used with -to
.IP
The 
.I -t 
and 
.I -l 
parameters cannot be used except with 
.I -q 
specified.
The 
.I
-copy, -mail, -to, -transp, 
and
.I file 
parameters may not be used with
.I -q 
specified.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.