Accessing ROC from VB.NET Winforms

To access the ROC application from VB.NET Winforms, perform the following:

  1. Build an AB Suite application (for example, Sample) with the System uses ROC property set to TRUE in the segment Property Pages window and the User Defined View Generator property set to VB.NET Client in the bundle folder Property Pages window.

  2. Rename the samplemcpIspecName.xml file present in the following location:

    <CE Download directory>\<Package prefix>\<AB Suite application name>\<bundle folder name>\views

    For example, you can rename the samplemcpIspecName.xml file to samplemcpIspecName _sample.xml

  3. Import the MCP ROC model into AB Suite Developer. This can be the default model, which is released with the AB Suite product, or a customized version of it. The location of the default model is

    <drive>:\Program Files (x86)\Unisys\AB Suite x.x\Bin\ROCMCP.model

  4. Generate a bundle of the folder that contains the Ispecs of the ROC application.

    Notes:

    • Ensure that the name of the bundle folder is same as the name of the bundle folder created for the AB Suite application. For example, VBclient can be the name of the bundle folder in both ROC system and AB Suite system.

    • Set all the properties required to build an application to generate a bundle folder.

    • Ensure that the segment properties are same as the properties of the AB Suite application.

      For example:

      Application Name: Sample

      Package Prefix: com.unisys

      CE Output Directory: C:\NGEN_CE\classes

  5. Navigate to the following location and delete the samplemcpIspecName.xml file created for the ROC application:

    <CE Download directory>\<Package prefix>\<AB Suite application name>\<bundle folder name>\views

  6. Rename the samplemcpIspecName_sample.xml file to samplemcpIspecName.xml.

  7. Open the samplemcpIspecName.xml file and uncomment the lines corresponding to the ROC Ispecs.

    For example:

    <Ispec_List> 
		<IspecName>ROCI</IspecName>
		<TeachName></TeachName>
		<IspecDescription>ROC-I Dummy Switch To Roc</IspecDescription> 
		<LocaleNumber>1</LocaleNumber>
</Ispec_List> 
<Ispec_List>
		<IspecName>ROC-A</IspecName>
		<TeachName></TeachName>
		<IspecDescription>ROC-A Roc Ispec</IspecDescription> 
		<LocaleNumber>1</LocaleNumber>
		</Ispec_List>

  8. Log onto the MCP host and create a RATL view for the AB Suite application; for example, Sample.

  9. Double-click the SetupVBNETClient.vbs file present in the following location: <CE Installed directory>\VB.NET Client\Utilities\Setup

  10. Click OK.

    The VB.NET Client Application Setup Script dialog box appears and prompts you to specify the AB Suite application name.

  11. Specify the AB Suite application name, and click OK.

  12. Click Yes to confirm the creation of a directory with the AB Suite application name.

    The VB.NET Client Application Setup Script dialog box appears confirming the initialization of the VB.NET Application directories.

  13. Click OK.

    A directory is created in the following location with the AB Suite application name: <CE Installed directory>\VB.NET Client

  14. Navigate to the location where the directory is created and open <AB Suite application name>.vbproj file with administrator privilege.

    The Microsoft Visual Studio environment opens and displays the AB Suite application name in the Class View window. You can also view the list of errors in the Error List window.

  15. Switch to the Solution Explorer window, right-click the AB Suite application name and select Properties.

    The Properties window appears.

  16. Select the References tab and click Add References.

    The Reference Manager dialog box appears.

  17. Click Browse next to the Folder field to specify the path for the each of following dlls present in the bin folder of the Component Enabler installation directory.

    • CEdotNET.dll

    • CEWindowsAPI.dll

    • CEWinFormRenderer.dll

    • NGLincInterface.dll

  18. Click OK.

    The path for the dlls appears in the Reference Paths field. This resolves all the errors listed in the Error List window.

  19. Right-click the solution node in the Solution Explorer window, and select Build Solution.

    The Save File As dialog box appears displaying the <AB Suite application name>.sln file in the Object name field.

  20. Click Save to save the solution.

  21. Navigate to the following location and double-click the <AB Suite application name>.sln file:

    <CE Download directory>\<Package prefix>\<AB Suite application name>\<bundle folder name>\views

    The Microsoft Visual Studio environment opens displaying the Ispecs present in the AB Suite application.

  22. Switch to the Solution Explorer window, right-click the solution node and select Build Solution.

    The Ispecs in the AB Suite application are built.

  23. Navigate to the following location and configure the config.xml file present in the bin folder of AB Suite application:

    <CE Installed directory>\VB.NET Client\<AB Suite application name>\bin

  24. Open the <AB Suite application name>.exe file with administrator privilege. The AB Suite application displays the Select Form window.

  25. Select the ROC Ispec that you want to display.

    Note: If you specify an Ispec as the Fireup Ispec in the Segment properties, the application displays the same Ispec instead of the Select Form window. You must go to System > Select Form and select the ROC Ispec that you want to display.