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}.  
****************************************************************  
 
\zxhlp{AIPSB}      AIPS main program for executing batch jobs  
\zxhlp{AIPSC}      AIPS main program for testing and queuing batch jobs  
\zxhlp{BAMODIFY}   edits characters in a line of a batch work file  
\zxhlp{BATCH}      starts entry of commands into batch-job work file  
\zxhlp{BATCLEAR}   removes all text from a batch work file  
\zxhlp{BATEDIT}    starts an edit (replace, insert) session on a batch work file  
\zxhlp{BATER}      stand-alone program to prepare and submit batch jobs  
\zxhlp{BATFLINE}   specifies starting line in a batch work file  
\zxhlp{BATLIST}    lists the contents of a batch work file  
\zxhlp{BATNLINE}   specifies the number of lines to process in a batch work file  
\zxhlp{BATQUE}     specifies the desired batch queue  
\zxhlp{ENDBATCH}   terminates input to batch work file  
\zxhlp{JOBLIST}    lists contents of a submitted and pending batch job  
\zxhlp{JOBNUM}     specifies the batch job number  
\zxhlp{QUEUES}     Verb to list all submitted jobs in the job queue  
\zxhlp{REMQUE}     specifies the desired batch queue on a remote computer  
\zxhlp{UNQUE}      remove a given job from the job queue