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