call name(fortran,' batch use')
!head('introduction')
this document describes, in basic terms, how to use the FC Fortran compiler
in batch. For more information about the compiler itself you are referred to 
the FC user's guide.
!head('using batch') before batch may be used a batch user code must have been 
assigned and entered. a batch user code consists of two numbers, a group number 
and a user number.
this batch code is entirely separate from any UNIX terminal code that may have
been allocated.
!head('the $JOB card') the first card (or line) of a batch job must be a $JOB card.
its general format is: 
!i('$JOB name[group,user]; comment') 
!where(name) is a single word that is usually the name of the job or of the person
running the job. only the first 6 letters of "name" are remembered by the system.
!i(group) is the group number part of the batch user code. 
!i(user) is the user number part of the batch user code.
!i(comment) is anything you like, usually used to describe the job.
!p the $JOB card must be present at the start of a job or it will be ignored
!head('sample batch job')
the following batch job compiles and runs a simple fortran program:
)l2a
$JOB WEBB[20,1]; SAMPLE FORTRAN JOB
$FTN 
	WRITE(6,10)
10	FORMAT(' HI THERE')
	STOP
	END
$EXECUTE
$FINISH
) )l2
!head('notes on keypunching') 
you will notice that the characters "[" and "]" are not on the keypunch. 
in order to type a "[" you must use the cent sign (numeric and R). in order to
type "]" you must use the exclamation mark (!) (numeric and B). 
you will also notice that the keypunch has only one case (upper case) but that 
the card reader will read all upper case letters as lower case. don't worry about 
it, the system happens to assume that most text is lower case. 
!head('the $FTN command') the $FTN command is used in batch to invoke the Fortran
compiler (called FC elsewhere) on the following program. 
the $FTN command may have various options on it to affect the compilation. the
only ones likely to be used in batch are those that specify listing options or 
libraries. 
!p the default option is "--l1" which means that a source listing is requested. 
other options are:
!i(--l0) no source listing required.
!i(--l1) source listing.
!i(--l3) source listing plus map.
!i(-lo) search the "ourlib" library for missing subroutines.
!i(-lp) search the plot library for missing subroutines.
!i(-lz) search the 370 (470) library for missing subroutines.
!p note that the order of the compiler options is crucial, the compiler processes
them in the order in which they come. 
!p similarly, the order of libraries is crucial, as the linkeditor searches each 
library sequentially in the order in which they appear. this means that if you
use a routine in ourlib (-lo) that uses the plotter the -lo must appear before 
the -lp for the plotter routines. 
