UUSTAT(1c,C) AIX Commands Reference UUSTAT(1c,C)
-------------------------------------------------------------------------------
uustat
PURPOSE
Reports the status of and provides rudimentary job control for BNU commands.
SYNTAX
one of
+-------------------+
| -a -p |
+--| -k jobid -q |--+
| | -m -r jobid | |
uustat ---| +-------------------+ |---|
| +- -s system -+ |
+---| |-------+
^ +-- -u user --+ |
+-----------------+
Note: This command does not have MBCS support.
DESCRIPTION
The Basic Networking Utilities (BNU) command uustat displays status information
about several types of BNU operations. 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 the uustat command 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.
Processed November 8, 1990 UUSTAT(1c,C) 1
UUSTAT(1c,C) AIX Commands Reference UUSTAT(1c,C)
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 executing on, one or more
specified computers. Use the uustat -q command to
examine this queue.
o The holding queue, accessed with the -a flag, lists
all jobs that have not executed 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, -k jobid 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 parentheses 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
Processed November 8, 1990 UUSTAT(1c,C) 2
UUSTAT(1c,C) AIX Commands Reference UUSTAT(1c,C)
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 or an
unavailable device.
-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 modification 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 work station
specified by system.
-uuser_ID Reports the status of BNU requests by the specified user
for any work station.
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 executions, 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
Processed November 8, 1990 UUSTAT(1c,C) 3
UUSTAT(1c,C) AIX Commands Reference UUSTAT(1c,C)
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 STIME PRI NI ADDR SZ WCHAN TTY
TIME CMD
101 S uucp 881 879 26 09:57:03 39 39 370 296 3fffe800 -
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
See the following commands: "ps," "uucp," "uuto," and "uux."
See the chapter on basic networking utilities in Managing the AIX Operating
System.
Processed November 8, 1990 UUSTAT(1c,C) 4