uustat(1C) uustat(1C)
NAME
uustat - uucp status inquiry and job control
SYNOPSIS
uustat [-q]
uustat [-m]
uustat [-kjobid [-n]]
uustat [-rjobid [-n]]
uustat [-p]
uustat [-a [-j]] [-uuser] [-Sqric]
uustat [-ssystem [-j]] [-uuser] [-Sqric]
uustat -tsystem [-dnumber] [-c]
DESCRIPTION
The uustat command 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.
Files
/var/spool/uucp/* spool directories
/var/uucp/.Admin/account accounting log
/var/uucp/.Admin/perflog performance log
/usr/lib/locale/locale/LC_MESSAGES/uxbnu.abi
language-specific message file
[See LANG on environ(5).]
Diagnostics
The -t option produces no message when the data needed for the
calculations is not being recorded.
USAGE
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 can only be used in conjunction with the -a
or the -s option.
Copyright 1994 Novell, Inc. Page 1
uustat(1C) uustat(1C)
-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.
The machine names are listed in collated order.
[The collation order is derived from LC_COLLATE, see
LANG on environ(5) and sort(1).]
-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 that, for systems with a moderate
number of outstanding jobs, this could take 30
seconds or more of real-time to execute. The
machine names are listed in collated order. [The
collation order is derived from LC_COLLATE, see LANG
on environ(5) and sort(1).] 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 interaction with the
system followed by the status of the interaction.
Copyright 1994 Novell, Inc. Page 2
uustat(1C) uustat(1C)
-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 only be used in
conjunction with the -s or -a option to list the total number
of jobs displayed:
Copyright 1994 Novell, Inc. Page 3
uustat(1C) uustat(1C)
-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
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 (for example, 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
Copyright 1994 Novell, Inc. Page 4
uustat(1C) uustat(1C)
When no options are given, uustat outputs the status of all
uucp requests issued by the current user.
Warnings
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.
REFERENCES
environ(5), sort(1), uucp(1C)
Copyright 1994 Novell, Inc. Page 5