uustat
PURPOSE
Reports the status of and provides rudimentary job
control for BNU commands.
SYNOPSIS
uustat [-a -k jobid -m -p -q -r jobid] [-s system -u user]...
DESCRIPTION
The Basic Networking Utilities (BNU) command uustat dis-
plays status information about several types of BNU oper-
ations. It is particularly useful in monitoring transfer
(copy) requests issued with the uucp and uuto commands,
and requests to run an AIX command(s) on a remote system
made with the uux command.
In addition, uustat also gives a user limited control
over BNU jobs queued to run on remote systems. By
issuing the command with the appropriate flag, a user can
check the general status of BNU connections to other
systems, and cancel copy requests made with uucp and
uuto.
If uustat is issued without any flags, the command
reports the status of all BNU requests issued by the
current user since the last time the holding queue was
cleaned up (see the description of the -a flag for an
explanation of the BNU queues). Such status reports are
displayed in the following format:
jobid date/time status system_name user_ID size
file
See the Examples for an explanation of this format.
Note: When sending files to a system that has not been
contacted recently, it is a good idea to use uustat to
see when the last access occurred, as the remote system
may be down or out of service.
FLAGS
The following flags are mutually exclusive; you can use
only one at a time with the uustat command:
-a Displays information about all the jobs in the
holding queue, regardless of the user who
issued the original BNU command.
Note: There are two types of BNU queues.
o The current queue lists the BNU jobs
either queued to run on, or currently exe-
cuting on, one or more specified com-
puters. Use the uustat -q command to
examine this queue.
o The holding queue, accessed with the -a
flag, lists all jobs that have not exe-
cuted during a set period of time.
After the set time period has elapsed, the
entries in the holding queue are deleted
either manually, with the BNU command
uucleanup, or automatically, with the file
/usr/spool/cron/crontabs/uucp (which
includes uudemon.cleanup), which is
started by cron.
-k jobid Cancels (kills) the BNU process specified by
the jobid. The person using this flag must
either be the one who made the uucp request
now being canceled, or must be operating with
superuser authority.
Note: This flag cancels a process only when
that job is still on the local computer. Once
BNU has moved the job to a remote system for
execution, -kjobid cannot be used to cancel
the remote job.
-m Reports the status of the most recent attempt
to contact the specified system with a BNU
command. If the BNU request was completed,
the status report is SUCCESSFUL. If the job
was not completed, the status report is an
error message such as LOGIN FAILED.
-p Runs a ps -flp (process status: full, long
list of specified process IDs) for all PID
numbers in the lock files.
-q Lists the jobs currently queued to run on each
system; these jobs are either waiting to
execute or in the process of executing. If a
status file exists for the system, its date,
time, and status information are reported.
Once the job is finished, BNU removes that job
listing from the current queue.
Note: In a status report, a number in paren-
theses next to the number of a C.* (command)
file or an X.* (execute) file represents the
age in days of the oldest C.*/X.* file for
that system. The retry field represents the
number of times BNU tried and failed to
execute the command because of such factors as
a failed login, locked files, an unavailable
device, and so on.
-r jobid Marks the files in the holding queue specified
by jobid with the current date and time. Use
this flag to ensure that a cleanup operation
does not delete files until the job's modifi-
cation time reaches the end of the specified
period.
You can use either one or both of the following flags
with uustat:
-ssystem Reports the status of BNU requests for the
workstation specified by system.
-uuser_ID Reports the status of BNU requests by the
specified user for any workstation.
EXAMPLES
1. To display the status of all BNU jobs in the holding
queue:
uustat -a
The system responds with a display like the
following:
heraC3113 11/06-17:47 S hera amy 289 D.venus471afd8
zeusN3130 11/06-09:14 R zeus geo 338 D.venus471bc0a
merlinC3120 11/05-16:02 S merlin amy 828 /u/amy/tt
merlinC3119 11/05-12:32 S merlin msg rmail amy
The first field is the job ID of the operation, which
is followed by the date and time the BNU command was
issued. The third field is either an S or an R,
depending on whether the job is to send or request a
file. The fourth field is the name of the system on
which the command was entered, followed by the user
ID of the person who issued the command. The sixth
field is the size of the file, or, in the case of a
remote execution like the last entry in the example,
the name of the remote command. When the size is
given, as in the first three lines of the example
output, the file name is also displayed. The file
name can be either the name given by the user, as in
the "/u/amy/tt" entry, or a name that BNU assigns
internally to data files associated with remote exe-
cutions, such as "D.venus471afd8".
2. To display the status of all jobs in the current
queue:
uustat -q
The system responds:
merlin 3C 07/15-11:02 NO DEVICES AVAILABLE
hera 2C 07/15-10:55 SUCCESSFUL
zeus 1C (2) 07/15-10:59 CAN'T ACCESS DEVICE
The output tells how many C.* (command) files are
waiting for each system. The date and time refer to
the current interaction with the system, followed by
a report of the status of the interaction. The
number in parentheses (2) in the third line of the
example indicates that the C.* file has been in the
queue for two days.
3. To display all process IDs in the lock file:
uustat -p
LCK..tty0: 881
LCK.S.0: 879
LCK..hera: 881
F S UID PID PPID C PRI NI ADDR SZ WCHAN STIME TTY
101 S uucp 881 879 26 39 39 370 296 3fffe800 09:57:03 -
TIME COMD
0:00 UUCICO -rl -shera
101 S uuc 879 1 11 33 39 770 156 8d874 09:57:02 -
0:00 /usr/lib/uucp/uusched
4. To cancel a job in the current queue, first determine
the job ID and then execute the uustat -k command:
uustat -a
heraC3113 11/06-17:47 S hera amy 289 D.venus471afd8
merlinC3119 11/06-17:49 S merlin geo 338 D.venus471bc0a
uustat -k heraC3113
5. To report the status of jobs requested by system
"hera":
uustat -s hera
heraNlbd7 07/15-12:09 S hera amy 522 /user/amy/A
heraClbd8 07/15-12:10 S hera amy 59 D.3b2a12ce4924
heraC3119 07/15-12:11 S hera amy rmail msg
6. To report the status of jobs requested by user "amy":
uustat -u amy
This flag displays output similar to that produced by
the -s flag.
FILES
/etc/locks/LCK* Prevents multiple use of
device.
/usr/spool/uucp Spooling directory.
RELATED INFORMATION
The following commands: "ps," "uucp," "uuto," and
"uux."