AT(1)                   COMMAND REFERENCE                   AT(1)



NAME
     at - execute commands at a later time

SYNOPSIS
     at [ -m ] [ -v ] time [ day ] [ filename ]

DESCRIPTION
     At squirrels away a copy of the named file (standard input
     default) to be used as input to sh (1sh) (or csh (1csh) if
     you normally use it) at a specified later time.  A cd
     command to the current directory is inserted at the
     beginning, followed by assignments to all environment
     variables (excepting the variable TERMCAP, which is useless
     in this context.) When the script is run, it uses the user
     and group ID of the creator of the copy file.

     The time is one to four digits, with the optional suffixes
     A, P, N, or M for AM, PM, noon or midnight, respectively.
     Semicolons separating hours and minutes are allowed.  One
     and two digit numbers are taken to be hours, three and four
     digits to be hours and minutes.  If no letters follow the
     digits, a 24 hour clock time is understood.

     The optional day is either a month name followed by a day
     number, or a day of the week; if the word "week" follows
     invocation is moved seven days further off.  Names of months
     and days may be recognizably truncated.

     At programs are executed by periodic execution of the
     command /usr/lib/atrun from cron (8). The granularity of at
     depends upon how often atrun is executed.

     Standard output or error output is lost unless redirected.

OPTIONS
     -m  Send mail notification when at job is run.

     -v  Verbose. Prints the name of the file containing your at
         job. The filename contains the date at which the job is
         scheduled to run.

EXAMPLES
     Examples of legitimate commands are



          at 8am jan 24 cmdfile
          at 1530 fr week cmdfile


     where cmdfile contains sh (csh) commands.




Printed 10/17/86                                                1

AT(1)                   COMMAND REFERENCE                   AT(1)



FILES
     /usr/lib/atrun           Executor (run by cron(8))

     /usr/spool/at/yy.ddd.hhhh.*
                              Activity for year yy, day dd, hour
                              hhhh

     lasttimedone             Last hhhh

     past                     Activities in progress

VARIABLES
     SHELL          The user's login shell. If it is /bin/csh,
                    that shell is used to execute commands.

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     Due to the granularity of the execution of /usr/lib/atrun,
     there may be bugs in scheduling things almost exactly 24
     hours into the future.

     Only twenty jobs may be scheduled to run in a single minute.
     All subsequent jobs will be rescheduled for the next minute
     that has open slots.

SEE ALSO
     calendar(1), csh(1csh), pwd(1), sh(1sh), sleep(1), cron(8).
















Printed 10/17/86                                                2

%%index%%
na:72,73;
sy:145,172;
de:317,1638;
op:1955,269;
ex:2224,241;
fi:2609,450;
va:3059,200;
rv:3259,511;
ca:3770,453;
se:4223,201;
%%index%%000000000159