Reports the status of and provides limited control over BNU operations.
uustat [ [ -n Number ] [ -a | -k JobID | -m | -p | -q | -r JobID ] | [ -s System ] [ -u User ] ]
The uustat command is a Basic Networking Utilities (BNU) command that displays status information about several types of BNU operations. It is particularly useful in monitoring the status of BNU requests.
In addition, the uustat command 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 the uucp and uuto commands.
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. Such status reports are displayed in the following format:
jobid date/time status system_name user_ID size file
There are two types of BNU queues:
After the time has elapsed, the entries in the holding queue are deleted either manually with the BNU uucleanup command or automatically by commands such as uudemon.cleanu started by the cron daemon.
When sending files to a system that has not been contacted recently, it is a good idea to use the uustat command to see when the last access occurred; the remote system may be down or out of service.
The following flags are mutually exclusive. 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. |
| -kJobID | Cancels the BNU process specified by the JobID variable. The person using this flag must either be the one who made
the uucp request now being
canceled or be operating with root authority.
This flag cancels a process only when that job is still on the local computer. After BNU has moved the job to a remote system for execution, the -k JobID flag 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 saying that the login failed. |
| -n Number | Allows the user to specify the amount of machines from which to collect BNU status information. The amount specified should be greater than or equal to the amount of machines in the Systems file. The default is 200. |
| -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.
When the job is finished, BNU removes that job listing from the current queue.
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.* or X.* file for that system. The retry field represents the number of times BNU tried and failed to execute the command because of, for example, a failed login, locked files, or an unavailable device. |
| -rJobID | Marks the files in the holding queue specified by the JobID variable 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 the uustat command: |
| -s System | Reports the status of BNU requests for the workstation specified by the System variable. The System name can contain only ASCII characters. |
| -u User | Reports the status of BNU requests by the user specified by the User variable, for any workstation. The User name can contain only ASCII characters. |
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 /home/amy/tt merlinC3119 11/05-12:32 S merlin msg rmail amy
| Field | Description |
|---|---|
| 1 | Job ID of the operation |
| 2 | Date and time the BNU command was issued |
| 3 | An S or an R, depending on whether the job is to send or receive a file |
| 4 | Name of the system on which the command was entered |
| 5 | User ID of the person who issued the command |
| 6 | Size of the field or the name of the remote command |
| 7 | Name of the file. |
When the size of the file 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 /home/amy/tt entry, or a name that BNU assigns internally to data files associated with remote executions, such as D.venus471afd8.
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
This output tells how many C.* (command) files are waiting for each system. 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.The date and time refer to the current interaction with the system, followed by a report of the status of the interaction.
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 -r1 -shera 101 S uuc 879 1 11 33 39 770 156 8d874 09:57:02 - 0:00 /usr/sbin/uucp/uusched
heraC3113 11/06-17:47 S hera amy 289 D.venus471afd8 merlinC3119 11/06-17:49 S merlin geo 338 D.venus471bc0a
To cancel the job with the ID of heraC3113,
type:
uustat -k heraC3113
heraN1bd7 07/15-12:09 S hera amy 522 /usr/amy/A heraC1bd8 07/15-12:10 S hera amy 59 D.3b2a12ce4924 heraC3119 07/15-12:11 S hera amy rmail msg
| /etc/locks | Contains lock files to prevent multiple uses of devices. |
| /usr/bin/uustat | Specifies the command pathname. |
| /var/spool/uucp | Contains BNU status information. |
The cron daemon, ct command, cu command, echo command, stty command, uucleanup command, uucp command, uuname command, uupick command, uuto command, uux command.