620 Chapter 8
Command Definitions SP-Z
SPLPREP
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.
Use
This command may be issued from a session, job, or program but not in BREAK. Pressing
Break suspends the execution of this command. Entering the RESUME command continues
the execution.
Examples
To compile and prepare an SPL program entered from your standard input device, and
send the output to your standard list device, enter:
SPLPREP
The following example compiles and prepares an SPL source program from the disk file
SFILE into the program file MYPROG. The program listing is sent to your standard list
device:
SPLPREP SFILE,MYPROG
In the next example, the first positional parameter is omitted. This indicates to MPE/iX
that you intend to enter the source text from your standard input device. The object code is
stored in the default USL file $OLDPASS, and the prepared program segments are stored in
FILEZ. $OLDPASS is then saved in the permanent file domain under the new name NUSL.
SPLPREP,FILEZ
SAVE $OLDPASS, NUSL
