HP 3000 Manuals

Descriptions of Directives (cont.) [ Micro Focus COBOL System Reference, Volume 2 ] MPE/iX 5.0 Documentation


Micro Focus COBOL System Reference, Volume 2

Descriptions of Directives (cont.) 

ASM  

Causes the Compiler to insert disassembled generated code into the
Generator report (.grp) file.

Syntax:.   

[]
Parameters:. None Default:. NOASM Phase:. Generate Environment:. 16-bit $SET:. Initial Dependencies:. NOASM sets NOMASM at end. Set to ASM immediately by ASMLIST. Remarks:. ASM is automatically switched on when the ASMLIST directive is specified. You can produce a .grp file which contains Generator messages without assembler code by specifying ASMLIST() and NOASM (in that order). ASMLIST Makes the Compiler produce an assembly listing. Syntax:.
[]
Parameters:. destination A full file specification or a device-name. Default:. NOASMLIST Phase:. Generate Environment:. 16-bit $SET:. Initial Dependencies:. ASMLIST sets ASM immediately. NOASMLIST sets NOREF at end. Remarks:. If you specify an existing file it is overwritten. When NOASMLIST is specified, no assembly listing is produced. If you specify ASMLIST with no file-name, the assembly listing is sent to the screen. ASMLIST() causes the assembly listing to be put in the file source-name.grp, where source-name is the root of the name of the program being compiled. If you use ASMLIST together with SOURCEASM and you follow ASMLIST by the word NOASM, you get an assembly listing showing source code but not assembly code. This is useful because of the "BADCODE" comments you get on the source lines. See also:. MASM, PARAS, SOURCEASM (for details of "BADCODE") ASSIGN Specifies how to assign a file-name when neither EXTERNAL nor DYNAMIC appear in the SELECT statement. Syntax:.
[]
Parameters:. assign-type EXTERNAL or DYNAMIC. Defines the method. Default:. ASSIGN"DYNAMIC" Phase:. Syntax check Environment:. All $SET:. Initial Remarks:. For more details, see the chapter File Handling in your COBOL System Reference. ASSIGN-PRINTER Specifies how to assign the output from an ASSIGN TO PRINTER clause when the clause does not specify a file-name. Syntax:.
[]
Parameters:. file-name The file to be associated with the ASSIGN TO PRINTER clause. Default:. NOASSIGN-PRINTER Phase:. Syntax check Environment:. All $SET:. Any Remarks:. This directive has no effect if you specify a file-name as part of the ASSIGN TO PRINTER clause. On DOS, Windows and OS/2, NOASSIGN-PRINTER causes the output to be sent to the device LST:. On UNIX it causes the output to be placed in a file called LPT1. ASSIGN-PRINTER"file-name" causes the output to be directed to the file-name specified. The file-name can be fully specified, including a device, path-name, base-name, and extension. ASSIGN-PRINTER() results in the same behavior as including the following COBOL statement: select file-name-1 assign to printer file-name-1 That is, the file-name used in your COBOL program is also used as the file-name for your output. If the internal file-name is too long for your operating system to handle, it is truncated to the maximum length the operating system allows. By default, the file-name does not include an extension, but you can specify an extension by using the PRINT-EXT directive. See also:. PRINT-EXT ASSUME Controls the interaction between certain generator directives. Syntax:.
[]
Parameters:. None Default:. ASSUME Phase:. Generate Environment:. 16-bit $SET:. Initial Dependencies:. If ASSUME then the following dependencies apply: NOTRICKLE sets NOALTER at end. REGPARM"OUT" sets LITLINK at end. REGPARM"IN" sets NOFASTLINK at end. AUTOLOCK Makes the default locking AUTOMATIC rather than EXCLUSIVE for files opened I-O or EXTEND in a multi-user environment. Syntax:.
[]
Parameters:. None Default:. NOAUTOLOCK Phase:. Syntax check Environment:. All $SET:. Initial Remarks:. This directive does not appear in the SETTING list if its state is the same as WRITELOCK. In this case, the state of the two directives is indicated by the FILESHARE directive. This directive is included for compatibility with earlier file-sharing products. When writing new programs you should use the locking syntax rather than this directive. BADSIGNS Allows arithmetic with COMP-3 items with illegal sign nibbles (such as those produced by a redefinition of the item) to produce the desired result. Syntax:.
[]
Parameters:. None Default:. NOBADSIGNS Phase:. Generate Environment:. 16-bit $SET:. Initial Remarks:. Specifying BADSIGNS causes COMP-3 arithmetic to be performed by a non-optimized route, thus reducing the efficiency of your programs. For smaller, faster code you should not specify BADSIGNS. BELL Makes the bell sound at points such as when compilation stops, either because of an error or because it has finished). Syntax:.
[]
Parameters:. None Default:. NOBELL Phase:. Both Environment:. All (syntax check), 16-bit (generate) $SET:. Initial BOUND Specifies that on each table access the subscript or index value is to be checked to ensure it is within the limits defined by the OCCURS clause. Syntax:.
[]
Parameters:. None Default:. BOUND Phase:. Both Environment:. All $SET:. Initial Dependencies:. BOUND sets NOTABLESEGCROSS and NOBOUNDOPT at end BOUNDOPT Optimizes the code generated for USAGE DISPLAY subscripts. Syntax:.
[]
Parameters:. None Default:. BOUNDOPT Phase:. Generate Environment:. 16-bit $SET:. Initial (DOS, Windows and OS/2) No (UNIX) Dependencies:. Set to NOBOUNDOPT at end by BOUND or TABLESEGCROSS Remarks:. If BOUNDOPT is used, any digits in a USAGE DISPLAY subscript above the size of the table are ignored. Can only be used when NOBOUND is specified, and only affects optimized code (created with OPT"1" or above). NOBOUNDOPT must be specified if a program references beyond the end of a table. Example:. For example, for a table with 50 entries, a PIC 9(3) subscript is treated as PIC 9(2), with the most significant digit ignored. BRIEF Makes the Compiler produce only error numbers and no message texts. Syntax:.
[]
Parameters:. None Default:. NOBRIEF Phase:. Syntax check Environment:. All $SET:. Any


MPE/iX 5.0 Documentation