atrm(1)                                                             atrm(1)

NAME
     atrm - remove jobs scheduled with at or batch (at remove)

SYNOPSIS
     atrm [option]... argument...

DESCRIPTION
     atrm removes jobs that were scheduled with at or batch but have not
     yet been executed.

     If you are not a privileged user, you can only remove your own jobs
     with atrm; system administrators can remove any jobs from the queue.

OPTIONS
     -a   (all) atrm removes all your jobs from the queue.

          If you invoke this command as system administrator, the entire
          queue will be flushed.

          This option must be specified without an argument.

     -f   (force) All messages regarding the removal of the specified jobs
          are suppressed.

     -i   (interactive) atrm expects you to individually confirm each job
          to be removed. Only the jobs you confirm will be removed.

     argument
          argument can be a login name or a job number. atrm removes each
          job number you specify and/or all jobs belonging to the specified
          users.

          As an ordinary user you can only remove jobs that belong to you;
          only the system administrator can remove jobs belonging to other
          users.

          A list of scheduled jobs and associated job numbers can be
          displayed by using atq.

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed.

     The LCTIME environment variable governs the format of date and time
     strings.

     If LCXXX or LCYYY is undefined or is defined as the null string, it
     defaults to the value of LANG. If LANG is likewise undefined or null,
     the system acts as if it were not internationalized.

     If any of the locale variables has an invalid value, the system acts
     as if none of the variables were set.



Page 1                       Reliant UNIX 5.44                Printed 11/98

atrm(1)                                                             atrm(1)

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.

EXAMPLES
     After using atq to list all unexecuted jobs that were scheduled with
     at or batch, you remove the job with job number 644711400.a.

     $ atq
     Rank   Execution Date    Owner    Job       Queue  Job Name
     1st   Jun 6, 1990 18:00  anna   644709600.a   a      stdin
     2nd   Dec 7, 1990 20:30  anna   644711400.a   a      stdin

     $ atrm 644711400.a
     644711400.a removed

FILES
     /var/spool/cron
          Directory containing the jobs that are still to be processed.

SEE ALSO
     at(1), atq(1), batch(1), crontab(1), cron(1M).
































Page 2                       Reliant UNIX 5.44                Printed 11/98