HP 3000 Manuals

The FTNXL Command [ HP FORTRAN 77/iX Reference ] MPE/iX 5.0 Documentation


HP FORTRAN 77/iX Reference

The FTNXL Command 

The MPE/iX command FTNiX invokes the FORTRAN 77 compiler and causes the
compiler to process the specified source program and generate object code
to an object file.

Syntax 

FTNXL [textfile] [, [objectfile] [, [listfile]]] [{; INFO=} " text "]
                                                 [{,      }         ]

-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
|       Item        |        Description/Default         |            Restrictions            |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
| textfile          | The name of the input file that    | Must be an ASCII file or a system  |
|                   | the FORTRAN 77 compiler will read; | defined file name such as $STDIN.  |
|                   | the default is $STDIN.             |                                    |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
| objectfile        | The name of the relocatable object | Must be a binary file or a system  |
|                   | file or relocatable library file   | defined file name such as          |
|                   | on which the compiler will write   | $OLDPASS; must have code type      |
|                   | the object code; the default is    | NMOBJ or NMRL.                     |
|                   | $OLDPASS.                          |                                    |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
| listfile          | The name of the file on which the  | Must be an ASCII file or a system  |
|                   | compiler will write the program    | defined file name such as          |
|                   | listing; the default is $STDLIST.  | $STDLIST.                          |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------
|                   |                                    |                                    |
| text              | A specification of initial         | Compiler directives must be        |
|                   | compiler directives.               | separated by semi-colons or        |
|                   |                                    | commas; "$" will be inserted at    |
|                   |                                    | the beginning of the string        |
|                   |                                    | automatically.                     |
|                   |                                    |                                    |
-----------------------------------------------------------------------------------------------

Description 

If textfile is omitted, the default file is $STDIN, which is the current
input device.  In a session, this device is the terminal, allowing you to
enter source code interactively.  For interactive mode, a special prompt
(>) appears on the screen.  Indicate the end of the source code by
entering a colon (:)  immediately after the prompt.  If listfile is
$STDLIST, the listing is echoed back to the terminal.  If listfile is
$NULL or a file other than $STDLIST, the listing is not echoed back to
the terminal, but is directed to $NULL or to the specified file.

If objectfile is omitted, the file $OLDPASS is the default.  If $OLDPASS
does not exist, the system uses $NEWPASS and renames it to $OLDPASS at
the end of the compile.  You can create a new object file in one of three
ways: 

   *   By specifying a nonexistent object file in the FTNXL command.
       This creates a permanent object file of the correct type.

   *   By saving a default $OLDPASS object file with the SAVE command.

   *   By building a new file of NMOBJ or NMRL type with the BUILD
       command.  The filecode parameter must be NMOBJ or NMRL, as in the
       following commands:

            :BUILD MYOBJ; DEV=DISC; CODE=NMOBJ
            :BUILD MYRL; DEV=DISC; CODE=NMRL

If the object file is of type NMRL, any existing module with an entry
point duplicating one in the current compilation unit will be replaced.
See the RLFILE and RLINIT compiler directives in Chapter 7  for
additional information.

If listfile is omitted, the system assigns the file $STDLIST as the
default file.  Typically, this is the terminal in a session or the
printer in a batch job.

The text field of the INFO parameter permits you to specify the compiler
directives that initially take effect.  FORTRAN 77 places a dollar sign
($) in front of the text field and places the string before the first
line of source code in the text file.  For example,

     FTNXL myfile ;INFO="SHORT;HP3000_16"



MPE/iX 5.0 Documentation