The output files produced by the compiler consist of the following:
-
CODE: the object code file
-
NEWSOURCE or NEWTAPE: the updated source code file
-
LINE: the printer listing of the program
-
ERRORS or ERRORFILE: the error message file
-
CORISOLREPORT: a report file for possible vulnerability
-
XREFFILE: cross-reference information
-
INFO: information used for separate compilation
CODE File
The CODE file is produced unconditionally and contains the executable object code produced by the compiler. This file is stored permanently, executed and then discarded, or discarded, depending on the specifications in the WFL or CANDE COMPILE statement that initiated the compiler, and depending on whether syntax errors occurred during the compilation. For more information on the WFL and CANDE COMPILE statements, refer to the Work Flow Language (WFL) Programming Reference Manual and the CANDE Operations Reference Manual.
The object code file title can be specified using file equation. If the compiler is invoked from WFL, the code file title is specified in the WFL COMPILE statement. If the compiler is invoked from CANDE, the code file title is determined from the object file name or source file title parameter specified in the CANDE COMPILE statement or from the work file title.
When separately compiled procedures suitable for binding—without an outer block—are compiled, the last node of the file name is replaced by the file name. In such cases, the $LEVEL default value is 3. When procedures intended for execution as a task are compiled, the object code file name is retained as previously specified. In such cases, $LEVEL must be set explicitly to 2.
NEWSOURCE File
The synonym NEWSOURCE can be used in place of NEWTAPE.
The NEWSOURCE file is produced only if the NEW compiler control option is TRUE. The NEWSOURCE file is an updated source file that consists of the source input from the CARD file, the SOURCE (or TAPE) file, and (if the INCLNEW compiler control option is TRUE) the included files that were actually compiled. If either NEWSOURCE or NEWTAPE are not file equated, a disk file is created with the name NEWSOURCE. For more information on the NEW and INCLNEW options, see “New Option” and “INCLNEW Option” later in this section.
LINE File
The LINE file is produced if either of the compiler control options LIST or TIME is TRUE. If compiler file equation is not applied to the LINE file, it is a printer file.
The contents and format of the LINE file depend on the values of the following compiler control options:
|
CODE |
MAP |
|
FORMAT |
PAGE |
|
LISTDELETED |
SEGS |
|
LISTINCL |
SINGLE |
|
LISTOMITTED |
STACK |
|
LISTP |
TIME |
The LINE file always contains at least the following information:
-
The title of the source file CARD used as input to the compiler
-
Code segmentation information
-
Error messages and error count, if syntax errors occur
-
Summary information about the compile, such as the number of lines read and the size of the object code file
For more information about the compiler control options that affect the LINE file, see “Option Descriptions” later in this section.
ERRORS File
The synonym ERRORFILE can be used in place of ERRORS.
The ERRORS file is produced only if the ERRLIST compiler control option is TRUE. If either ERRORS or ERRORFILE are not equated, the file is created with the title ERRORS. It is a printer file if the compile is initiated through WFL, and a remote file if the compile is initiated through CANDE. If no syntax errors occur during compilation, no ERRORS file is produced, regardless of the value of the ERRLIST option. For more information on the ERRLIST option, see “ERRLIST Option” later in this section.
For every syntax error that occurs during compilation, two records are written to the ERRORFILE file. The first record is a copy of the source record that contains the error. The second record contains the sequence number of that source record (if the source record was sequenced) and the error message.
CORISOLREPORT File
The CORISOLREPORT file is produced only if the CORISOL compiler control option is TRUE. If CORISOLREPORT is not file equated, the file is created with one of the following names:
-
CORISOLREPORT/SUSCEPTIBLE/<object code file name>, if the compiler issues a warning for a potential vulnerability in an object code file
-
CORISOLREPORT/CLEARED/<object code file name>, if the compiler does not issue a warning.
For more information on the CORISOL option, see “CORISOL Option” under Option Descriptions later in this section.
XREFFILE File
When either of the compiler control options XREF or XREFFILES is TRUE, the compiler saves raw cross-reference information in the XREFFILE file. The contents of the file are affected by the compiler control options XDECS and XREFS. Before this information can be printed or read by SYSTEM/INTERACTIVEXREF or the Editor, it must be analyzed by SYSTEM/XREFANALYZER. The XREFFILE file is given the file name XREF/<code file name>, where <code file name> is the file name of the object code file being produced. For more information about the cross-reference options, see “Option Descriptions” later in this section. By default, SYSTEM/XREFANALYZER is run as a separate task that might complete long after the compiler terminates. Setting the XREFWAIT compiler control option causes the compiler to wait for SYSTEM/XREFANALYZER to complete prior to termination.
INFO File
The INFO file contains the contents of variables and tables used in the compiler. It is intended for use in separate compilations of procedures. This file is created by the DUMPINFO compiler control option, and it is used as an input file by the LOADINFO compiler control option.
