Update the CWSDEMO Enterprise Server Region

Walks you through the steps required to update the CWSDEMO enterprise server region to run the loanPaym Web service.

Configure the enterprise server region

This tutorial uses the CWSDEMO enterprise server region created in Tutorial: CICS Web Service Provider from WSDL, Top-down Method to run the Web service provider.

Do one of the following:

  • If you did not complete Tutorial: CICS Web Service Provider from WSDL, Top-down Method:
    1. Open the Set Up the CWSDEMO Enterprise Server Region topic.
    2. Complete the sections titled Create the CWSDEMO enterprise server region and Configure CWSDEMO resources. However, when selecting a project with which to associate the new region, check the LoanDemo project instead of the Reverse project.
    3. From this point, proceed directly to the Verify Resources section later in this topic.
  • If you did complete Tutorial: CICS Web Service Provider from WSDL, Top-down Method, then you created and configured CWSDEMO in the process. In that case, perform the steps presented in this section before moving on to the Verify Resources section.
Update the dfhdrdat file
When you create an enterprise server region from the Server Explorer, it stores some configuration information in the project's system\dfhdrdat file. Therefore, to update the LoanDemo project with this information, you can copy the file from the Reverse project to the LoanDemo project:
  • Using Windows File Explorer or at a command prompt, copy the dfhdrdat file located in the Reverse project's system directory to the LoanDemo project's system directory, overwriting the existing file.
Start the Server Explorer
The Server Explorer expandable ribbon is visible in Visual Studio on the top left side of the IDE by default when using Enterprise Developer. However, if it is not visible:
  • In Visual Studio, click View > Server Explorer.
Associate the LoanDemo project
In previous tutorials, you have associated your project with an enterprise server region as part of the steps to create the region. Because the region you are using here was previously associated with the Reverse project, you need to change the association to the LoanDemo project.
  1. On the Server Explorer, right-click CWSDEMO; then select Associate with project.
    Note: If a check mark shows next to Reverse, click Reverse to remove the association; then repeat this step and continue with step 2.
  2. Click LoanDemo to create an association.
  3. If you are prompted to restart the server, answer No.

Verify resources

After CWSDEMO is started, you can verify that the resources you have defined are installed and active.

Start the CWSDEMOenterprise server region
  • On the Server Explorer, CWSJSON enterprise server region is not already started,right-click CWSJSON, and select Start from the context menu.
Start Enterprise Server Common Web Administration (ESCWA)
  • On the Server Explorer, right-click Micro Focus Servers, and then click Administration.

    The ESCWA UI opens in a browser outside of the Visual Studio window.

Access the CICS resource settings for the server
  1. After CWSDEMO has started, select it from the default Directory Servers list in ESCWA.
  2. At the top of the right pane, click CICS > Resources.
View defined resources
  1. From the ESCWA UI, click the CWSDEMO server in default list.
  2. From the CICS drop-down list in the right pane, select Resources.
  3. Set the first field to the right of RESOURCES to Active.
  4. On the resulting list of active resources, click WebSvc. You should see the loanPaym Web service listed and marked as INSERVICE.
  5. On the list, click Pipeline > PROVPIPE. You should see that the PROVPIPE pipeline is enabled.
  6. On the list, click URIMap > £map-ref, where map-ref is an alphanumeric string generated by Enterprise Server. You should see the path specified as /cics/services/loanPaym.

    Enterprise Server generates URIMAPs to provide CICS with the information it needs to process requests. The name of each generated URIMAP begins with a pounds-sterling symbol (£).

    To run your provider CICS Web service, you send a SOAP request to an endpoint URL that routes the request to your enterprise server region. The endpoint URL contains a URI value. The incoming request reads the installed URIMAPs to identify the map whose Path value matches the URI value of the endpoint URL. When the correct URIMAP is identified, CICS uses the data defined in the URIMAP, such as the name of the Web Service and its associated Pipeline, to process the request.

  7. Close ESCWA.