uustat(1C) uustat(1C)NAME uustat - controls uucp jobs and provides status information SYNOPSIS uustat [-a] [-Sjob-status] [[-j] [-ssystem]] [-ulogin-name] [-xdebug-level] uustat -kjob-id [-n] [-xdebug-level] uustat -m [-xdebug-level] uustat -p [-xdebug-level] uustat -q [-xdebug-level] uustat -rjob-id [-n] [-xdebug-level] uustat -tsystem [-dminutes] [-c] [-xdebug-level] ARGUMENTS -a Lists all jobs in the queue. You can use this option with the -j option. -c Reports the average queue time rather than the average transfer rate. You can use this option only in conjunction with the -t option. -dminutes Overrides the 60-minute default so that uustat reports statistics for the number of minutes specified by minutes. -j Lists the total number of jobs displayed. You can use this option with the -a or the -s option. -kjob-id Cancels the uucp request whose job identification is job-id. This option is effective only if used by the user that originated the uucp job or if made by a user logged in as root or uucp. If the job is canceled by a user logged in as root or uucp, uustat notifies the user who originated the uucp request by sending mail. -m Reports the status of the most recent connection to all systems for which a log file exists. -n Suppresses information written on the standard output, but does not suppress information written on the standard error. You can use this option with the -k or the -r option. -p Causes uustat to examine the lock files and run the January 1992 1
uustat(1C) uustat(1C)command ps -flp for each process ID that it finds. -q Lists the jobs queued for each system. If a status file exists for the system, its date, time, and status information are displayed. If the display includes a number in parentheses next to the number of C or X files, the number in parentheses is the age in days of the oldest C. or X. file for that system. The Retry column represents the number of hours until the next possible call. The Count column is the number of failure attempts. For systems with a moderate number of outstanding jobs, uustat -q may take 30 seconds or more to produce a report. -rjob-id Rejuvenates the job ID specified by job-id. The modification time of the files associated with job-id is set to the current time, which prevents uucleanup from deleting the job because it has become old. -ssystem Reports the status of all uucp requests for the remote system specified by system. You can use this option in conjunction with the -j and -u options. -Sjob-status Reports the state of the job, whose type is specified by job-status. The value of job-status can be one or more of the following options in any combination: c Reports jobs that have completed successfully. The completed-state information is maintained in the accounting log, which is optional and therefore may be unavailable. i Reports interrupted jobs. A job is interrupted if the transfer began but was terminated before the file was completely transferred. q Reports queued jobs. A job is queued if the transfer has not started. r Reports running jobs. A job is running when the transfer has begun. You can use the -S option with the -a, -j, -s, and -u options. 2 January 1992
uustat(1C) uustat(1C)-tsystem Reports the average transfer rate for the past 60 minutes for the remote system specified by system. These calculations are based on information contained in the optional performance log and therefore may not be available. Calculations can only be made from the time that the performance log was last cleaned up. The -t option produces no message when the data needed for the calculations is not being logged. -ulogin-name Reports the status of all uucp requests issued by the user specified by login-name. You can use this option in conjunction with the -s option. -xdebug-level Writes debugging information on standard output. The value of debug-level is a number from 0 to 9. Higher numbers produce more detailed debugging information. DESCRIPTION uustat displays the status of UUCP jobs, cancels jobs, provides remote-system performance information in terms of average transfer rates or average queue times, and provides specific information, organized by system or by user, about connections. The uustat command without any options displays the status and job identification number of all UUCP requests that have yet to be transferred or have recently completed successfully. You can use options to cause uustat to provide other types of information about uucp activity on your system. You can use the -a, -j, -m, -n, -p, -q, or -rjob-id option to get general status information. Unless otherwise noted, these options cannot appear with any other options on the uustat command line. EXAMPLES Here is an example of the output produced by the -q option: eagle 3C 04/07-11:07 NO DEVICES AVAILABLE mh3bs3 2C 07/07-10:42 SUCCESSFUL The first column is the system name. The second column tells how many control files are waiting to be processed. Each control file can specify the transmisson of 0 or more files; if 0, uucico is to poll the remote system to see if it has files to send to your system. The third column reflects the date and time of the most recent attempt to connect to the system, and the fourth column represents the status of that January 1992 3
uustat(1C) uustat(1C)attempt. Here is an example that uses the -t and -c options to display the amount of time for which jobs remain in the queue for the system named eagle: uustat -teagle -d50 -c The command produces output in this format: average queue time to eagle for last 50 minutes: 5 seconds The same command without the -c option produces output in this format: average transfer rate with [eagle] \ for last [50] minutes: 2000.88 bytes/sec Here is an example of the output of the -s option, which displays all of the jobs queued for a specific system, and the -u option, which displays all of the jobs queued by a specific user: eagleN1bd7 4/07-11:07 S eagle dan 522 /home/dan/A eagleC1bd8 4/07-11:07 S eagle dan 59 D.3b2al2ce4924 4/07-11:07 S eagle dan rmail mike The first column is the job ID of the job. The second column is the date and time the job was queued. The third column is an S if the job is sending a file or an R if the job is requesting a file. The fourth column is the name of the system the file is being transferred to or from. The fifth column is the login name of the user who queued the job. The sixth column is the size of the file in bytes, or, in the case of a remote execution command such as rmail, the name of the command. When the size appears in this column, the filename is displayed in the seventh column. This filename can either be the name given by the user or an internal name, such as D.3b2alce4924, that is created for data files associated with remote executions. The output of the -S option is the same as the output for the -s and -u options except that the job states are appended as the last output word. Here is an example that uses the -S and the c options to display the current list of completed jobs: uustat -Sc Here is an example of the output of this command: 4 January 1992
uustat(1C) uustat(1C)eagleC1bd3 completed NOTES If you use the -C option of uucp, which specifies that uucp is to transfer the file from the file itself rather than making a copy in /usr/spool/uucp, and the file is later moved or deleted before uucp can transfer it, uustat reports a file size of -99999. Such a job eventually fails because the file to be transferred cannot be found. FILES /usr/lib/uucp Directory of uucp commands and configuration files /usr/spool/uucp/* Files, organized by system name, that contain the control information that makes up a uucp job /usr/uucp/.Admin/account Log of accounting information /usr/uucp/.Admin/perflog Log of performance information SEE ALSO uucp(1C), uulog(1C) Chapter 8, ``Setting Up the UUCP System,'' in A/UX Network System Administration January 1992 5