Ausam/doc/man/man1/submit.1

.th SUBMIT I 2/2/78
.sh NAME
submit  \*-  submit a job to central Cyber
        \*-  submit a local batch (PDP11) job
.sh SYNOPSIS
.bd submit
name [output]
.sh DESCRIPTION
The card deck image file
.it name
is scanned to determine its type
(local jobs have a `%' as their first character)
and entered into the
appropriate local or cyber queue. 
Syntactic checking of job cards is performed as well as checking
for lines longer than 80 characters.
.s3
.ti -1
.bd CYBER:
.br
Cyber jobcards will be accepted in either of the
KRONOS\ 2.1 formats,
.in +5
.sp
.nf
jobname,pxx,tyyyy,cmzzzzzz.
.sp
jobname,xx,yyyy,zzzzzz.
.sp
.in -5
.fi
where
.it jobname
is an alphabetic character followed by up to 6 alphanumeric characters,
and
.it xx
,
.it yyyy
and
.it zzzzzz
are octal numbers with maxima of 17, 7777, and 120000 (currently)
respectively. All are optional with the default `cm' being 60000.
(See KRONOS\ 2.1 Reference Manual for explanation)
.sp
Kronos End\*-Of\*-Record and End\*-Of\*-File cards can be
represented by a line containing a single `control\ r' or
`control\ f' (ASCII DC2 and ACK) respectively.
An End\*-Of\*-Information is automatically generated at the end
of the file. Lines with more than 80 characters will cause an error
as the Cyber really thinks that your file is a deck of
80 column cards and there is no way that you can make it think any
different!
.sp
If a second argument
is given, the output returned by the Cyber will be placed in
a file of that name in your initial directory (I.e.
.it %yourname/output
), and you will be notified by write(I) or mail(I).
If there is no second argument
all output generated will be printed on the line printer.
.s3
.ti -1
.bd LOCAL:
.br
The format of the first two
lines of a local job is as follows,
.sp
.in +5
.nf
%jobname
%jobtype
.fi
.sp
.in -5
where
.it jobname
can be any sequence of up to seven alphnumeric characters, and
.it jobtype
is one of the following:
.sp
.nf
.in +5
pascal    \*-  The UNIX Pascal Compiler
snobol    \*-  The Spitbol Interpreter
assemble  \*-  The Macro\*-11 Assembler
fortran   \*-  The RT11 based Unix Fortran Compiler
list      \*-  A card deck Lister
.fi
.in -5
.sp
Following these two lines should be the program in normal
line image form.
Data for the program (except for Snobol, whose data is considered part of the program)
is separated from the program by a line
containing the character `control\ r' (ASCII DC2). Anything
after this line will be made available to the program as its
standard input.
.sp
If a second argument is specified for local jobs, it will be ignored.
All output including diagnostics generated by the submitted
job will be printed on the
line printer.
.sh FILES
.nf
/spool/batch/.work/.checkpoint   checkpoint file
/spool/batch/.work/$*            scratch area
.fi
.sh "SEE ALSO"
.nf
KRONOS\ 2.1 Reference manual.
ASCII (VI)
.fi
.sh DIAGNOSTICS
Mostly self explanatory.
.in +30
.sp
.na
.ta \n(.iu-\n(.ou
.ti -25
Batch not active.	Local batch system is not running.
.ti -25
Illegal job card	Incorrect cyber job card, or
parameters out of range.
.ti -25
Unknown batch function	Invalid or missing local processor
card.
.ad
.in -30
.sh AUTHOR
Chris Maltby. UNSW Mar '76
.sh BUGS
Garbage is sometimes printed out when files submitted have lines too long.