SPL

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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)

Back to Main Index