Tutorial: Create and Configure a Visual Studio Project

In this tutorial, you create a Visual Studio Managed COBOL project to use as you complete the remainder of these tutorials.

Requirements

Before attempting this tutorial, you must complete Tutorial: Create a SQL Server Database.

Launch Enterprise Developer for Visual Studio 2017

This procedure varies depending on your Windows version. If you need instructions, see To start Enterprise Developer.

Create a New COBOL Project

In this set of tutorials, you create a COBOL application to take advantage of the features available in the ADO.NET connection editor, and the OpenESQL Managed Runtime.

1. In Visual Studio, click File > New > Project.
2. In the New Project dialog box, expand Installed > COBOL.
3. Click the Windows Desktop category.
4. Select Console Application (.NET Framework).
5. Complete the fields as follows:

   Name	OESQLAssistantTutorial
   Location	Full path to a directory in which to store the project
   Solution Name	OESQLAssistantTutorial
   Framework	Choose the appropriate .NET Framework version from the drop-down list. Note: Must be .NET Framework 4.5 or higher.

6. Click OK.

   Visual Studio creates a new solution and a project named OESQLAssistantTutorial. The project contains one generic program, Program1.cbl, that you use in a later tutorial. If Visual Studio has automatically opened this file for editing, close it for now.

Set Project Properties

To compile this application such that it connects to the database via ADO.NET, you must set the project properties to include the DBMAN=ADO SQL compiler directive option. We must also set the BEHAVIOR compiler directive to provide optimal cursor behavior, including isolation level and lock concurrency settings.

1. From the Solution Explorer, double-click Properties under your OESQLAssistantTutorial project.
2. On the SQL tab, select OpenESQL from the ESQL Preprocessor drop-down list.
3. Click Add.
4. On the Available Directives list, click DBMAN; then click OK.
5. Repeat steps 3 and 4, but this time add the BEHAVIOR directive.
6. Back on the SQL tab, select BEHAVIOR on the Directives list.
7. From the Value drop-down list, select ANSI.
8. Click Save (); then close the Properties window.