uustat(1) uustat(1)
NAME
uustat - uucp status inquiry and job control
SYNOPSIS
uustat[ option] Format 1
uustat[ -a][ -j][ -s system][ -S status][ -u user] Format 2
uustat -t system[ -d number][ -c] Format 3
DESCRIPTION
uustat is used to control uucp jobs and to obtain general information
on uucp connections. It can display the general status of previously
issued uucp commands and can also cancel such commands. It can provide
up-to-date performance information (such as average transfer rates and
queue times) or general remote system-specific and user-specific
status information on uucp connections to other systems.
OPTIONS
No option specified:
uustat displays the status of all uucp requests issued by the
invoking user.
Format 1: Job control and process data
uustat -q
uustat -m
uustat -p
uustat -k jobid[ -n]
uustat -r jobid[ -n]
You may specify only one of the combinations listed above.
-q Lists the jobs queued up for each system. If a status file exists
for a system, its date, time and status information are reported.
If a number appears next to the number of C. or X. files, it
refers to the age in days of the oldest C. or X. file for that
system.
The Retry field shows the number of hours until the next call is
possible.
The Count field indicates the number of failed attempts to make
the call.
Note: For systems with a moderate number of outstanding jobs,
this could take 30 seconds or more (real time) to execute.
Page 1 Reliant UNIX 5.44 Printed 11/98
uustat(1) uustat(1)
-m Shows the accessibility status of all connected systems.
-p Executes the command ps -flp (to list detailed process data) for
all the process IDs that are in the lock files.
-k jobid
uustat kills the uucp process identified by jobid, provided you
are the owner of the original uucp request. The system adminis-
trator and the uucp administrator can kill jobs originated by
other users; if this happens, the job originator is informed by
mail.
-n Suppresses all output to standard output but does not affect
standard error output. You should use this option in conjunction
with the -k and -r options.
-r jobid
Resets the time of last modification of files associated with
jobid to the current time. This prevents the cleanup daemon from
deleting an unmodified job because it is too old.
Format 2: System status messages
uustat[ -a][ -j][ -s system][ -S status][ -u user]
-a Lists all the jobs in the queue.
-j Lists the total number of jobs displayed. This option must be
used in conjunction with the -a or -s option.
-s system
Reports the status of all uucp requests for remote system system.
In conjunction with the -j this option causes the total number of
jobs to be displayed.
-S status
Specifies the job status. status can be any, all or none of the
following:
q (q - queued) for jobs which have been queued. A job is queued
if the transfer has not yet started.
r (r - running) for jobs which are running. A job is said to be
running once the transfer has started.
i (i - interrupted) for jobs which have been interrupted. A job
is interrupted if the transfer began but was terminated before
the job was successfully completed.
c (c - completed) for jobs which have been successfully trans-
ferred.
Page 2 Reliant UNIX 5.44 Printed 11/98
uustat(1) uustat(1)
The completed status information is held in the accounting data
log file /var/uucp/.Admin/account. This file is not created
automatically and therefore cannot simply be assumed to exist.
The parameters may be used in any combination, but at least one
must be selected.
The -S option can be combined with the -s and -u options. The
output is then the same as -s and -u, except that the job states
appear in the last column.
-u user
This options reports on the status of all uucp requests issued by
user.
Format 3: Remote system performance data
uustat -t system[ -d number][ -c]
Note when troubleshooting that the -t option does not produce any mes-
sage to warn you that the data needed for the calculations is not
being recorded.
-t system
Reports the average transfer rate for remote system system.
-c This option can only be used in conjunction with the -t option.
If -c is used, the average queue time is calculated. If -c is not
used, the average transfer rate is calculated.
-d number
This option can only be used in conjunction with the -t option.
number is specified in minutes. If set, it overrides the default
value of 60 minutes used for calculating the averages. The calcu-
lations are based on data from the optional performance log
var/uucp/.Admin/perflog. This data, and hence the calculations,
may not always be available. Calculations must be based on data
which has accumulated since the last time the performance log was
cleaned up.
Please note:
uustat reports a file size of -99999 after a user has issued a uucp
request if the file to be transferred is moved or deleted or was not
copied to the spool directory with the -C option when the uucp request
was issued. A job like this will fail because the file or files to be
transferred cannot be found.
Page 3 Reliant UNIX 5.44 Printed 11/98
uustat(1) uustat(1)
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed.
The LCTIME environment variable governs the format of date and time
strings.
If LCMESSAGES or LCTIME is undefined or is defined as the null
string, it defaults to the value of LANG. If LANG is likewise unde-
fined or null, the system acts as if it were not internationalized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
If any of the locale variables has an invalid value, the system acts
as if none of the variables were set.
EXAMPLES
The command
$ uustat -t eagle -d 50 -c
generates output in the following form:
Last change: Basic Network Utilities
average queue time to eagle for last minutes:
5 seconds
Combining the -c option with the -t option causes the average queue
time for system eagle to be reported (5 seconds).
The output generated by the same command without the -c option is:
average transfer rate with eagle for last 50 minutes:
2000.88 bytes/sec
Output for the -s and -u options is in the following format:
eagleN1bd7 4/07-11:07 S eagle dan 522 /home/dan/A
eagleN1bd7 4/07-11:07 S eagle dan 59 D.3b2a12ce4924
4/07-11:07 S eagle dan rmail mike
The columns in the output contain the following information:
Column 1: job identification number
Column 2: date and time
Page 4 Reliant UNIX 5.44 Printed 11/98
uustat(1) uustat(1)
Column 3: S = sending a file
R = requesting a file
Column 4: destination system
Column 5: login name of the user who issued the job
Column 6: file size (in bytes) or indication of remote execution
(rmail)
Column 7: file name
If column 6 shows the file size, column 7 shows the name given by the
user (e.g. /home/dan/A) or an internal name (such as D.3b2a12ce4924)
which the system generates for files associated with remote execution
(in this case the rmail command).
FILES
var/spool/uucp/*
Spool directories
var/uucp/.Admin/account
Accounting log
var/uucp/.Admin/perflog
Performance log
SEE ALSO
uucp(1).
Page 5 Reliant UNIX 5.44 Printed 11/98