FORTPREP



FORTPREP

     Compiles and prepares a Compatibility Mode FORTRAN 66/V
program. HP FORTRAN 66/V is not part of the 900 Series HP
3000 Computer System Fundamental Operating Software and must
be purchased separately. (CM)

SYNTAX

     FORTPREP [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. The formal file designator is FTNTEXT.
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 will create the
program file, which will reside in the temporary
file domain as $OLDPASS. If you create your own
program file, you must do so in one of two ways:

o Use the MPE/iX BUILD command, and specify a file
code of 1029 or PROG, and a numextents value of
1. This file is then used by the PREP command.

o Specify a nonexistent file in the progfile
parameter, resulting in the creation of
job/session temporary file of the correct type.

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 FTNLIST.
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 FTNMAST. 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 resulting from
the merger of textfile and masterfile. This can be
any ASCII output file. The formal file designator
is FTNNEW. Default is that the file is not written.

quotedstring A sequence of characters between two single
quotation marks (apostrophes) or between two double
quotation marks. You may use the delimiter as part
of the string so long as the delimiter appears
twice. Any occurrence of two single quotation marks
in a row, or two double quotes in a row, is
considered part of the string, and, therefore, not
the terminating delimiter. INFO=quotedstring is
used to pass initial compiler options to a program.

NOTE

The formal file designators used in this command (FTNTEXT, FTNLIST,
FTNMAST, and FTNNEW) 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.

OPERATION

     This command compiles and prepares a Compatibility Mode
FORTRAN 66/V program into a program file stored on disk. If
you do not specify a source file, MPE/iX expects the input
from your standard input device. If you do not specify
listfile, MPE/iX sends the output to your standard list device.

The USL file created during compilation is a system-defined
temporary file $OLDPASS, which is passed directly to the MPE
Segmenter. The Segmenter also uses the file $OLDPASS. The
prepared program segments are written to it, thus
overwriting any existing temporary file of that name.

If you have no need to examine the USL file, use the default
for progfile. This way, MPE/iX will create a program file
for you, ensuring the best results. If, on the other hand,
you want to store the USL file and the program file as
separate entities, create a permanent program file with the
BUILD command, and reference it in the FORTPREP command
line. When you create the file, you must specify a file
code of PROG or 1029 and a numextents parameter value of 1,
as shown in the example below.

BUILD PROGX;CODE=PROG;DISC=1

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)

     To compile and prepare an FORTRAN 66/V program entered from
your standard input device, into the standard default file
$OLDPASS, with the listing printed on your standard list
device, enter

FORTPREP

To compile and prepare an FORTRAN 66/V source program from a
text file named TEXTX into a program file named PROGX, with
the resulting listing sent to the list file LISTX, enter

FORTPREP TEXTX,PROGX,LISTX

The FORTPREP command combines the compilation and
preparation steps. The compiled program segments, stored in
the file $OLDPASS, are prepared and stored in the program
file PROGX. Therefore, it is equivalent to

FORTRAN TEXTX, LISTX
PREP $OLDPASS,PROGX

ADDITIONAL INFORMATION

Commands:   FORTGO, FORTRAN

Manuals :   HP FORTRAN 77/iX Reference (31501-90010)
            MPE Segmenter Reference Manual (32650-60026)