1uustat(1C) Communication Commands uustat(1C)
2
6 uustat - uucp status inquiry and job control
7
9 uustat
10 [ [-m] | [-p] | [-q] | [-k jobid [-n]] | [-r jobid [-n]]]
11 uustat [-a] [-s system [-j]] [-u user] [-S qric]
14 uustat -t system [-c] [-d number]
17
20 The uustat utility functions in the following three areas:
21 1. Displays the general status of, or cancels, previously spec‐
23 ified uucp commands.
24 2. Provides remote system performance information, in terms of
26 average transfer rates or average queue times.
27 3. Provides general remote system-specific and user-specific
29 status of uucp connections to other systems.
30
32 The following options are supported:
33 General Status
35 These options obtain general status of, or cancel, previously speci‐
36 fied uucp commands:
37 -a Lists all jobs in queue.
39 -j Lists the total number of jobs displayed. The -j option can
42 be used in conjunction with the -a or the -s option.
43 -kjobid Kills the uucp request whose job identification is jobid.
46 The killed uucp request must belong to the user issuing the
47 uustat command unless the user is the super-user or uucp
48 administrator. If the job is killed by the super-user or
49 uucp administrator, electronic mail is sent to the user.
50 -m Reports the status of accessibility of all machines.
53 -n Suppresses all standard output, but not standard error. The
56 -n option is used in conjunction with the -k and -r options.
57 -p Executes the command ps -flp for all the process-ids that
60 are in the lock files.
61 -q Lists the jobs queued for each machine. If a status file
64 exists for the machine, its date, time and status informa‐
65 tion are reported. In addition, if a number appears in
66 parentheses next to the number of C or X files, it is the
67 age in days of the oldest C./X. file for that system. The
68 Retry field represents the number of hours until the next
69 possible call. The Count is the number of failure attempts.
70 Note: For systems with a moderate number of outstanding
71 jobs, this could take 30 seconds or more of real-time to
72 execute. An example of the output produced by the -q option
73 is:
74 eagle 3C 04/07-11:07 NO DEVICES AVAILABLE
76 mh3bs3 2C 07/07-10:42 SUCCESSFUL
77 This indicates the number of command files that are waiting
80 for each system. Each command file may have zero or more
81 files to be sent (zero means to call the system and see if
82 work is to be done). The date and time refer to the previous
83 interaction with the system followed by the status of the
84 interaction.
85 -rjobid Rejuvenates jobid. The files associated with jobid are
88 touched so that their modification time is set to the cur‐
89 rent time. This prevents the cleanup daemon from deleting
90 the job until the jobs' modification time reaches the limit
91 imposed by the daemon.
92 Remote System Status
95 These options provide remote system performance information, in terms
96 of average transfer rates or average queue times. The -c and -d options
97 can only be used in conjunction with the -t option:
98 -tsystem Reports the average transfer rate or average queue time for
100 the past 60 minutes for the remote system. The following
101 parameters can only be used with this option:
102 -c Average queue time is calculated when the -c parameter is
105 specified and average transfer rate when -c is not speci‐
106 fied. For example, the command:
107 example% uustat -teagle -d50 -c
109 produces output in the following format:
112 average queue time to eagle for last 50 minutes:
114 5 seconds
115 The same command without the -c parameter produces output
118 in the following format:
119 average transfer rate with eagle for last 50 minutes:
121 2000.88 bytes/sec
122 -dnumber number is specified in minutes. Used to override the 60
127 minute default used for calculations. These calculations
128 are based on information contained in the optional perfor‐
129 mance log and therefore may not be available. Calculations
130 can only be made from the time that the performance log was
131 last cleaned up.
132 User- or System-Specific Status
135 These options provide general remote system-specific and user-specific
136 status of uucp connections to other systems. Either or both of the fol‐
137 lowing options can be specified with uustat. The -j option can be used
138 in conjunction with the -s option to list the total number of jobs dis‐
139 played:
140 -ssystem Reports the status of all uucp requests for remote system
142 system.
143 -uuser Reports the status of all uucp requests issued by user.
146 Output for both the -s and -u options has the following format:
150 eagleN1bd7 4/07-11:07 S eagle dan 522 /home/dan/A
152 eagleC1bd8 4/07-11:07 S eagle dan 59 D.3b2al2ce4924
153 4/07-11:07 S eagle dan rmail mike
154 With the above two options, the first field is the jobid of the job.
159 This is followed by the date/time. The next field is an S if the job is
160 sending a file or an R if the job is requesting a file. The next field
161 is the machine where the file is to be transferred. This is followed by
162 the user-id of the user who queued the job. The next field contains the
163 size of the file, or in the case of a remote execution (rmail is the
164 command used for remote mail), the name of the command. When the size
165 appears in this field, the file name is also given. This can either be
166 the name given by the user or an internal name (for example,
167 D.3b2alce4924) that is created for data files associated with remote
168 executions (rmail in this example).
169 -Sqric Reports the job state:
171 q for queued jobs
173 r for running jobs
176 i for interrupted jobs
179 c for completed jobs
182 A job is queued if the transfer has not started. A job is
184 running when the transfer has begun. A job is interrupted if
185 the transfer began but was terminated before the file was
186 completely transferred. A completed job is a job that suc‐
187 cessfully transferred. The completed state information is
188 maintained in the accounting log, which is optional and
189 therefore may be unavailable. The parameters can be used in
190 any combination, but at least one parameter must be speci‐
191 fied. The -S option can also be used with -s and -u options.
192 The output for this option is exactly like the output for -s
193 and -u except that the job states are appended as the last
194 output word. Output for a completed job has the following
195 format:
196 eagleC1bd3 completed
198 When no options are given, uustat writes to standard output the status
204 of all uucp requests issued by the current user.
205
207 See environ(5) for descriptions of the following environment variables
208 that affect the execution of uustat: LANG, LC_ALL, LC_COLLATELC_CTYPE,
209 LC_MESSAGES, LC_TIME, NLSPATH, and TZ.
210
212 The following exit values are returned:
213 0 Successful completion.
215 >0 An error occurred.
218
221 /var/spool/uucp/* spool directories
222 /var/uucp/.Admin/account accounting log
225 /var/uucp/.Admin/perflog performance log
228
231 See attributes(5) for descriptions of the following attributes:
232 ┌─────────────────────────────┬─────────────────────────────┐
237 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
238 ├─────────────────────────────┼─────────────────────────────┤
239 │Availability │SUNWbnuu │
240 ├─────────────────────────────┼─────────────────────────────┤
241 │Interface Stability │Standard │
242 └─────────────────────────────┴─────────────────────────────┘
243
245 uucp(1C), attributes(5), environ(5), standards(5)
246
248 The -t option produces no message when the data needed for the calcula‐
249 tions is not being recorded.
250
252 After the user has issued the uucp request, if the file to be trans‐
253 ferred is moved, deleted or was not copied to the spool directory (-C
254 option) when the uucp request was made, uustat reports a file size of
255 −99999. This job will eventually fail because the file(s) to be trans‐
256 ferred can not be found.
257SunOS 5.11 28 Mar 1995 uustat(1C)