Return to bsclog.8 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 BSCLOG 8 1.2 DLBA
\" @(#)bsclog.8	1.2
.SH NAME 
bsclog \- BISYNC Batch Audit Trail Utility
.SH SYNOPSIS 
.nf
.I
bsclog hostname [-purge=dd] [-from=[yymmdd]hhmm]
.I
	        [-to=[yymmdd]hhmm]
.I
                [-class=cccc] [-user=uuuu]
.fi
.SH DESCRIPTION 
.P
The 
.I bsclog 
utility is used to selectively
print audit trail information and to purge old information from
the file to keep the size of the file to reasonable limits.
.P
A 
.I hostname 
must be specified. The primary audit trail
file is named /usr/spool/bscbatch/<hostname>/AUDIT.
Other audit trail files containing auxiliary information may be
present in the same directory;
they will be named AUDIT.nnnnn, where nnnnn is a number.
Auxiliary audit trail files may be created if the primary file is locked; 
.I bsclog 
will automatically merge these files with the primary files and
remove the auxiliary files when it is invoked.
.P
The 
.I -purge 
option is used to purge from the audit trail file any entries over 
.I dd 
days old.
If this option is selected, printing of the audit trail will not
occur.
.P
The remaining parameters are associated with the selective printing
of the audit trail file.
They may not be used if the 
.I -purge
parameter is selected.
The 
.I -from 
and 
.I -to 
parameters
are used to select a time interval from which audit entries are to
be printed.
The 
.I yymmdd 
part of the parameter is used to select a year, month, and day;
default is the current date.
The 
.I hhmm 
part selects a particular hour and minute.
If 
.I -from 
is not given, the beginning of time is
used for the beginning of the time interval; if 
.I -to
is not given, the end of time is used.
The 
.I -user 
parameter is used to select entries made while a file was being sent
which belonged to a specific user (with id 
.I uuuu).
Information on the user for files being received is not
available at the time the file is being received, and thus does not
appear in the audit trail. If 
.I -user 
is not specified,
no selection of particular users is made and thus all entries print.
.P
Each entry in the audit trail has a single character
class code, as shown in the list of audit trail messages to follow.
Selection of specific class codes may be performed with the
.I -class 
parameter, for example,
.I -class=ct 
selects records of class 'c' and 't',
which corresponds to information on connections and statistics.
.SH "AUDIT TRAIL MESSAGES"
.P
Each message below is preceded by its message class in {}'s.
.P
{C} Ready for connect via <devname>
.IP
Written just before calling the
.I connect 
routine (see bscbatch(8)) and opening <devname>.
.P
{C} Connected [- host id is <ident>]
.IP
Connection to host is complete.
If the host supplied an identification as part of its bid response,
the identification is shown.
.P
{C} Connection failed - <reason>
.IP
Reasons include:
.RS
.TP
Bid count exceeded
(host probably dead)
.TP
Modem failure
(no CTS, or no TxC - check cables and jumpers)
.TP
Wrong host name (<hostid>)
(wrong host called)
.RE
.P
{S} Sending SIGNON file <filename>
.IP
The installation-specified 'signon' file is being sent.
.P
{S} Transmission of <filename> ([transparent,] nnnnn bytes) begun
.IP
The file's length in bytes is shown.
If the file was sent in transparent mode, that information is shown.
.P
{S} Transmission of <filename> completed (nnn blocks)
.IP
The actual number of blocks sent is shown.
.P
{S} Transmission of <filename> aborted, <reason>
.IP
Reasons include:
.RS
.TP
Error reading file
.TP
Retry limit exceeded
(transmission error or host dead)
.TP
WACK limit exceeded
(host delays)
.TP
Line disconnect
(modem dropped DSR)
.TP
Modem error
(no clock, or no CTS)
.TP
Protocol error
.TP
RVI abort
.TP
Bid limit exceeded
(host may be dead)
.TP
Host aborted transmission
(host sent EOT)
.RE
.P
{T} EOT, sent nnn blocks, did nnn TTDs, had nnn NAKs, nnn timeouts, nnn WACKs.
.IP
The number of blocks successively transmitted is shown,
along with statistics as to the number of times transmission was
delayed (TTDs), number of noise errors (NAKs), number of times there
was no response (usually due to noise as well), and the number of
times the remote host was temporarily not prepared to take additional
data (WACKs).
.P
{R} Receiving <type> file[, transparent mode]
.IP
A file is being received; 
.IR <type> is print or punch
If the file is being sent in transparent mode, it is so indicated.
.P
{R} Receiving complete (nnnnn bytes, nnn blocks), assigned to file <filename>
.IP
The number of blocks received is shown, as well as the number of
bytes placed into file <filename>. The filename given is the one
returned by the installation 
.I asgnfile 
exit routine, see batch(8).
.P
{R} Receiving aborted, <reason>
.IP
Reasons include:
.RS
.TP
Error writing file
.TP
Protocol error
.TP
NAK limit exceeded
(noise errors)
.TP
TTD limit exceeded
(host may be dead)
.TP
Line disconnect
(modem dropped DSR)
.TP
Modem failure
(no CTS or no TxC)
.TP
Early EOF
(host sent EOT before last block)
.RE
.P
{T} EOT, received nnn blocks, did nn WACKs and nn NAKs, had nn TTDs, nn overruns.
.IP
The number of blocks successfully received is shown, along with statistics
as to the number of times this system had to request that the remote
host delay transmission of the next block (WACK), the number of noise
errors (NAKs), number of times the remote host delayed transmission
(TTDs), and the number of times incoming characters arrived faster
than they could be processed, which indicates this system was heavily
I/O loaded.
.P
{D} Disconnected, <reason>
.IP
Reasons include:
.RS
.TP
Line disconnected
(modem dropped DSR)
.TP
Inactivity timeout
.TP
Host signalled disconnect
(Host sent DLE-EOT sequence)
.RE
.P
{D} Sending SIGNOFF file <filename>
.P
The installation-specified termination file is being sent.
.SH "SEE ALSO"
.nf
.ta .8i 2.5i
bscbatch(8)	- batch file submission / queue query
bscpr(1C)	- batch file print utility
batch(8)	- BISYNC Batch Terminal Emulation
.fi
.SH DIAGNOSTICS
.P
bsclog: <hostname> has no spool directory
.IP
Either the given host name is not a valid one, or it has no spool
directory (/usr/lib/bscbatch/<hostname>).
.P
bsclog: <hostname> has no AUDIT file
.IP
There is no file /usr/lib/bscbatch/<hostname>/AUDIT.
If one does not exist, no auditing is performed.
This message also occurs if the file exists,
but can't be opened for read and write.
.P
bsclog: not a numeric value (<flag>)
.IP
The parameter shown (<flag>) is supposed to have a numeric parameter.
.P
bsclog: no data meets selection requirements
.IP
None of the records in the audit trail file matches the selection
requirements as given.
.P
bsclog: can't create temporary file
.IP
The temporary file which is to hold the result of the purge cannot be created.
It would go in /usr/spool/bscbatch/<hostname>.
.P
bsclog: can't combine audit files -- sort failure
.IP
The 
.I sort(1) 
utility is used to merge auxiliary
audit files with the primary audit file.
The sort could not be properly executed;
the data in the auxiliary files will not be combined with
the primary file at this time.

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