Communication Commands uustat(1C)
NAME
uustat - uucp status inquiry and job control
SYNOPSIS
uustat
[ [-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, previ-
ously specified 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 sys-
tems.
OPTIONS
The following options are supported:
General Status
These options obtain general status of, or cancel, previ-
ously specified 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.
SunOS 5.11 Last change: 28 Mar 1995 1
Communication Commands uustat(1C)
-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 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. 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 SUCESFUL
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 current 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
SunOS 5.11 Last change: 28 Mar 1995 2
Communication Commands uustat(1C)
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 specified. For example, the com-
mand:
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 pro-
duces 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 con-
tained 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.
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 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 Reports the status of all uucp requests for
remote system system.
SunOS 5.11 Last change: 28 Mar 1995 3
Communication Commands uustat(1C)
-uuser Reports 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 (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 ter-
minated before the file was completely
transferred. A completed job is a job that suc-
cessfully transferred. The completed state infor-
mation 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
SunOS 5.11 Last change: 28 Mar 1995 4
Communication Commands uustat(1C)
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, LCAL,
LCOLATELCTYPE, LCMESAGES, LCTIME, 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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 28 Mar 1995 5
Communication Commands uustat(1C)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWbnuu
Interface Stability Standard
SEE ALSO
uucp(1C), attributes(5), environ(5), standards(5)
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, 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 eventu-
ally fail because the file(s) to be transferred can not be
found.
SunOS 5.11 Last change: 28 Mar 1995 6
|
