You use the
COBOL Link page in your project properties to link your native project to a run-time system and specify link parameters.
Note: The following settings apply to native projects only.
- Output name
- Specify a name for the output application file which can be different for the different configurations.
Note: This setting is disabled for native Link Library projects building to Multiple Libraries as each COBOL program in the project
compiles to a .dll file with the same filename.
- Entry point
- Specify a name for the output application file which can be different for the different configurations.
Note: This setting is disabled for native Link Library projects as .dlls do not have a main entry point.
Run-time Model
- Shared
- Select this option to link the application to the shared run-time system. The run-time system is not linked into your executable
files, but is loaded dynamically when your application is run. The run-time files must be located in the same directory as
the application, or on the system PATH.
Select this option if you are building a modular application, or a DLL that will be called by a COBOL program.
- Dynamic
- Select this option to bind the application to a run-time system dynamically at run time. The COBOL run-time system files are
located on the end-user's machine according to:
- A run-time option in an application launch configuration file (<app-name>.exe.mfcfg).
- If the option doesn't exist, a run-time option in a default application launch configuration file (mfdefault.exe.mfcfg).
- If a default run-time option doesn't exist, settings specified during
COBOL Server installation.
- If no installation was run, the run-time binary files must be located in the same directory as the application, or on the
system PATH.
- Bind to current RTS only
- Select this option to dynamically bind the application to a run-time system of the same version (or later) as your COBOL development
system.
Application type
- Console based
- Select this if your application is console based.
- Graphical
- Select this if your application uses a graphical user interface.
- Link with objs
- Type the names of any
.obj files you want to link with this system executable file. Alternatively, you can add them to the Project tree view, under
the
.exe file.
- Link with libs
- Type the names of any library (.lib) files you want to link with this system executable file. Alternatively, you can add them to the Project tree view, under
the
.exe file.
- Include system programs
- Select this option if you want any run-time system support modules required by your application to be automatically linked
with it. Run-time support modules provide support for the following:
- User-defined classes in SPECIAL NAMES paragraphs
- EXTERNAL files and data
- Enhanced ACCEPT and DISPLAY syntax
If you don't select this, you need to link any required support modules by adding them to your project.
If your application needs run-time support other than that listed above, it is loaded dynamically at run time.
- Keep temporary files
- Select this option if you don't want temporary files that were created when linking, to be deleted. Temporary files include
import libraries, definition (.def) files, and
.lnk files.
- Generate map file
- Select this option to create a
.map file when your application is rebuilt. The Linker map file contains information such as a timestamp, a preferred loading
address, a list of public entry points used in the linked object files, and a fixup (load offset) table.
- Display verbose output
- Select this option if you want all notes and messages from the Linker to be displayed in the
Output window. Messages that use the LNK prefix are from the Linker, and are explained in more detail in the
Microsoft Win32 Software Development Kit.
- Additional directives
- Type any additional parameters you want to pass to the
Cbllink utility.