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 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 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 OUTPRINT).  If 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:  
   BATQUE     Number of queue to be used ( 1 or 2 or more )  
   JOBNUM     Job number involved (101 - 164, 201 -264, ...)  
   BATFLINE   First line number to be editted or listed  
   BATNLINE   Number of lines to be listed  
Verbs:  
   BATCH     Add text to BATQUE work file  
   BATCLEAR  Initiate and clear BATQUE work file  
   BATLIST   List BATNLINE starting with BATFLINE from BATQUE  
             work file  
   BATEDIT   Edit text in BATQUE work file starting with line  
             BATFLINE (or immediate argument)  
   BAMODIFY  Edit text in BATQUE work file in line BATFLINE (or  
             immediate argument), character-mode editing.  
   SUBMIT    Submit text in BATQUE work file as job for queue  
             BATQUE  
   JOBLIST   List BATNLINE starting with BATFLINE from text file  
             of job JOBNUM  
   QUEUES    List jobs submitted, running, and completed in  
             queue BATQUE  
   UNQUE     Remove JOBNUM from queue, copy text of job to work  
             file BATQUE  
 
Batch jobs may also be prepared and submitted outside of AIPS,  
using the program BATER.  See HELP 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