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 --+ | +-----------------+ 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