z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

Options
creation mask, and so on that are set up when you run the at command; however,
at does not usually preserve open file descriptors, traps, or priority inherited from
the working environment.
Usually, you redirect the standard output (stdout) from these commands to files so
you can read the files after the system runs the commands. at mails the standard
output (stdout) and standard error output (stderr) to you if you do not redirect
them.
The at command displays an at-job identifier when you submit commands, along
with the time that the system is to run the commands.
at, batch, and crontab submit jobs to cron; the data in these jobs may contain
doublebyte characters. When the jobs are run, the data in the jobs are interpreted
in the locale that cron is using. Since it is strongly recommended that cron be
started in the POSIX locale, doublebyte characters in the job may not be interpreted
correctly. You can get around this by calling setlocale() in the job itself.
–f file Reads commands from file rather than from standard input (stdin).
–l Reports on standard output (stdout) all jobs you have scheduled and when
the system is to run them if you do not specify at_job. If you specify
at_jobs, this option reports information on only those jobs.
–m Sends you mail after your job has finished running. If you did not redirect
the stdout and stderr, at also mails these to you. If stdout or stderr is
non-null, at mails this output to you even if you do not specify –m.
–q queue
Specifies the queue your at job is to be recorded in or removed from.
queue can be any singlebyte character except a space, a tab, a null
character, or a number sign (#). By default, at stores all its jobs in a queue
called a, and batch stores all its jobs in a queue called b. If used with this
option, –l reports information only on at jobs in queue.
–r at_job
Removes previously scheduled at jobs. The at_job arguments must be the
identifiers assigned to the jobs when you set them up with at.
–t time
Specifies the time for the system to run the job. You specify time in the
same format as the time argument for touch.
When you do not use the –t option, you can use a timespec argument to specify
the time. A timespec argument consists of three parts: a time, a date, and an
increment (in that order). You must always specify the time, but you can omit the
date, the increment, or both. Following are possible time formats:
Format Meaning
hhmm hh hours, mm minutes, 24-hour clock
hh:mm hh hours, mm minutes, 24-hour clock
h:mm h hours, mm minutes, 24-hour clock
h:m h hours, m minutes, 24-hour clock
hh:mm zone zone is time zone
at
Chapter 2. Shell command descriptions 23