Trailing-Edge
-
PDP-10 Archives
-
BB-PBDEB-BB_1990
-
10,7/system/execut.hlp
There are 2 other files named execut.hlp in the archive. Click here to see a list.
EXECUTE Command
Function
The EXECUTE command compiles the specified source files, if
necessary, loads the generated REL files into core, and begins
execution of the program. The system determines the proper
language compiler to use from the source file extensions or from
switches you specify in the command string. (See the COMPILE
command help file, COMPIL.) If a .REL file already exists with a
newer date than that of the source file, the system does not
compile the file unless you request this explicitly with a
switch.
This command is equal to issuing the LOAD and START commands.
Each time you issue a COMPILE, LOAD, EXECUTE, or DEBUG command,
the system remembers the command with its arguments in a
temporary file on disk or in core. Therefore, when you issue one
of these commands without specifying any arguments, the system
uses the arguments that it saved in the temporary file. For more
information, see the help file on COMPILE-class commands, COMCMD.
The EXECUTE command accepts several command constructions: the @
construction (indirect commands), the + construction, the =
construction, and the < > construction. For more information,
see the COMPILE-class commands help file, COMCMD.
This command runs the COMPIL program, which interprets the
command before running the appropriate language compiler for
LINK.
Format
EXECUTE file-spec
Where: file-spec is a single file specification or a string of
file specifications separated by commas. A file
specification consists of a device name, a file name
with or without an extension, and a directory name.
For more information see the file specifications help
file, FISPEC.
You can use the following switches to modify the command string.
These switches can be temporary or permanent switches unless
otherwise stated. For more inrofmation see the switch help file,
SWITCH.
Switch Function
/ALGOL Compiles the file with ALGOL. Assumed for files
with the extension of .ALG.
/BINARY Generates a binary file for each file compiled.
The file name for the binary file follows the
standard conventions for determining the name of
the output file. (See the COMPILE command help
file, CCMND.) The file name extension is .REL.
This is the default action.
/BLISS Compiles the file with BLISS-10. Assumed for
files with the extension of .B10 or .BLI. This
switch is not supported.
/C68 Runs the appropriate COBOL compiler.
/C74
/COBOL Compiles the file with COBOL. Assumed for files
with the extension of .CBL.
/COMPILE Forces a compilation of this file even if a binary
file exists with a newer date and time than the
source file. You can use this switch to obtain an
extra compilation (for example, to obtain a
listing) because the system does not perform
compilation if the binary file is newer than the
source file.
/CREF Produces a cross-referenced listing file on the
disk for each file compiled, for later processing
by the CREF program. The file extension of the
output file is .CRF. You can then list the files
using the CREF command. However, with COBOL
files, the system appends the cross-referenced
listing to the listing file.
/DDT Loads the program debugger DDT with the program.
/DEBUG:(arg, arg,...)
Passes the arguments to FORTRAN. Refer to the
TOPS-10/TOPS-20 FORTRAN Language Manual.
/DLIST Produces a .LST file in your directory area. You
can output the file to the line printer with the
PRINT command.
/F40 Obsolete
/F10
/F66 Applies FORTRAN-66 rules for DO loops and EXTERNAL
statements.
/FOROTS Obsolete
/FORSE
/FORTRAN Compiles the file with a FORTRAN compiler.
Assumed for files with the extension of .F4 and
.FOR and all files with nonrecognizable compiler
extensions if FORTRAN is the standard compiler.
You need to specify this switch if the file has a
nonrecognizable compiler extension and FORTRAN is
not the standard compiler or is not the current
default. (For example, EXE/ALGOL FIL1, FIL2,
FIL3/FORTRAN).
/FUDGE: Creates a temporary file that contains the names
file-spec of the .REL files produced by the command string
plus the library file name. When you issue the
FUDGE command, PIP reads this temporary file to
generate a library .REL file. (Refer to the FUDGE
command description.) The argument to this switch
is:
dev:file.ext[proj,prog]
Where: dev: is the device on which to write the
file. If you omit the device, the system
assumes DSK.
file.ext is the name of the library file.
The file name is required. If you omit
the extension, the system assumes .REL.
[proj,prog] is the directory in which to
place the file. Your directory is assumed
if you do not specify a directory.
This switch is permanent in the sense that it
pertains to all .REL files generated by the
command string.
/GFLOAT Indicates that double-precision numbers are to be
stored in G-floating format. This format has an
extended exponent range. This option is available
on KL-10 proessors only.
/K?10 Designates the processor where the program will
execute once it has been loaded. The variable (?)
can be L or S. These switches are necessary for
FORTRAN-10 programs because the compiler generates
different code for the processors. The default is
the processor on the computer executing the
command.
/LIBRARY Loads the files in library search mode. This mode
causes a program file in a special library file to
be loaded only if one or more of its declared
entry symbols satisfies an undefined global
request in the source file. The system libraries
are always searched. (See the TOPS-10 LINK
Reference Manual.)
/LINK Obsolete
/LIST Generates a listing file for each file compiled.
The extension of the output file is .LST. The
system automatically spools it when you log out.
The complement of this switch is /NOLIST.
/LMAP Produces a loader map during the loading process
containing the local symbols.
/LOADER Obsolete
/MACRO Assembles the file with MACRO. Assumed for files
with extensions of .MAC.
/MACY11 Assembles the file with MACY11. Assumed for files
with extensions of .P11. This switch is not
supported.
/MANTIS Compiles the file with MANTIS debugging
information. This switch affects Fortran-40 files
only. This switch is not supported.
/MAP Produces loader maps during the loading process.
When this switch is encountered, a loader map is
requested from the loader. After the library
search of the system libraries, the map is written
in your disk area with either the file name
specified by you (for example, /MAP:file) or the
default file name nnnLNK.MAP. This switch is an
exception to the permanent switch rule in that it
causes only one map to be produced even though it
appears as a permanent switch.
/NEW Runs the appropriate language compiler from the
experimental system library (device NEW:) area
[1,5]. If the compiler does not exist on device
NEW:, COMPIL tries to obtain it from device SYS:.
(Refer to the Restriction.)
/NOBINARY Does not generate binary files. Unless you issue
this switch, the system generates binary files.
This switch, when combined with the /CREF or /LIST
switch, is useful when you compile programs solely
for the purpose of generating listings.
/NOCOMPILE Does not force a compilation on a source file
whose date is not as recent as the date on the
binary file. This switch is not the same as the
/REL switch, which turns off all compilations,
even if the source file is newer than the .REL
file. Complement to the /COMPILE switch.
/NOCOMPILE is the default action.
/NODEBUG Does not pass previously specified arguments to
FORTRAN.
/NOLIST Does not generate listing files. This is the
default action.
/NOMANTIS Compiles the file without MANTIS debugging
information. This switch affects Fortran-40
programs only. This switch is not supported.
/NOOPTIMIZE Does not optimize the object code of FORTRAN
programs.
/NOSEARCH Loads all routines of the file whether the
routines are referenced or not. Because this is
the default action, this switch is used to turn
off library search mode (/LIBRARY).
/OLD Runs the appropriate language compiler from the
system library of old programs (device OLD:) which
resides on the disk area [1,3]. If the compiler
does not exist on device OLD:, COMPIL tries to
obtain it from device SYS:. (Refer to the
Restriction.)
/OPTIMIZE Optimizes the object code of FORTRAN source
programs.
/PAL10 Assembles the file with PAL10. Assumed for files
with the .PAL extension.
/PASCAL Compiles the file with Pascal. Assumed for files
with the .PAS extension.
/REL Uses the existing .REL files although newer source
files might be present.
/SAVE Saves the core image of the loaded program.
/SEARCH Loads the files in library search mode. The
action is identical to that of the /LIBRARY
switch.
/SELF Runs the appropriate language compiler from device
DSK: instead of from the system library (device
SYS:). This switch is useful if you keep a
private copy of a compiler in your own disk area.
(Refer to the Restriction.)
/SNOBOL Compiles the file with SNOBOL. Assumed for files
with an extension of .SNO. This switch is not
supported.
/SSAVE Saves the core image of the loaded program in a
sharable executable file.
/SYS Runs the appropriate language compiler from the
system library (device SYS:) area [1,4]. This is
the default action.
Restriction
You cannot specify compilers from different structures in the
same command string. For example, the following is invalid:
.EXECUTE PARTA.FOR/NEW,PARTB.FOR/OLD
However, the following is valid:
.COMPILE PARTA.FOR/NEW<RET>
.COMPILE PARTB.FOR/OLD<RET>
.EXECUTE/REL PARTA,PARTB
Characteristics
Requires LOGIN.
Places your terminal at user level.
Runs the appropriate compiler or assembler and linking
loader, destroying your original core image.
Starts the execution of the compiled and loaded program.
Example
Type out a test program.
.TYPE PROG.FOR<RET>
TYPE 10
10 FORMAT (' TESTING EXECUTION')
END
Execute the program.
.EXECUTE PROG.FOR<RET>
FORTRAN: PROG
MAIN
LINK: LOADING
[LNKXCT PROG EXECUTION]
TESTING EXECUTION
END OF EXECUTION
CPU TIME: 0.02 ELAPSED TIME: 0.05
EXIT
.
Message shows the time parameters of your job.