Format
uustat [–j jobid | –k jobid | –r jobid]
uustat [–m]
uustat [–q]
uustat [–s site]
[–u user]
uustat [–a [–o number]
[–y number]]
Description
uustat displays
reports on the progress of pending UUCP transfers. You can display
the status of transfers for a particular job ID or user ID. uustat can
also stop or restart jobs in the queue.
If you do not specify
any options, it displays the status of all UUCP requests for all sites
made by the current user.
Options
- –a
- Displays the jobs queued for all users instead of only the jobs
for the user issuing the command.
- –j jobid
- Displays the status of the specified job.
- –k jobid
- Stops the UUCP job identified by jobid. uustat can
display the job ID of a job in the queue, when used with one of the
other options. You cannot use this option with the –q or –r options.
- –o number
- Displays the jobs that are older than number hours.
- –q
- Displays the latest conversation status and times tried for all
sites that recently had errors, as well as a count of the jobs queued.
You cannot use this option with the –k or –r options.
- –m
- Displays the latest conversation status and times tried for all
sites, as well as a count of the jobs queued. You cannot use this
option with the –k or –r options.
- –r jobid
- Restarts the UUCP request specified by jobid.
This option updates the timestamp on the file, making the request
appear recent. It cannot restart jobs that have been stopped with
the –k option. You cannot use this option
with the –k or –q options.
- –s site
- Displays the status of all UUCP transfers requested for site.
- –u user
- Displays the status of all UUCP transfers requested by user.
- –y number
- Displays the jobs that are younger than number hours.
Output
uustat uses
a variety of output formats, depending on the options specified.
If
you do not specify an option, or if you specify the
–s and
–u options,
the output is in this format, one line to every request within a work
file:
job ID mo/dy—hh:mm rtype site user information
The
following list explains the fields:
- job ID
- Identifies the job. If a job contains more than one request, subsequent
requests are displayed below the first, without a job ID.
- mo/dy—hh:mm
- Time of the request.
- rtype
- The request type, either S (for send) or R (for
receive).
- site
- The name of the remote site.
- user
- The name of the user who requested the job.
- information
- Describes the request. The format depends on the type of request.
For a send request,
information has the format:
size filename
where
size is the size in bytes of the file
to be sent and
filename is either the absolute
path name on your site, or the UNIX-style filename relative to your
spool directory for the remote site.
For a receive request,
information has
the format:
filename
For a remote
execution request (such as a request produced by mailx,
the command to be run is displayed after any data files associated
with it.
For the
–q and
–m options,
the output is in this format:
site transfersC (age) commandsX(age) status retry
where:
- site
- Remote site name.
- transfersC(age)
- Number of file transfer jobs pending; if any are over one day
old, the age in days of the oldest job is given in parentheses.
- commandsX(age)
- Number of pending command requests that have been received; if
any are over one day old, the age in days of the oldest job is given
in parentheses.
- status
- Time and result of the last attempt to call this site. The status field
shows the status of attempts made by this system to connect to other
systems. When other systems call this system, this field is not updated.
- retry
- Time to the next connection attempt in hours:minutes and
the current retry count. The retry field is displayed
only between retry attempts.
For the
–k and
–r options,
uustat displays
a message telling you if the attempt to stop or restart a job was
successful.
Examples
- To display all waiting UUCP requests:
uustat
- To display all jobs waiting for remote site east:
uustat –s east
- To stop the UUCP job associated with job ID westn0003:
uustat –k westn0003
Environment variables
uustat uses
the following environment variable:
- TZ
- Sets the
time zone used with date and time information.
Format of the TZ environment variable explains how to
set the local time zone with the TZ environment variable.
Localization
uustat uses
the following localization environment variables:
- LANG
- LC_ALL
- LC_CTYPE
- LC_MESSAGES
- NLSPATH
See Localization for more
information.
Files
uustat uses
the following files:
- /usr/lib/uucp/config
- UUCP configuration file.
- /usr/spool/uucp
- UUCP spool directory, containing
site-specific subdirectories and information files.
- /usr/spool/uucp/site
- Subdirectory containing queued job requests, work files, data
files, and execution files for the UUCP host site.
- /usr/spool/uucp/.Status/site
- Status file for
the remote UUCP host site. uustat queries
the status file with the –q option.
Exit values
- 0
- Successful completion
- 1
- Failure due to any of the following:
- Argument list too long
- Unable to open log file
- Log files
- Insufficient memory
- CTRL-C interrupt
- 2
- Unknown command-line option.
Portability
X/Open Portability Guide, UNIX systems.
Related information
uucp, uulog, uuxqt