13.5 BATCH
Type: Operations to prepare, submit, and monitor batch jobs
Use: There are two batch streams of AIPS, each capable of
processing a queue of jobs. To run a batch job, one must
first prepare the text of the job in a work file. This text
may contain any normal AIPS/POPS statement including \zxhlp{RUN},
except for verbs and tasks related to batch preparation, the
TV, the TEK4012 green screen, and the tape drives. When the
text is ready, it may be submitted to the batch AIPS. On
the way, it is tested for errors and is submitted only if
none are found. After successful submission, the work file
and any \zxhlp{RUN} files involved may be altered without affecting
the job. Array processor tasks are allowed only in queue
#2 and only at night. They may be submitted at any time,
however. Line printer output should be directed to a user
chosen file (via adverb \zxhlp{OUTPRINT}). If \zxhlp{OUTPRINT} = ’ ’, all
tasks and AIPS itself will write to a file named
PRTFIL:BATCHjjj.nnn, where jjj is the job number in hex and
nnn is the user number in hex. Note that all print jobs
are concatenated into the specified file(s).
Adverbs:
\zxhlp{BATQUE} Number of queue to be used ( 1 or 2 or more )
\zxhlp{JOBNUM} Job number involved (101 - 164, 201 -264, ...)
\zxhlp{BATFLINE} First line number to be editted or listed
\zxhlp{BATNLINE} Number of lines to be listed
Verbs:
\zxhlp{BATCH} Add text to \zxhlp{BATQUE} work file
\zxhlp{BATCLEAR} Initiate and clear \zxhlp{BATQUE} work file
\zxhlp{BATLIST} List \zxhlp{BATNLINE} starting with \zxhlp{BATFLINE} from \zxhlp{BATQUE}
work file
\zxhlp{BATEDIT} Edit text in \zxhlp{BATQUE} work file starting with line
\zxhlp{BATFLINE} (or immediate argument)
\zxhlp{BAMODIFY} Edit text in \zxhlp{BATQUE} work file in line \zxhlp{BATFLINE} (or
immediate argument), character-mode editing.
\zxhlp{SUBMIT} Submit text in \zxhlp{BATQUE} work file as job for queue
\zxhlp{BATQUE}
\zxhlp{JOBLIST} List \zxhlp{BATNLINE} starting with \zxhlp{BATFLINE} from text file
of job \zxhlp{JOBNUM}
\zxhlp{QUEUES} List jobs submitted, running, and completed in
queue \zxhlp{BATQUE}
\zxhlp{UNQUE} Remove \zxhlp{JOBNUM} from queue, copy text of job to work
file \zxhlp{BATQUE}
Batch jobs may also be prepared and submitted outside of AIPS,
using the program \zxhlp{BATER}. See \zxhlp{HELP} \zxhlp{BATER}.
****************************************************************
AIPSB | AIPS main program for executing batch jobs |
AIPSC | AIPS main program for testing and queuing batch jobs |
BAMODIFY | edits characters in a line of a batch work file |
BATCH | starts entry of commands into batch-job work file |
BATCLEAR | removes all text from a batch work file |
BATEDIT | starts an edit (replace, insert) session on a batch work file |
BATER | stand-alone program to prepare and submit batch jobs |
BATFLINE | specifies starting line in a batch work file |
BATLIST | lists the contents of a batch work file |
BATNLINE | specifies the number of lines to process in a batch work file |
BATQUE | specifies the desired batch queue |
ENDBATCH | terminates input to batch work file |
JOBLIST | lists contents of a submitted and pending batch job |
JOBNUM | specifies the batch job number |
QUEUES | Verb to list all submitted jobs in the job queue |
REMQUE | specifies the desired batch queue on a remote computer |
UNQUE | remove a given job from the job queue |
|