SPROGS Note No 16: New proposed macro specification

R E Thomas

26 January 1973

The SPROGS macro allows a user to compile and run a FORTRAN job together with the SPROGS graphics package. The macro may be O0BEYed, in which case a background job is initiated, or may be called from a RUNJOB command. The following parameters are available.

JT time

JT specifies the jobtime for this run. Default setting is 119 secs.

CR, TR. CR filename, TR filename

This parameter must appear somewhere, and should be the first, unless the LOAD parameter is used (see later). The FORTRAN source for the job is taken from the job itself or from filename. More than one source parameter may appear, in which case the files will be compiled in order.

PAR filename

PAR Indicates that the user is supplying his own program parameters for the compiler in file filename. Otherwise default parameters will be used if the first source file does not begin with a set.

LP, LP filename

Computer output will be sent to the monitor file or to filename. Otherwise it is sent to a workfile.

COMP filename

Semi compiled output will be saved in filename.

SEMI filename

Semi-compiled routines in filename will be included at consolidation. There may be several SEMI parameters.|

BIN filename

The binary program will be sent to filename by the consolidator. However, this will not prevent execution of the program.

NORUN

The job will not go into execution after consolidating.

LOAD filename

Compilation and consolidation are ignored, and the binary program in filename is loaded.

SAVE filename

The core image after consolidation is saved in filename as a DA file.

MS coresize

The maximum size of the user's job is set to coresize.

##CRn, ##CPn, ##TRn filename, ##CRn filename, ##CPn,filename, ##TPn filename

Any number of these parameters may occur. The specified basic peripherals will be set up before the job begins execution, with data being read from the job itself or from filename, or sent to the monitor file or filename n is a single digit specifying the stream number.

##LPn, ##LPn filename

This sets up the job's lineprinter streams. SPROGS makes use of streams 0, 1, 5 and 6. All lineprinter streams will be listed, with the exception of streams 5 and 6 if NOTAPE is present (see below).

NOTAPE

SPROGS uses MTI4 for SD4020 output. If no SD4O20 output is required, this parameter prevents the tape being loaded, and lineprinter streams 5 and 6 being printed.

##EDn filename, ##MTn file name

As for basic peripherals, ED and MT streams are set up. Filename may be an exofile or a tape. Any qualifiers required should follow filename in brackets.

MOPEJ name

If the job is initiated via MOP, this parameter is inserted to allow a BROADCAST to the required terminal when the job is complete. The user may use this parameter to force a broadcast.

EJ, EJ (list)

Normally, the macro will EXIT. If EJ or MOPEJ are present, the macro halts

ENDJOB ALLBUT, COMMANDS

However, if EJ (dist) is specified, the macro halts

ENDJOB list 

where list should contain a series of legal ENDJOB parameters.

The default program parameters are

SEMICONPILED (A. SUBROUTINES) 
LIBRARY (B.SUBROUTINES) 
PROGRAM (SPRG) 
OUTPUT 12 = LP5 
OUTPUT 13 = LP6 
EXTENDED 
ABNORMAL FUNCTIONS 
OUTPUT 1, (MONITOR)= LP0 
END 

The SPROGS semi compiled is held in two files, which are always the last two files presented to the consolidator.

XFIH and XPCH are used to compile and consolidate.