The properties you specify on the
COBOL page in your project properties apply to the selected configuration. If different from the project's properties, the properties set on file level take precedence over those set for the project.
General
- Managed code
- Specify whether the code is managed, native or verifiable.
- Platform target
- The target platform, such as x86, x64 or Any CPU. Any CPU is available for managed code projects only. Valid values are given in the drop-down list.
For .NET managed projects, this is equivalent to the ILTARGET Compiler directive.
Tip: Avoid building your managed projects for Any CPU if they include ActiveX references. Instead, set the particular target platform to either x86 or x64 to match the targeting of the ActiveX control.
- Additional copybook paths
- The paths to search for copybook files that apply only to the selected build configuration of the current project. This enables you, for example, to have different copybook paths for debug and release builds. Use semicolon as a delimiter when entering multiple copybook paths.
This option sets the COBCPY environment variable, which is appended with the COBCPY setting in the Registry.
You can specify general copybook paths that apply to the project regardless of the active build configuration on the Copybook Paths page of your project properties. The configuration-specific copybook paths take precedence over the project copybook paths.
- Generate debugging information
- Value of true or false, to determine whether or not to generate debugging information.
- Build Events
- The commands to be executed before or after the build and when to execute them. See the Visual Studio Help for details.
- Generate 64-bit pointers
- This setting is available for managed projects only. Compiles the project with 64-bit pointer support enabled. Equivalent to the P64 Compiler directive.
- Source Format
- The default source format for source files. This is one of Fixed, Variable, or Free. Equivalent to the SOURCEFORMAT Compiler directive, but can be overridden (and often is) by using a $set statement in the source code.
Native
The following properties are specific for the native COBOL projects:
- COBOL dialect
- Specify the COBOL dialect used by your code. This sets the DIALECT Compiler directive for the project accordingly.
- EXEC CICS
- Check this to specify CICS options for your project.
Click
Options to set CICSECM options as follows:
- Unsupported function handling
- Choose the behavior if the source code contains an unsupported CICS function. This applies only to functions that are recognized (but unsupported) by the CICS preprocessor.
- Compiler error
- The default is that the CICS preprocessor treats unsupported CICS functions as Compiler errors.
- Treat as comment
- Any unsupported functions are treated as comments (that is, ignored).
- Abend at runtime
- Any unsupported functions result in an abend at run time.
- Unsupported option handling
- Choose the behavior if the source code contains an unsupported option. This applies only to options that are recognized (but unsupported) by the CICS preprocessor.
- Compiler error - the default is that the CICS preprocessor treats unsupported CICS options as Compiler errors
- Treat as comment - any unsupported options are treated as comments (that is, ignored by the preprocessor)
- Abend at runtime - any unsupported options result in an abend at run time
- Ignore at runtime - any unsupported options are ignored at run time
- Additional CICSECM options
- Specify additional CICS directives for your project as required. The syntax is as follows: CICSECM (option=setting). For example,
CICSECM(EXCI=YES).
- Link Settings
- Specify different linking options such as the type of the Runtime Library and the thread model, or link to any subprograms needed by your application. See
Link Settings for more.
- EXEC DLI
- Check this if your programs contain EXEC DLI statements.
Click
Options to set EXEC DLI options as follows:
- DIB Group name
- Specify the name of the DL/I Interface Block (DIB) group placed in your application program by the preprocessor at 01 level, or accept the default value, DLZDIB.
- DIBVER value
- Specify the version of the DL/I Interface Block (DIB) group placed in your application program by the preprocessor at 01 level or accept the default value. This field is provided for compatibility with IMS/ESA.
- Additional directives
- Specify any additional IMS preprocessor directives.
Errors and Warnings
The Errors and Warnings fields enable you to choose what warnings and errors will be displayed when you build the specified configuration.
- Warning level
- Specifies the severity of errors or the warning messages that are displayed in the output console.
- Stop after
- Specifies the maximum number of errors or the warning messages that will be displayed during the build.
- Treat warnings as errors
- Stops the build when a warning is received.
- Raise ECM error level to Severe (Level S)
- Changes all ECM warnings and errors to Severe errors and fails the build.
Additional Directives
This field enables you to specify additional COBOL Compiler directives to pass to the Compiler.
Output
- Output path
- The directory to contain the built output files. Equivalent to the ILOUTPUT Compiler directive.
- XML documentation file
- Generates documentation in XML format that includes the comments you have made in the source code about the used methods and classes. Equivalent to the ILDOC Compiler directive.
- Register for COM interop
- Value of true or false, to determine whether or not to register the build output as a COM component, which allows non-.NET code to use the project as if it was a COM object.
- Generate directives file
- Generates a file containing the directives that are used to compile the project. The file is named
project name.dir and is placed in the project directory.
