UUSTAT(1-SysV)      RISC/os Reference Manual       UUSTAT(1-SysV)



NAME
     uustat - uucp status inquiry and job control

SYNOPSIS
     uustat [-a]
     uustat [-m]
     uustat [-p]
     uustat [-q]
     uustat [ -kjobid ]
     uustat [ -rjobid ]
     uustat [ -ssystem ] [ -uuser ]

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./X. file for that sys-
          tem.  The Retry field represents the number of hours
          until the next possible call.  The Count is the number
          of failure attempts.  NOTE: for systems with a moderate
          number of outstanding jobs, this could take 30 seconds
          or more of real-time to execute.  As 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 above output tells how many command files are wait-
          ing for each system.  Each command file may have zero
          or more files to be sent (zero means to call the system
          and see if work is to be done).  The date and time
          refer to the previous interaction with the system fol-
          lowed by the status of the interaction.

     -kjobid
          Kill the uucp request whose job identification is
          jobid.  The killed uucp request must belong to the per-
          son issuing the uustat command unless one is the
          super-user.



                         Printed 1/15/91                   Page 1

UUSTAT(1-SysV)      RISC/os Reference Manual       UUSTAT(1-SysV)



     -rjobid
          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 deamon.

     Either or both of the following options can be specified
     with uustat:

     -ssys
          Report the status of all uucp requests for remote sys-
          tem sys.

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

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

          eaglen0000   4/07-11:01:03  (POLL)
          eagleN1bd7   4/07-11:07     S      eagle  dan   522 /usr/dan/A
          eagleC1bd8   4/07-11:07     S      eagle  dan   59 D.3b2al2ce4924
                       4/07-11:07     S      eagle  dan   rmail mike

     With the above two 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.  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
     (rmail- the command used for remote mail), the name of the
     command.  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 executions
     (rmail in this example).

     When no options are given, uustat outputs the status of all
     uucp requests issued by the current user.

FILES
     /usr/spool/uucp/*        spool directories


SEE ALSO
     uucp(1).








 Page 2                  Printed 1/15/91