HP 3000 Manuals HP 3000 Manuals
SPL
Compiles 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
SPL [textfile] [,[uslfile][,[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. The formal file designator is SPLTEXT.
Default is $STDIN.
uslfile Actual file designator of the user subprogram
library (USL) file to which the object code is
written. This can be any binary output file
created with a file code of USL or 1024. Its
formal file designator is SPLUSL. If the uslfile
parameter is omitted, the object code is saved to
the temporary file $OLDPASS. If the uslfile
parameter is entered, it indicates that the file
was created in one of four ways:
* By using the MPE/iX SAVE command to save the
default USL file created during a previous
compilation.
* By building the USL with the MPE segmenter
-BUILDUSL command. Refer to the MPE
Segmenter Manual (30000-90011).
* By creating a new USL file with the MPE/iX
BUILD command and specifying a file code of
USL or 1024.
* By having the statement $CONTROL USLINIT in
your program.
listfile Actual file designator of the file to which the
program listing is written. This can be any ASCII
output file. The formal file designator is
SPLLIST. Default is $STDLIST.
masterfile Actual file designator of the master file with
which textfile is merged 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.
newfile Actual file designator of the file created by
merging textfile and masterfile. This can be any
ASCII output file. Formal designator is SPLNEW.
Default is that no file is written.
NOTE The formal file designators used in this command (SPLTEXT, SPLUSL,
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"
discussion of the FILE command.
quotedstring A sequence of ASCII characters bounded by a pair of
single quotation marks (apostrophes) or by double
quotations 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. For more
information, refer to the Systems Programming
Language Reference Manual (30000-90024).
Operation Notes
This command compiles an SPL program into a user subprogram library (USL)
file on disk. If textfile is not specified, MPE/iX expects the source
program to be entered from your standard input device. If listfile is
not specified, the program output is sent to your standard list device.
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
The following example compiles an SPL program entered from your standard
input device into an object program in the USL file $OLDPASS, and writes
the listing to your standard list device:
SPL
The next example compiles an SPL program contained into the disk file
SOURCE and stores the object code into the USL file OBJECT. The program
listing is sent to the disk file LISTFL:
SPL SOURCE,OBJECT,LISTFL
SAVE OBJECT
Related Information
Commands SPLGO, SPLPREP, PREP, RUN
Manuals Systems Programming Language Reference Manual (30000-90024)