ENABLE Reference Manual

ENABLE ATTRIBUTES
SCOBOLLIST Attribute
SCOBOLLIST Attribute
The SCOBOLLIST attribute identifies the file to which ENABLE
directs a compilation listing of the SCREEN COBOL program. The
syntax of the SCOBOLLIST attribute is:
-----------------------------------------------------------------
| |
| SCOBOLLIST [ <file-name> [!] ] |
| |
| NOTE: APPL must be the object type in effect when you |
| supply a value for this application attribute. |
| |
| <file-name> |
| |
| identifies the file to which the SCREEN COBOL compiler is |
| to write the compilation listing. <file-name> can be a |
| terminal, line printer, magnetic tape unit, process (for |
| example, a spooler process), or an unstructured disc |
| file. If <file-name> is a disc file, you must specify an |
| extent size for the file that is large enough to |
| accommodate the listing output when you create the file. |
| Note that the default extent size of 1 is insufficient. |
| |
| If <file-name> does not exist, you must include the |
| exclamation point symbol. |
| |
| If you omit the <file-name> option but enter the |
| SCOBOLLIST attribute, the SCREEN COBOL compiler directs |
| the compilation listing to the current ENABLE list file. |
| |
| ! |
| |
| indicates that the SCREEN COBOL compiler is to overwrite |
| an existing file. If a file named <file-name> already |
| exists and you include !, the data in the file is purged |
| before the write operation takes place. If a file named |
| <file-name> does not exist and you include !, ENABLE |
| creates the file. If a file named <file-name> exists and |
| you omit the !, ENABLE issues an error message. |
| |
| If you do not set a value for the SCOBOLLIST attribute, the |
| SCREEN COBOL compiler writes the compilation listing to a |
| temporary file with a name of the form ZZENLnnn. If no |
| errors occur during compilation, ENABLE purges this file. |
| |
-----------------------------------------------------------------
4-49