uustat(1C) UNIX System V(Basic Networking Utilities) 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; provides general remote system-specific and
user-specific status of uucp connections to other systems.
Here are the options that obtain general status of, or cancel, 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 must 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 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
10/89 Page 1
uustat(1C) UNIX System V(Basic Networking Utilities) uustat(1C)
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 interaction
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 conjunction with the -t option:
-tsystem Report the average transfer rate or average queue time for the
past 60 minutes for the remote system. 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 contained in the optional performance log and
therefore 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 command
uustat -teagle -d50 -c
produces output in the following format:
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 conjunction with the -s option to list the total
number of jobs displayed:
-ssystem Report the status of all uucp requests for remote system
system.
Page 2 10/89
uustat(1C) UNIX System V(Basic Networking Utilities) uustat(1C)
-uuser Report the status of all uucp requests issued by user.
Output for both the -s and -u options has the following format:
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 executions (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
that successfully transferred. The completed state information
is maintained in the accounting log, which is optional and
therefore may be unavailable. The parameters can be used in
any combination, 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 following 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.
10/89 Page 3
uustat(1C) UNIX System V(Basic Networking Utilities) uustat(1C)
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.
Page 4 10/89