pTAL Reference Manual (G06.24+, H06.09+, J06.03+)

Example 320 Compiler Command Lines
ptal / in test, out $s.#test, nowait/ testobj; symbols
eptal / in test, out $s.#test, nowait/ testobj; symbols
The compiler reads input only from a single edit-format disk file. You can use the SOURCE (page 514)
in this input file to read code from other source files during compilation. The input file and code
read from other source files comprise a compilation unit.
In general, the compiler opens each source file as it needs the source file and keeps the source
file open until the end of the compilation. This behavior ensures that the contents of the file cannot
change between the time the compiler reads the file and creates a listing. You can open a source
file for read access, but generally not for write access, while the source file is compiling.
When the number of files read exceeds the maximum number of files that Guardian allows to be
open, the compiler closes the least recently used file (unless that file is the primary source file,
which is always kept open) in order to continue to open and read source files.
If you edit a file before the compiler creates an output listing, the source code in the listing will not
match the code in the source file. The compiler reports a warning if it discovers that part of a source
file has changed. Do not alter the source files until the compilation ends.
Topics:
• Input Files (page 356)
• Output Files (page 356)
• Running the Compiler (page 357)
• Completion Codes Returned by the Compiler (page 358)
Input Files
The compiler reads input only from an edit-format disk file up to a maximum of 132 characters for
each record, ignoring characters after the 132nd (and issuing a warning for each such line). The
compiler does not read input from a terminal or from any other source or file format.
Output Files
You can direct list output from the compiler to any of the following types of files:
• Spooler
• Entry-sequenced file
• Relative file
• Terminal
• Process
• Printer
• Edit-format file
• HP TACL variable
If you direct output to a disk file that does not exist, the compiler creates an edit-format file and
writes the compiler listing to the newly created file.
If you direct output to an edit-format file that already exists, the compiler removes the existing file
from your current compilation and creates a new file using the file name you specified.
356 Compiling and Linking pTAL Programs