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)
DBCSSOSI
Defines the two characters used as the shift-out and shift-in delimiters
in DBCS literals.
Syntax:.
Parameters:.
integer-1 ASCII code of the shift-out character, in decimal.
integer-2 ASCII code of the shift-in character, in decimal.
Default:.
NODBCSSOSI
Phase:.
Syntax check
Environment:.
All
$SET:.
Any
Remarks:.
When shift-out and shift-in characters are specified by this directive,
every DBCS literal must have the shift-out character immediately after
the opening quotation mark and the shift-in character immediately before
the closing quotation mark.
They act as additional delimiters to the literal, and are not part of its
value. With NODBCSSOSI, no shift-out and shift-in characters are needed
or recognized.
This feature might not be supported by your Compiler.
DBSPACE
Makes the Compiler interpret the figurative constant SPACE, when used as
a DBCS figurative constant, as the double-byte space character supplied
by the system.
Syntax:.
Parameters:.
None
Default:.
NODBSPACE
Phase:.
Syntax check
Environment:.
All
$SET:.
Any
Dependencies:.
Set to DBSPACE immediately by SAA, VSC2"2", VSC2"3" or COBOL370. DBSPACE
sets NOCONVSPACE at end.
Remarks:.
With DBSPACE, the Compiler uses the system supplied double-byte space
character. NODBSPACE provides compatibility with previous versions of
this Compiler, where the double-byte space character was two ASCII space
characters (x"2020").
This feature might not be supported by your Compiler.
DE-EDIT
Specifies the behavior of de-editing moves from numeric-edited items to
other numeric-edited items or to numeric items.
Syntax:.
Parameters:.
integer Must be 1 or 2. Indicates which compatibility
required.
Default:.
DE-EDIT"2"
Phase:.
Syntax check
Environment:.
All
$SET:.
Any
Remarks:.
The possible values of integer are:
1 Behavior as in earlier versions of this Compiler. Ignores the
PICTURE clause of the sending field.
2 De-edits according to the PICTURE clause of the sending field.
This provides ANSI'85 conformance.
Example:.
01 A pic 909V99 value "30456".
01 B pic 9(5).
...
move A to B
With DE-EDIT"1", B contains 30456. With DE-EDIT"2", B contains 00034;
the 0 after the 3 is dropped because it corresponds to the insertion
character 0 in the picture-string of A, and the .56 is dropped because B
has no decimal places.
DEFAULTBYTE
Initializes each otherwise undefined byte of the Data Division to the
character given.
Syntax:.
Parameters:.
integer ASCII code of the character, in decimal.
Default:.
DEFAULTBYTE"32"
Phase:.
Syntax check
Environment:.
All
$SET:.
Initial
Dependencies:.
Set to DEFAULTBYTE"32" immediately by CHARSET"ASCII". Set to
DEFAULTBYTE"0" immediately by CHARSET"EBCDIC", MS, IBM-MS or PC1.
DEFAULTCALLS
Specifies the default calling convention.
Syntax:.
Parameters:.
integer Default CALL convention
Default:.
NODEFAULTCALLS
Phase:.
Syntax check
Environment:.
All
$SET:.
Any
Remarks:.
DEFAULTCALLS without the optional argument specifies that the calling
convention specified in the PROCEDURE DIVISION USING statement is to be
used as the default calling convention.
DEFAULTCALLS"integer" specifies that the calling convention indicated by
"integer" is to be used as the default calling convention.
NODEFAULTCALLS is equivalent to DEFAULTCALLS"0".
Individual CALL statements can override these defaults (see your Language
Reference). See your COBOL User Guide for a list of available calling
conventions.
DEFFILE
Makes the Compiler produce a .def file, which can be used if a .dll file
is to be created from an .obj file.
Syntax:.
Parameters:.
file-name A full file specification.
Default:.
NODEFFILE
Phase:.
Generate
Environment:.
16-bit on Windows and OS/2
$SET:.
Any
Dependencies:.
If OMF"GNT", DEFFILE sets OMF"OBJ" at end
Remarks:.
This directive only affects .obj files.
The name of this file is included on the command line to the linker.
If file-name is omitted, the name of the file created is source-name.def.
where source-name is the base part of the file-name of the source file.
file-name can be specified as *.ext to set the extension to .ext but use
source-name as the root.
The file created contains the following lines:
LIBRARY INITINSTANCE
PROTMODE
DATA NONSHARED
EXPORTS entry-point @integer
where an EXPORTS line exists for each entry point in the program, with
entry-point being the name of the entry point, and integer a unique
number starting at 1.
If you also specify the directive NODLL, the line
LIBRARY INITINSTANCE
is replaced by NAME.
Example:.
DEFFILE"*.dfa"
creates a file called source-name.dfa containing the lines:
LIBRARY INITINSTANCE
PROTMODE
DATA NONSHARED
EXPORTS source-name @1
See also:.
DEFFILETYPE, DLL
DEFFILETYPE
Specifies the type of .def file to be produced (as specified by the
DEFFILE directive), according to whether a Windows or OS/2 .dll file is
required.
Syntax:.
Parameters:.
type Must be OS2 or WIN.
Default:.
DEFFILETYPE"OS2"
Phase:.
Generate
Environment:.
16-bit on Windows and OS/2
$SET:.
Initial
Remarks:.
The possible values of type are:
OS2 produces a .def file suitable for linking to create a .dll
file for use with OS/2
WIN produces a .def file suitable for linking to create a .dlw
file for use with Windows V3.0 or later.
This directive affects only .obj files.
DETECTLOCK
DETECT-LOCK
Makes READ statements detect when a record is locked by another program.
Syntax:.
Parameters:.
None
Default:.
DETECTLOCK
Phase:.
Syntax check
Environment:.
All
$SET:.
Initial
Remarks:.
With DETECTLOCK, if a READ statement reads a record locked by another
program, it returns an I/O status of 9/068. With NODETECTLOCK, it
returns 0/000. In both cases it reads the record successfully.
When DETECTLOCK is specified, individual READ statements might be made to
ignore locks by using the READ...IGNORELOCK syntax. See your Language
Reference for details of this syntax.
DG
Changes the behavior of certain features to be compatible with Data
General Interactive COBOL rev 1.30.
Syntax:.
Parameters:.
None
Default:.
NODG
Phase:.
Syntax check
Environment:.
All
$SET:.
Initial
Remarks:.
See your Language Reference - Additional Topics for details of syntax
support for Data General Interactive COBOL rev 1.30.
DIRECTIVES
Makes the Compiler read directives from a file.
Syntax:.
Parameters:.
file-name A full file specification.
Default:.
None
Phase:.
Both
Environment:.
All (syntax check), 16-bit (generate)
$SET:.
Initial
Remarks:.
Directives in the file must be separated by a space and a directive
cannot be broken across two lines. The directives are read from the file
until the end of file is reached or another DIRECTIVES directive is
encountered. The maximum length of a line is 128 characters.
You can specify more than one directives file in a program by either
specifying DIRECTIVES"file-name" within a directives file or by writing
more than one $SET statement at the beginning of your program. If you
specify the DIRECTIVES directive within a directives file, the Compiler
switches to the new directives file, reads all the directives in it,
returns to the original directives file, and continues to read the
directives specified after the DIRECTIVES directive. You can nest
directives files to any depth.
The directives file is searched for in the current and COBOL system
directories. If no extension is specified, a file extension of .dir is
added before the search is made. If no file is found, the search is
repeated with no extension.
DLL
Makes the Compiler include a LIBRARY INITINSTANCE line in the .def file
that is produced when you specify the DEFFILE directive.
Syntax:.
Parameters:.
None
Default:.
DLL
Phase:.
Generate
Environment:.
OS/2
$SET:.
Initial
Remarks:.
This directive only affects .obj files.
The inclusion of this line in the .def file means that, if the name of
the .def file is specified to the Linker, linking produces a .dll file
instead of an .exe file.
See also:.
DEFFILE
DOSVS
Specifies that words reserved in IBM DOS/VS COBOL are to be treated as
reserved words.
Syntax:.
Parameters:.
None
Default:.
NODOSVS
Phase:.
Syntax check
Environment:.
All
$SET:.
Initial
Dependencies:.
Set to NODOSVS immediately by OSVS
See also:.
OSVS
DYNAM
Specifies that CANCEL statements are not to be ignored.
Syntax:.
Parameters:.
None
Default:.
DYNAM
Phase:.
Syntax check
Environment:.
All
$SET:.
Initial
Remarks:.
With NODYNAM, CANCEL statements in the program are ignored.
EANIM
Makes the Compiler put information on line numbers and symbols into the
.obj file for use by a run-time debugger such as Microsoft CodeView.
Syntax:.
Parameters:.
integer Indicates the type of debugger support to enable.
Default:.
NOEANIM
Phase:.
Both
Environment:.
DOS, Windows and OS/2
$SET:.
Initial
Dependencies:.
If OMF"GNT", EANIM sets OMF"OBJ" at end. If OPT"0", EANIM sets OPT"1" at
end. EANIM sets ANIM immediately.
Remarks:.
This directive only affects .obj files.
integer can be one of two values:
1 Enables support for versions of Microsoft Codeview other than
V3.50, and other .exe level debuggers. COBOL data types cannot be
examined directly, but the CodeView command DB can be used to give
a memory dump of a COBOL variable.
2 Enables support for Microsoft CodeView version 3.50, such that you
can examine and modify most COBOL data types within the debugger.
Specifying EANIM is the same as specifying EANIM"2".
If you subsequently link the program using the options /CO, the debugging
information is copied into the .exe file.
EANIM causes FILLER data items to be placed in the dictionary, as is
required by a number of debuggers.
If you are compiling for CodeView, also specify the NOFORM directive.
EARLY-RELEASE
Enables support for Early User Syntax.
Syntax:.
Parameters:.
None
Default:.
NOEARLY-RELEASE
Phase:.
Syntax check
Environment:.
All
$SET:.
Initial
Remarks:.
You must specify this directive if you wish to use any of the
early-release directives or the following Early User Syntax: CALL
prototypes, OMITTED parameters and TYPEDEF phrase.
For details on this syntax see the appropriate on-disk document.
ECHO
Makes the Compiler display error lines and error messages on the screen.
Syntax:.
Parameters:.
None
Default:.
ECHO
Phase:.
Syntax check
Environment:.
All
$SET:.
Any
Dependencies:.
Set to NOECHO immediately by ECHOALL
Remarks:.
For each error, the source line is displayed together with an error
number and (unless BRIEF is set) an explanatory message.
Remarks:.
BRIEF
ECHOALL
Sends a full listing to the screen as well as to a printer or other
device specified with the LIST or PRINT directive.
Syntax:.
Parameters:.
None
Default:.
NOECHOALL
Phase:.
Syntax check
Environment:.
All
$SET:.
No
Dependencies:.
ECHOALL sets NOECHO immediately
EDITOR
Makes the Compiler send error messages to a file in a format compatible
with a specified editor.
Syntax:.
Parameters:.
editor-id Must be MF or MS.
Default:.
NOEDITOR
Phase:.
Both
Environment:.
All (syntax check), 16-bit (generate)
$SET:.
No
Dependencies:.
EDITOR " " and EDITOR"MS" set NOENSUITE immediately. EDITOR"MF" sets
ENSUITE"1" immediately.
Remarks:.
The possible values of editor-id are:
MF Micro Focus Editor
MS Microsoft Programmer's Workbench
You are recommended to use the NOECHO and NOQUERY directives in addition
to the EDITOR directive.
See also:.
ECHO, FLAGSINEDIT, QUERY
ERRLIST
Specifies that the listing is to contain no source lines except those
that have errors or flags.
Syntax:.
Parameters:.
None
Default:.
NOERRLIST
Phase:.
Syntax check
Environment:.
All
$SET:.
No
MPE/iX 5.0 Documentation