HP 3000 Manuals HP 3000 Manuals
SPLPREP
Compiles and prepares a compatibility mode SPL/V program. SPL/V is not
part of the 900 Series HP 3000 Computer System Fundamental Operating
Software and must be purchased separately.
Syntax
SPLPREP [textfile] [,[progfile][,[listfile][,[masterfile][,newfile]]]]
[;INFO=quotedstring]
Parameters
textfile Actual file designator of the input file from which
the source program is read. This can be any ASCII
input file. Formal file designator is SPLTEXT.
Default is $STDIN.
progfile Actual file designator of the program file to which
the prepared program segments are written. When
you omit progfile, the MPE segmenter creates the
program file, which then resides in the temporary
file domain as $OLDPASS. If you do create your own
program file, you must do so in one of two ways:
* 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.
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
Related Information
Commands SPL, SPLGO, PREP, RUN
Manuals MPE Segmenter Reference Manual (32650-60026)
System Programming Language Reference Manual (30000-90024)