MPE/iX Commands Reference Manual (32650-90877)

Chapter 13 551
Command List XI
Commands SHOWLOG thru STORE
By using the MPE/iX BUILD command and specifying a file code of 1029
or PROG, and a
numextents
value of 1. This file is then used by the PREP
command.
By specifying a nonexistent file in the
progfile
parameter, in which
case a job/session temporary file of the correct size and type is created.
listfile
Actual file designator of the file to which program listing is written. This
can be any ASCII output file. Formal designator is SPLLIST. Default is
$STDLIST.
masterfile
Actual file designator of the master file that is merged against
textfile
to
produce a composite source. This can be any ASCII input file. The formal
file designator is SPLMAST. Default is that the master file is not read; input
is read from
textfile
, or from $STDIN if
textfile
is not specified. If two
files being merged have identical line numbers, the lines from
textfile
or
from $STDIN overwrites those in
masterfile
.
newfile
Actual file designator of the file produced by merging
textfile
and
masterfile
. This can be any ASCII output file. The formal file designator
is SPLNEW. Default is that no file is written.
NOTE
The formal file designators used in this command (SPLTEXT, SPLLIST,
SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in
the command parameter list. For further information refer to the "Implicit
FILE Commands for Subsystems" section of the FILE command.
quotedstring
A sequence of ASCII characters bounded by a pair of single quotation
marks (apostrophes) or by double quotation marks. If you want a quotation
to appear within
quotedstring
, the quotation and its quotation marks
must also be bounded by quotation marks. For example, to insert "and"
into a
quotedstring
, it must appear as ""and"". Similarly, 'and' must
appear as ''and''. The maximum length of the string, including delimiters,
is 255 characters. Refer to "Operation Notes."
For SPL to recognize
quotedstring
, a dollar sign ($) must follow the
quotation marks at the beginning of the
quotedstring
. This feature is
used to specify compiler options which appear at the beginning of the
source listing.
Operation Notes
Compiles and prepares an SPL program into a program file on disk. If textfile is not
specified, MPE/iX expects you to enter your source program from your standard input
device. If you do not specify listfile, your program output is sent to your standard list
device.
The user subprogram library (USL) file created during compilation, $OLDPASS, is a
temporary file passed directly to the MPE segmenter. It can be accessed only if you do not
use the default for progfile. This is because the segmenter also uses $OLDPASS to store the
prepared program segments, overwriting the USL file of the same name.