uustat Command

AIX Version 4.3 Commands Reference, Volume 5

uustat Command

Purpose

Reports the status of and provides limited control over BNU operations.

Syntax

uustat [ [ -n Number ]

[ -a | -k JobID | -m | -p | -q | -r JobID ] | [ -s System ] [ -u User ] ]

Description

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:

The current queue, accessed with the -q flag, lists the BNU jobs either queued to run on or currently running on one or more specified computers.
The holding queue, accessed with the -a flag, lists all jobs that have not executed during a set period of time.
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.

Flags

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. Once 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. Once 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.

Examples

To display the status of all BNU jobs in the holding queue, enter:

uustat -a

The system responds with a message similar to 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   /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.

To display the status of all jobs in the current queue, enter:
```
uustat -q
```
The system responds with a message similar to the following:
```
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.

To display all process IDs in the lock file, enter:

uustat -p

The system responds with a message similar to the following:

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

To cancel a job in the current queue, first determine its job ID and then issue the command to cancel the job. To determine the job ID, enter:
```
uustat -a
```
The system responds with a message similar to the following:
```
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, enter:
```
uustat -k heraC3113
```

To report the status of jobs requested by system hera, enter:

uustat -s hera

The system responds with a message similar to the following:

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

Files

/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.

Related Information

The cron daemon, ct command, cu command, echo command, stty command, uucleanup command, uucp command, uuname command, uupick command, uuto command, uux command.