Tutorial: Call a SQL CLR Stored Procedure Single-project by Literal

This tutorial walks you through the process of invoking a native COBOL program using JCL, and calling programs and stored procedures in a single assembly using literals.

Requirements

In addition to the requirements listed on the Prerequisites topic, you must also complete the Configure an Enterprise Server Region tutorial, configuring the JCLSPSL enterprise server region.

Start Enterprise Developer as an Administrator

Because you need to make changes to files in your SQL Server installation area, which requires administrator privileges, you must start Enterprise Developer as an administrator. See To start Enterprise Developer as an administrator for details.

Open the SQLCLRTutorialSPCall Solution

  1. In Enterprise Developer, click File > Open > Project/Solution.
  2. Browse to the %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\SQL\OpenESQL\JCLCallingSP\SingleProjLiteral directory.
  3. Double-click SQLCLRTutorialSPCall.sln.

Set Project Properties

  1. In the Solution Explorer, right-click the SPCall project; then select Properties from the context menu.
  2. On the Debug tab (located on the left sidebar), using the drop-down list, set Active Settings to JCL.
  3. Click Save (Save).

Build the Solution

  • In the Solution Explorer, right-click the solution; then select Build Solution from the context menu.

Publish SQL CLR Stored Procedures

  1. In the Solution Explorer, right-click the SQLCLRTutorial.Publish project; then select Properties from the context menu.
  2. On the Project Settings tab (located on the left sidebar), use the Target platform drop-down list to select the version of SQL Server used on your deployment machine. In this case, this is the version of SQL Server installed on your local machine.
  3. Click Save (Save).
  4. In the Solution Explorer, right-click the SQLCLRTutorial.Publish project; then select Publish from the context menu.
  5. On the Publish Database dialog box, click Edit.
  6. In the Server name field, type . (dot) to represent your local server.
  7. In the Select or enter database name field, select SQLCLR_Test from the drop-down list; then click OK.
  8. On the Publish Database dialog box, click Publish.

    When the publishing process is complete, the Data Tools Operations window shows a status of "Publish Completed Successfully."

Associate the JCLSPSL Region with the SPCall Project

  1. In Server Explorer, expand Micro Focus Servers > localhost.
  2. Right-click JCLSPSL; then select Associate With Project > SPCall from the context menu.

Start the JCLSPSL Region

  1. On the Server Explorer list, right-click JCLSPSL; then select Start from the context menu.
  2. If you are using SQL Server authentication, check Server is secured; then provide your Username and Password.

    If you are using Windows authentication, skip this step.

  3. Click OK.

Configure SQL Server Debug Properties

  1. In Enterprise Developer, click View > SQL Server Object Explorer.
  2. Expand SQL Server.
  3. In the list of SQL Server instances, expand your SQL Server instance.
    Note: If your SQL Server instance is not listed:
    1. On the SQL Server Object Explorer, right-click SQL Server; then select Add SQL Server from the context menu.
    2. On the Connect to Server dialog box, type . (dot) into the Server name field; then click Connect.
    3. Repeat this step.
  4. Expand Databases; then check the resulting list to ensure that SQLCLR_Test is listed.
  5. Right-click your SQL Server instance; then select Application Debugging to turn it on. When Application Debugging is on, a check mark (Check Mark) appears to its left.
  6. Right-click your SQL Server instance again; then select Allow SQL/CLR Debugging to turn it on.
  7. If prompted, click Yes.

Debug the Program and Stored Procedure

In this section, you use Enterprise Developer to debug the native COBOL program and the SQL CLR stored procedure.

  1. In the Solution Explorer, double-click SPCall.cbl to open in the COBOL editor.
  2. In the COBOL Editor, scroll to:
    exec sql
         call "SP1" (:countval INOUT)
    end-exec
  3. In the leftmost column on the exec sql line, click to set a breakpoint.
  4. From the Solution Explorer, open SP1.cbl.
  5. Scroll to:
    call "A" using by reference lscountval
    and set a breakpoint.
  6. Click DEBUG > Start Debugging. This builds the project and puts the debugger in a wait state.
  7. In Solution Explorer, right-click the SPCall.jcl file; then select Submit JCL from the context menu.

    The JCL script calls the SPCall program and stops on the breakpoint you set in the SPCall.cbl file.

  8. Click DEBUG > Attach to Process.
  9. On the Attach to Process dialog box, click Select.
  10. On the Select Code Type dialog box, click Debug these code types; then check the following boxes:
    • Managed (v4.5, v4.0)
    • T-SQL
  11. Click OK.
  12. On the Attach to Process dialog box, check Show processes from all users.
  13. On the Available Processes list, select the sqlservr.exe entry that has the NT Service\MSSQLServer User Name.
  14. Click Attach.
    Note: If a prompt appears, click Attach to clear it.
  15. Click DEBUG > Step Into.

    The debugger steps into the managed SQL CLR stored procedure code. This demonstrates debugging in a mixed native/managed environment.

  16. To continue debugging, press F10; when the debugger reaches another breakpoint, press F10 again.
  17. Press F5 to run the program to its completion.
  18. Click Stop Debugging Stop Debugging to stop the Debugger.

View JCL Execution Results

  1. In the Enterprise Developer Output window, select Enterprise Server from the Show output from drop-down list.
  2. CTRL-click the job output link.

    This opens the JCLSPSL tab, showing the Enterprise Server Job Output window.

  3. Click SYSOUT.

    This shows the output from the SQL CLR Stored Procedure.

  4. Close the JCLSPSL tab.

Stop the JCLSPSL Enterprise Server Region

  • On the Server Explorer, right-click JCLSPSL; then select Stop from the context menu.