HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 8 Command Definitions SP-Z

SPL

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Compiles a compatibility mode SPL/V program. SPL/V is not part of the HP 3000 Series 900 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

Feedback to webmaster