SPL


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. (CM)

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

o By using the MPE/iX SAVE command to save the
default USL file created during a previous compilation.

o By building the USL with the MPE Segmenter -
BUILDUSL command. Refer to the MPE Segmenter Manual
(30000-90011).

o By creating a new USL file with the MPE/iX
BUILD command and specifying a file code of USL or 1024.

o 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, 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
MPE/iX 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".

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 will appear at the beginning
of the source listing. For more information, refer
to the Systems Programming Language Reference Manual
(30000-90024).


OPERATION


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 will be sent to your standard list device.

This command may be issued from a session, job, or program. It may not
be used in BREAK. Pressing [Break] suspends the execution of this
command. Entering RESUME continues the execution.


EXAMPLE(S)

     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 will be sent to the disk file LISTFL

SPL SOURCE,OBJECT,LISTFL
SAVE OBJECT

ADDITIONAL INFORMATION

Commands:   SPLGO, SPLPREP

Manuals : Systems Programming Language Reference Manual (30000-90024)
A Word Version of the manual can be found at SPL_Manual.DOC