uustat(1C) Communication Commands uustat(1C)NAMEuustat - uucp status inquiry and job control
SYNOPSISuustat
[ [-m] | [-p] | [-q] | [-k jobid [-n]] | [-r jobid [-n]]]
uustat [-a] [-s system [-j]] [-u user] [-S qric]
uustat-t system [-c] [-d number]
DESCRIPTION
The uustat utility functions in the following three areas:
1. Displays the general status of, or cancels, previously spec‐
ified uucp commands.
2. Provides remote system performance information, in terms of
average transfer rates or average queue times.
3. Provides general remote system-specific and user-specific
status of uucp connections to other systems.
OPTIONS
The following options are supported:
General Status
These options obtain general status of, or cancel, previously speci‐
fied uucp commands:
-a Lists all jobs in queue.
-j Lists the total number of jobs displayed. The -j option can
be used in conjunction with the -a or the -s option.
-kjobid Kills the uucp request whose job identification is jobid.
The killed uucp request must belong to the user issuing the
uustat command unless the user 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 Reports the status of accessibility of all machines.
-n Suppresses all standard output, but not standard error. The
-n option is used in conjunction with the -k and -r options.
-p Executes the command ps -flp for all the process-ids that
are in the lock files.
-q Lists the jobs queued for each machine. If a status file
exists for the machine, its date, time and status informa‐
tion 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. An example of the output produced by the -q option
is:
eagle 3C 04/07-11:07 NO DEVICES AVAILABLE
mh3bs3 2C 07/07-10:42 SUCCESSFUL
This indicates the number of command files that 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 Rejuvenates jobid. The files associated with jobid are
touched so that their modification time is set to the cur‐
rent time. This prevents the cleanup daemon from deleting
the job until the jobs' modification time reaches the limit
imposed by the daemon.
Remote System Status
These options 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 Reports 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:
-c Average queue time is calculated when the -c parameter is
specified and average transfer rate when -c is not speci‐
fied. For example, the command:
example% 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
-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 perfor‐
mance log and therefore may not be available. Calculations
can only be made from the time that the performance log was
last cleaned up.
User- or System-Specific Status
These options provide general remote system-specific and user-specific
status of uucp connections to other systems. Either or both of the fol‐
lowing 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 dis‐
played:
-ssystem Reports the status of all uucp requests for remote system
system.
-uuser Reports 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 Reports the job state:
q for queued jobs
r for running jobs
i for interrupted jobs
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 is a job that suc‐
cessfully 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 speci‐
fied. 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 writes to standard output the status
of all uucp requests issued by the current user.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables
that affect the execution of uustat: LANG, LC_ALL, LC_COLLATELC_CTYPE,
LC_MESSAGES, LC_TIME, NLSPATH, and TZ.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
FILES
/var/spool/uucp/* spool directories
/var/uucp/.Admin/account accounting log
/var/uucp/.Admin/perflog performance log
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │service/network/uucp │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│Standard │See standards(5). │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOuucp(1C), attributes(5), environ(5), standards(5)DIAGNOSTICS
The -t option produces no message when the data needed for the calcula‐
tions is not being recorded.
NOTES
After the user has issued the uucp request, if the file to be trans‐
ferred is moved, deleted or was not copied to the spool directory (-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 trans‐
ferred can not be found.
SunOS 5.11 28 Mar 1995 uustat(1C)