Tutorial 04 04 Add Traditional Bridge Routines

Tutorial 4: Adding Traditional Synergy Routines

The next step in the process is to add the traditional Synergy routines that you want to expose as enpoints via Traditional Bridge. In your actual environment, you may have existing routines in existing libraries, in which case you would add references to those libraries in the TraditionalBridge project so that the TraditionalBridgeHost program would be linked against those libraries. But for this tutorial, we will add the code for sample routines directly in the TraditionalBridge project.

Add GetEnvironment.dbl

The first routine we will add has no parameters, but is a function that returns an alpha value. The return value will be the output from the Synergy %versn function.

1. In Visual Studio Solution Explorer, right-click the Methods folder (TraditionalBridge > Source > Methods) and select Add > New Item from the context menu.

2. In the Add New Item dialog, select Code File. Then set the name of the file to GetEnvironment.dbl and click Add.

3. Copy and paste the following code into the new source file:

   ;;*****************************************************************************
   ;;
   ;; Title:       GetEnvironment.dbl
   ;;
   ;; Description: An example routine being exposed by Traditional Bridge.
   ;;              Returns the Synergy DBL version number and operating system.
   ;;
   ;;*****************************************************************************
   
   function GetEnvironment, a
   proc
       freturn %versn
   endfunction
   

4. Save the file.

Add GetLogicalName.dbl

Now let's add a second routine. This one will be a little more complicated because it has an in parameter that will be used to pass in the name of a logical. The return value of the function will be the translation of that logical name in the traditional Synergy environment.

5. Right-click the Methods folder and select Add > New Item.

6. In the Add New Item dialog, select Code File, set the name of the file to GetLogicalName.dbl, and then click Add.

7. Copy and paste the following code into the new source file:

   ;;*****************************************************************************
   ;;
   ;; Title:       GetLogicalName.dbl
   ;;
   ;; Description: An example routine being exposed by Traditional Bridge.
   ;;              Returns the translation of a logical name.
   ;;
   ;;*****************************************************************************
   
   function GetLogicalName, a
       required in aLogicalName, a
       stack record
           translation,    a1024
           length,         i4
       endrecord
   proc
       xcall getlog(aLogicalName,translation,length)
   
       if (length)
           freturn translation(1:length)
    
       freturn ""
   
   endfunction
   

8. Save the file.

Add AddTwoNumbers.dbl

Now we'll add a third routine, which will have three parameters. The first two parameters are in parameters and are used to pass numeric values. The third parameter is an out parameter. The routine adds the values of the first two parameters and stores the resulting value in the third parameter.

9. Right-click the Methods folder and select Add > New Item.

10. In the Add New Item dialog, select Code File, set the name of the file to AddTwoNumbers.dbl, and then click Add.

11. Copy and paste the following code into the new source file:

    ;;*****************************************************************************
    ;;
    ;; Title:       AddTwoNumbers.dbl
    ;;
    ;; Description: An example routine being exposed by Traditional Bridge.
    ;;              Calculates and returns the sum of two numbers.
    ;;
    ;;*****************************************************************************
    
    subroutine AddTwoNumbers
        required in  number1, n
        required in  number2, n
        required out result,  n
    proc
        result = number1 + number2
        xreturn
    endsubroutine   
    

12. Save the file.

The Methods folder should now contain three files:

Add the BridgeMethods Interface

Now that we have traditional Synergy routines, let's add the SMC definitions for that code. These definitions are in the the BridgeMethods interface in the SMC we added in Add Traditional Bridge Project.

13. Open a Windows command prompt and navigate to the directory with the .sln file for your Harmony Core solution. Then enter the following command to open the Harmony Core GUI tool:

    harmonycore gui
    

14. When the "Loading Solution" message disappears, select Interfaces to open the Interfaces screen, and then click Add interfaces in the status bar.

15. In the "Add interfaces" dialog, select BridgeMethods and then click OK. BridgeMethods will now be displayed on the Interfaces screen:

    

16. Select File > Save from the menu to save the setting you just added.

---

Next topic: Add Dispatcher Classes

---