AT(1) BSD General Commands Manual AT(1)

NAME
     aatt,, bbaattcchh,, aattqq,, aattrrmm - queue, examine, or delete jobs for later execu-
     tion

SSYYOOPPSSIISS
     aatt [-qq queue] [-ff file] [-mm] time

     aattqq [-qq queue] [-vv]

     aattrrmm job [job ...]

     bbaattcchh [-ff file] [-mm] time

NNOOTTEE
     aatt, bbaattcchh, aattqq, aattrrmm are all disabled by default on Mac OS X.  Each of
     these commands depend on the execution of atrun(8) which has been dis-
     abled due to power management concerns.  Those who would like to use
     these commands, must first (as root) re-enable aattrruunn by running:

     launchctl load -w /System/Library/LaunchDaemons/com.apple.atrun.plist

DESCRIPTION
     The aatt and bbaattcchh utilities read commands from the standard input or a
     specified file which are to be executed at a later time, using sh(1).

     The functions of the commands are as follows:

     aatt      Executes commands at a specified time.

     aattqq     Lists the user's pending jobs, unless the user is the superuser.
             In that case, everybody's jobs are listed.

     aattrrmm    Deletes jobs.

     bbaattcchh   Executes commands when system load levels drop below a user-
             specifed threshold.  The load threshold for batch jobs is
             specifed as an argument when executing atrun(8).

     For both aatt and bbaattcchh, the working directory, environment (except for the
     variables TTEERRMM, TTEERRMMCCAAPP, DDIISSPPLLAAYY, and ) and the umask are retained from
     the time of invocation.  The user will be mailed the standard output and
     standard error from his commands if any output is generated.  If aatt is
     executed from a su(1) shell, the owner of the login shell will receive
     the mail.

OOPPTTIIOONNSS
     The available options are as follows:

     -qq queue
             Use the specified queue.  A queue designation consists of a sin-
             gle letter; valid queue designation range from a to l.  The a
             queue is the default, and b is the batch queue.  Queues with
             higher letters run with increased niceness.  If aattqq is given a
             specific queue, it will only show jobs pending in that queue.

     -mm      Send mail to the user when the job has completed, even if there
             was no output.

     -ff file
             Reads the job from file rather than the standard input.

     -vv      Shows completed but not yet deleted jobs in the queue.

TTIIMMEE SSPPEECCIIFFIICCAATTIIOONN
     aatt,, AT&T UNIX allows some moderately complex time specifications.  It
     accepts times of the form HHMM or HH:MM to run a job at a specific time
     of day.  If that time is already passed, the next day is assumed.  You
     may also specify mmiiddnniigghhtt, nnoooonn, or tteeaattiimmee (4PM) and you can give a time
     of day suffixed with AAMM or PPMM for running in the morning or the evening.
     You can also specify the date on which the job will be run by giving a
     date in the form month-name day with an optional year, or giving a date
     of the form MMDDYY, MM/DD/YY or DD.MM.YY.  You can also give times like
     nnooww ++ count time-units, where the time units can be mmiinnuutteess,, hhoouurrss,, ddaayyss,,
     or wweeeekkss You can suffix the time with ttooddaayy to run the job today, or
     ttoommoorrrrooww to run the job tomorrow.

     For example, to run a job at 4PM three days from now, you would specify a
     time of 44PPMM ++ 33 ddaayyss.  To run a job at 10:00AM on on July 31, you would
     specify a time of 1100AAMM JJuull 3311.  Finally, to run a job at 1AM tomorrow,
     you would specify a time of 11AAMM ttoommoorrrrooww.

FILES     /var/at/jobs      Directory containing job files
     /var/at/spool     Directory containing output spool files
     /var/at/lockfile  Job-creation lock file.
     /var/run/utmp

SEE ALSO
     launchctl(1), launchd(8), nice(1), sh(1), compat(5), atrun(8)

AUTHOR
     Thomas Koenig, ig25@rz.uni-karlsruhe.de

BUGS
     Traditional access control to aatt and bbaattcchh via the files /var/at/at.allow
     and /var/at/at.deny is not implemented.

     If the file /var/run/utmp is not available or corrupted, or if the user
     is not logged in at the time aatt is invoked, the mail is sent to the
     srd on i te niomn vral LOGNAME.  f ht s neie
     or empty, the current userid is assumed.

NetBSD 0.9A                    December 5, 1993                    NetBSD 0.9A