uustat(1)                                                         uustat(1)




 NAME    [Toc]    [Back]
      uustat - uucp status inquiry and job control

 SYNOPSIS    [Toc]    [Back]
      uustat -a
      uustat -m
      uustat -p
      uustat -q
      uustat -k jobid]
      uustat -r jobid]
      uustat [-ssys] [-uuser]

 DESCRIPTION    [Toc]    [Back]
      uustat displays the status of, or cancels, previously specified uucp
      commands, or provide general status on uucp connections to other
      systems (see uucp(1)).  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 of real time 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 can 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 the command is



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 uustat(1)                                                         uustat(1)




                     executed by 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 following options can be used singly or together but cannot be
      used with the options listed above:

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

           -u user   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.3b2a12cd4924
                              4/07-11:07       S       eagle dan rmail mike

           With the -s and -u options, the first field is the jobid of the
           job.  This is followed by the date and 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 (such as 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 (such as 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.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      LC_TIME determines the format and contents of date and time strings.

      LANG determines the language in which messages are displayed.

      If LC_TIME is not specified in the environment or is set to the empty
      string, the value of LANG is used as a default for each unspecified or
      empty variable.  If LANG is not specified or is set to the empty
      string, a default of "C" (see lang(5)) is used instead of LANG.  If
      any internationalization variable contains an invalid setting, uustat



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 uustat(1)                                                         uustat(1)




      behaves as if all internationalization variables are set to "C".  See
      environ(5).

 FILES    [Toc]    [Back]
      /var/spool/uucp/*             spool directories

 SEE ALSO    [Toc]    [Back]
      uucp(1).

      Tim O'Reilly and Grace Todino,
           Managing UUCP and Usenet, O'Reilly & Associates, Inc. USA.

      Grace Todino and Dale Dougherty,
           Using UUCP and Usenet, O'Reilly & Associates, Inc. USA.

 STANDARDS CONFORMANCE    [Toc]    [Back]
      uustat: SVID2, SVID3, XPG2, XPG3, XPG4


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003