NAME

proto − prototype job file for at(1)

SYNOPSIS

/usr/lib/cron/.proto /usr/lib/cron/.proto.queue

DESCRIPTION

When a job is submitted to at(1) or batch(1), the job is constructed as a Bourne shell script.  The job file is created in /usr/spool/cron/atjobs as follows:

•At(1) creates a header describing the job as an at job or a batch job.  At(1) jobs submitted to all queues other than queue a are listed as batch jobs.  The header will be

: at job

for an at job, and

: batch job

for a batch job. 

•A set of Bourne shell commands is added to make the environment (see environ(5)) for the at(1) job the same as the current environment.

•At(1) then copies text from the prototype file to the job file, except for special “variables” that are replaced by other text:

$d is replaced by the current working directory

$l is replaced by the current file size limit (see ulimit(2))

$m is replaced by the current umask (see umask(2))

$t is replaced by the time at which the job should be run, expressed as seconds since January 1, 1970, 00:00 Greenwich Mean Time, preceded by a colon

$< is replaced by text read by at(1) from the standard input (that is, the commands provided to at(1) to be run in the job)

When a job is submitted to queue queue, at(1) will use the file /usr/lib/cron/.proto.queue as the prototype file if it exists, otherwise it will use the file /usr/lib/cron/.proto. 

EXAMPLES

The following .proto file:

cd $d
ulimit $l
umask $m
$<

creates commands to change the current directory in the job to the current directory at the time at(1) was run, to change the file size limit in the job to the file size limit at the time at(1) was run, and to change the umask in the job to the umask at the time at(1) was run.  These commands are inserted before the commands in the job.

SEE ALSO

at(1), queuedefs(4)

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989