NAME

uustat − uucp status inquiry and job control

SYNOPSIS

uustat [ options ]

DESCRIPTION

Uustat will display the status of, or cancel, previously specified uucp commands, or provide general status on uucp connections to other systems.  The following options are recognized:

−jjobn Report the status of the uucp request jobn. If all is used for jobn, the status of all uucp requests is reported.  If jobn is omitted, the status of the current user’s uucp requests is reported. 

−kjobn Kill the uucp request whose job number is jobn. The killed uucp request must belong to the person issuing the uustat command unless one is the super-user. 

−rjobn Rejuvenate jobn. That is jobn is touched so that its modification time is set to the current time.  This prevents uuclean from deleting the job until the jobs modification time reaches the limit imposed by uuclean.

−chour Remove the status entries which are older than hour hours.  This administrative option can only be initiated by the user uucp or the super-user. 

−uuser Report the status of all uucp requests issued by user.

−ssys Report the status of all uucp requests which communicate with remote system sys.

−ohour Report the status of all uucp requests which are older than hour hours. 

−yhour Report the status of all uucp requests which are younger than hour hours. 

−mmch Report the status of accessibility of machine mch. If mch is specified as all, then the status of all machines known to the local uucp are provided. 

−Mmch This is the same as the −m option except that two times are printed.  The time that the last status was obtained and the time that the last successful transfer to that system occurred. 

−O Report the uucp status using the octal status codes listed below.  If this option is not specified, the verbose description is printed with each uucp request. 

−q List the number of jobs and other control files queued for each machine and the time of the oldest and youngest file queued for each machine.  If a lock file exists for that system, its date of creation is listed. 

When no options are given, uustat outputs the status of all uucp requests issued by the current user.  Note that only one of the options −j, −m, −k, −c, −r, can be used with the rest of the other options. 

For example, the command:

uustat −uhdc −smhtsa −y72

will print the status of all uucp requests that were issued by user hdc to communicate with system mhtsa within the last 72 hours.  The meanings of the job request status are:

job-number user remote-system command-time status-time status

where the status may be either an octal number or a verbose description.  The octal code corresponds to the following description:

OCTAL STATUS

000001 the copy failed, but the reason cannot be determined

000002 permission to access local file is denied

000004 permission to access remote file is denied

000010 bad uucp command is generated

000020 remote system cannot create temporary file

000040 cannot copy to remote directory

000100 cannot copy to local directory

000200 local system cannot create temporary file

000400 cannot execute uucp

001000 copy (partially) succeeded

002000 copy finished, job deleted

004000 job is queued

010000 job killed (incomplete)

020000 job killed (complete)

The meanings of the machine accessibility status are:

system-name time status

where time is the latest status time and status is a self-explanatory description of the machine status. 

FILES

/usr/spool/uucp spool directory

/usr/lib/uucp/L_stat system status file

/usr/lib/uucp/R_stat request status file

SEE ALSO

uucp(1C). 

Version 2.1  —  January 02, 1985