NAME

uustat − uucp status inquiry and job control

SYNOPSIS

uustat [-a]
uustat [-m]
uustat [-p]
uustat [-q]
uustat [-k jobid]
uustat [-r jobid]
uustat [-s sys] [-u user]

DESCRIPTION

Uustat will display the status of, or cancel, previously specified uucp commands, or provide general status on uucp connections to other systems.  Only one of the following options can be specified with uustat per command execution:

−a Output all jobs in queue. 

−m Report the status of accessibility of all machines. 

−p Execute a ps -flp for all the process-IDs that are in the lock files. 

−q List the jobs queued for each machine. If a status file exists for the machine, its date, time and status information are reported. In addition, if a number appears in () next to the number of C or X files it is the age in days of the oldest C. or X. file for that system.  The Retry field is the number of hours until the next possible call.  The Count field is the number of failure attempts.  Note that for systems with a moderate number of outstanding jobs, this could take 30 seconds or more or realtime to execute.  As an example of the output produced by uustat −q:

eagle  3C 04/07-11:07 NO DEVICES AVAILABLE
mh3bs3 2C 07/07-10:42 SUCCESSFUL

The above output tells how many command files are waiting for each system.  Each command file may have zero or more files to be sent (a command file with no files to be sent causes the uucp system to call the remote system and see if work is waiting).  The date and time refer to the previous interaction with the system followed by the status of interaction. 

−k jobid Kill the uucp request whose job identification is jobid. The killed uucp request must belong to the person issuing the uustat command unless one is the super-user. 

−r jobid Rejuvenate jobid. The files associated with jobid are touched so that their modification time is set to the current time.  This prevents the cleanup daemon from deleting the job until the jobs modification time reaches the limit imposed by the cleanup daemon. 

The options below may not be used with the ones listed above; however, these options may be used singly or together:

−s sys Report the status of all uucp requests for remote system sys. 

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

Output for both the -s and -u options has the following format:

With the −s and −u options, the first field is the jobid of the job.  This is followed by the date/time.  The next field is either an S or R, depending on whether the job is to send or request a file.  The next field is the destination system name.  This is followed by the user-ID of the user who queued the job.  The next field contains the size of the file, or in the case of a remote execution the name of the command (rmail, which is the command used for remote mail).  When the size appears in this field, the file name is also given.  This can either be the name given by the user or an internal name (e.g., D.3b2alce4924) that is created for data files associated with remote execution (rmail in this example). 

When no options are given, uustat outputs the status of all uucp requests issued by the current user.  The format used is the same as with the -s or -u options. 

DEPENDENCIES

Series 300 Diskless
In a clustered environment, all UUCP activity is handled through devices attached to the rootserver as if the cluster were a single system.

Series 300
The following options are not currently supported: −a and −p. 

The following options are supported.  Only one of these can be specified, and only if none of −k, −r or −q is used:

−j jobid Report the status of the uucp request jobid. If all is used for jobid, the status of all uucp requests is reported.  An argument must be supplied otherwise the usage message will be printed and the request will fail. 

−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. 

−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. 

The following additional options may not be used with ones listed above; however, these options may be used singly or together with each other or with −s or −u:

−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. 

−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. 

The −q option cannot be used in combination with the options −o, −y, −s, −u or −O. 

FILES

SEE ALSO

uucp(1). 

UUCP, a tutorial in HP-UX Concepts and Tutorials. 

Hewlett-Packard Company  —  May 11, 2021