uustat(1C) USER COMMANDS uustat(1C)
NAME
uustat - uucp status inquiry and job control
SYNOPSIS
uustat [-q] or [-m] or [-kjobid [-n]] or [-rjobid [-n]] or
[-p]
uustat [-a] [-ssystem [-j]] [-uuser] [-Sqric]
uustat -tsystem [-dnumber] [-c]
DESCRIPTION
uustat functions in the following three areas: displays the
general status of, or cancels, previously specified uucp
commands; provides remote system performance information, in
terms of average transfer rates or average queue times; pro-
vides general remote system-specific and user-specific
status of uucp connections to other systems.
Here are the options that obtain general status of, or can-
cel, previously specified uucp commands; uustat allows only
one of these options to appear on each uustat command line
execution:
-a List all jobs in queue.
-j List the total number of jobs displayed. The -j
option can be used in conjunction with the -a or
the -s option.
-kjobid Kill the uucp request whose job identification is
jobid. The killed uucp request must belong to the
person issuing the uustat command unless one is
the super-user or uucp administrator. If the job
is killed by the super-user or uucp administrator,
electronic mail is sent to the user.
-m Report the status of accessibility of all
machines.
-n Suppress all standard out output, but not standard
error. The -n option is used in conjunction with
the -k and -r options.
-p Execute the command ps -flp for all the process-
ids that are in the lock files.
-q List the jobs queued for each machine. If a
status file exists for the machine, its date, time
and status information are reported. In addition,
if a number appears in parentheses next to the
number of C or X files, it is the age in days of
the oldest C./X. file for that system. The Retry
field represents the number of hours until the
Last change: Basic Networking Utilities 1
uustat(1C) USER COMMANDS uustat(1C)
next possible call. The Count is the number of
failure attempts. NOTE: for systems with a
moderate number of outstanding jobs, this could
take 30 seconds or more of real-time to execute.
Here is an example of the output produced by the
-q option:
eagle 3C 04/07-11:07 NO DEVICES AVAILABLE
mh3bs3 2C 07/07-10:42 SUCCESSFUL
The above output tells how many command files are
waiting for each system. Each command file may
have zero or more files to be sent (zero means to
call the system and see if work is to be done).
The date and time refer to the previous interac-
tion with the system followed by the status of the
interaction.
-rjobid Rejuvenate jobid. The files associated with jobid
are touched so that their modification time is set
to the current time. This prevents the cleanup
daemon from deleting the job until the jobs'
modification time reaches the limit imposed by the
daemon.
Here are the options that provide remote system performance
information, in terms of average transfer rates or average
queue times; the -c and -d options can only be used in con-
junction with the -t option:
-tsystem Report the average transfer rate or average queue
time for the past 60 minutes for the remote sys-
tem. The following parameters can only be used
with this option:
-dnumber number is specified in minutes. Used to override
the 60 minute default used for calculations.
These calculations are based on information con-
tained in the optional performance log and there-
fore may not be available. Calculations can only
be made from the time that the performance log was
last cleaned up.
-c Average queue time is calculated when the -c
parameter is specified and average transfer rate
when -c is not specified. For example, the com-
mand
uustat -teagle -d50 -c
produces output in the following format:
Last change: Basic Networking Utilities 2
uustat(1C) USER COMMANDS uustat(1C)
average queue time to eagle for last 50 minutes:
5 seconds
The same command without the -c parameter produces
output in the following format:
average transfer rate with eagle for last 50
minutes: 2000.88 bytes/sec
Here are the options that provide general remote system-
specific and user-specific status of uucp connections to
other systems. Either or both of the following options can
be specified with uustat. The -j option can be used in con-
junction with the -s option to list the total number of jobs
displayed:
-ssystem Report the status of all uucp requests for remote
system system.
-uuser Report the status of all uucp requests issued by
user.
Output for both the -s and -u options has the following for-
mat:
eagleN1bd7 4/07-11:07 S eagle dan 522 /home/dan/A
eagleC1bd8 4/07-11:07 S eagle dan 59 D.3b2al2ce4924
4/07-11:07 S eagle dan rmail mike
With the above two options, the first field is the jobid of
the job. This is followed by the date/time. The next field
is an S if the job is sending a file or an R if the job is
requesting a file. The next field is the machine where the
file is to be transferred. This is followed by the user-id
of the user who queued the job. The next field contains the
size of the file, or in the case of a remote execution
(rmail is the command used for remote mail), the name of the
command. When the size appears in this field, the file name
is also given. This can either be the name
given by the user or an internal name (e.g., D.3b2alce4924)
that is created for data files associated with remote execu-
tions (rmail in this example).
-Sqric Report the job state: q for queued jobs, r for
running jobs, i for interrupted jobs, and c for
completed jobs.
A job is queued if the transfer has not started.
A job is running when the transfer has begun. A
job is interrupted if the transfer began but was
terminated before the file was completely
transferred. A completed job, of course, is a job
Last change: Basic Networking Utilities 3
uustat(1C) USER COMMANDS uustat(1C)
that successfully transferred. The completed
state information is maintained in the accounting
log, which is optional and therefore may be una-
vailable. The parameters can be used in any com-
bination, but at least one parameter must be
specified. The -S option can also be used with -s
and -u options. The output for this option is
exactly like the output for -s and -u except that
the job states are appended as the last output
word. Output for a completed job has the follow-
ing format:
eagleC1bd3 completed
When no options are given, uustat outputs the status of all
uucp requests issued by the current user.
FILES
/var/spool/uucp/* spool directories
/var/uucp/.Admin/account accounting log
/var/uucp/.Admin/perflog performance log
SEE ALSO
uucp(1C).
DIAGNOSTICS
The -t option produces no message when the data needed for
the calculations is not being recorded.
NOTES
After the user has issued the 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
made ,uustat reports a file size of -99999. This job will
eventually fail because the file(s) to be transferred can
not be found.
Last change: Basic Networking Utilities 4