Portus Version 2018-08-24
 

Using Portus with LE

The following is a sample Portus 'Service' definition for a LE program exposed as a 'Service'

Before a Portus Service can be used, the mapping between the physical layout (the LE program's parameters) and the Portus (XML) representation must be in place. This mapping is called the Portus 'DataView'.

In addition to the manual approach described in detail in the Data Views section, there are a number of semi-automated methods aiding in the generation of Portus DataViews for LE resources

Creating a Portus DataView for a LE program

A new DataView can be generated for a LE program using the 'Service Discovery Wizard', which will not only generate the DataView (XRD), but also a XSD, plus the Portus Resource definition itself.

  1. Download the COBOL-source for the LE sample program to your local disk drive from here and compile it.
  2. Start the Discovery Wizard and select the LE_Driver as described here.
  3. Select Next >.
  4. Enter the name of the Load Library the sample has been compiled into. Click Generate
  5. Select the COBENVIR sample, click Import
  6. You will now associate the load module with the source, which will be used to generate the Portus DataView. From the Connect to column's dropdown box select Source from File System.

    Advance to the Connect with column, click it, then click the push-button appearing at the right hand corner

  7. In the File Dialog popping up, navigate to the location where the COBOL-source for the demo program COBENVIR has been downloaded to, select it

    For files with an extension of .cob the Language will automatically be set to Cobol. Click the Next button.

    Note: For COBOL sources not conforming to the standard COBOL source layout check the "Free format source" option to still have them parsed and the DataView generated correctly.
    Progress and completion of the generation process will be shown in the Status pane.
  8. The Service has been created and is now usable. Select the Service and view it's properties. If not visible then open Window -> Select View -> Properties
  9. Click the URL next to "WSDL URL is .." to display the WSDL exposed by the generated Service:

  10. Overtype the keyword WSDL with INVOKE&COBOL_ENV=&OS_ENV=&COBOL_DATE=and execute the request

    Note: Although the three fields defined in the DataView are in fact "output only" they have to be specified in the request because the Discovery process generates them as "input / output" because it simply cannot know if input is required. This can be changed with the DataView editor manually, but this is beyond the scope of this description.

Ostia
www.ostiasolutions.com
Copyright @ 2006-2018 Ostia Software Solutions Limited.