uustat(1C) uustat(1C)
NAME
uustat - uucp status inquiry and job control
SYNOPSIS
uustat [-chour] [-jjobn] [-kjobn] [-mmch] [-Mmch] [-ohour]
[-O] [-q] [-rjobn] [-ssys] [-uuser] [-yhour]
DESCRIPTION
uustat will display the status of, or cancel, previously
specified uucp commands, or provide general status on uucp
connections to other systems. The following flag options
are recognized:
-jjobn Report the status of the uucp request jobn. If all
is used for jobn, the status of all uucp requests is
reported. An argument must be supplied otherwise the
usage message will be printed and the request will
fail.
-kjobn Kill the uucp request whose job number is jobn. The
killed uucp request must belong to the person issuing
the uustat command unless one is the super-user.
-rjobn Rejuvenate jobn. That is, jobn is touched so that
its modification time is set to the current time.
This prevents uuclean from deleting the job until the
jobs modification time reaches the limit imposed by
uuclean.
-chour Remove the status entries which are older than hour
hours. This administrative option can only be
initiated by the user uucp or the super-user.
-uuser Report the status of all uucp requests issued by
user.
-ssys Report the status of all uucp requests which
communicate with remote system sys.
-ohour Report the status of all uucp requests which are
older than hour hours.
-yhour Report the status of all uucp requests which are
younger than hour hours.
-mmch Report the status of accessibility of machine mch.
If mch is specified as all, then the status of all
machines known to the local uucp are provided.
-Mmch This is the same as the -m option except that two
times are printed. The time that the last status was
obtained and the time that the last successful
transfer to that system occurred.
-O Report the uucp status using the octal status codes
listed below. If this option is not specified, the
verbose description is printed with each uucp
request.
-q List the number of jobs and other control files
queued for each machine and the time of the oldest
and youngest file queued for each machine. If a lock
file exists for that system, its date of creation is
Page 1 (last mod. 1/16/87)
uustat(1C) uustat(1C)
listed.
When no options are given, uustat outputs the status of all
uucp requests issued by the current user. Note that only
one of the flag options -j, -m, -k, -c, -r, can be used with
the rest of the other options.
For example, the command:
uustat -uhdc -smhtsa -y72
will print the status of all uucp requests that were issued
by user hdc to communicate with system mhtsa within the last
72 hours. The meanings of the job request status are:
job-number user remote-system command-time status-time
status
where the status may be either an octal number or a verbose
description. The octal code corresponds to the following
description:
OCTAL STATUS
000001 the copy failed, but the reason cannot be
determined
000002 permission to access local file is denied
000004 permission to access remote file is denied
000010 bad uucp command is generated
000020 remote system cannot create temporary file
000040 cannot copy to remote directory
000100 cannot copy to local directory
000200 local system cannot create temporary file
000400 cannot execute uucp
001000 copy (partially) succeeded
002000 copy finished, job deleted
004000 job is queued
010000 job killed (incomplete)
020000 job killed (complete)
The meanings of the machine accessibility status are:
system-name time status
where time is the latest status time and status is a self-
explanatory description of the machine status.
FILES
/usr/bin/uustat
/usr/spool/uucp spool directory
/usr/lib/uucp/Lstat
system status file
/usr/lib/uucp/Rstat
Page 2 (last mod. 1/16/87)
uustat(1C) uustat(1C)
request status file
SEE ALSO
uucp(1C).
``Using UUCP'' in Oreo Communications User's Guide.
Page 3 (last mod. 1/16/87)