Update the CWSPROV Enterprise Server Region

Configure the enterprise server region

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 CWSPROV Enterprise Server Region topic.
  2. Complete the sections titled Create the CWSPROV enterprise server region and Configure CWSPROV 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 CWSPROV 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:

1. On the Application Explorer view, expand the Reverse project and locate the system\dfhdrdat file.
2. Right-click dfhrdat; then select Copy.
3. Expand the LoanDemo project and locate its system\dfhdrdat file.
4. Right-click dfhrdat; then select Paste.
5. Answer Yes to the prompt to overwrite the existing file.

Start the Server Explorer

The Server Explorer view is visible by default when using the Team Developer perspective, and appears as a tab on the same level as the Application Explorer view. However, if it is not visible:

• In Eclipse, click Window > Show View > Other > Micro Focus > Server Explorer, and then click Open.

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 CWSPROV; 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

Start the CWSPROVenterprise server region

• On the Server Explorer, right-click CWSPROV, and select Start from the context menu.
  Note: If an Enterprise Server Sign On prompt appears, click OK. The new enterprise server region does not use specific server credentials.

Start Enterprise Server Administration

• From the Eclipse Server Explorer, right-click Local [localhost:86] and then click Open Administration Page.

  The Enterprise Server Administration Home page starts in an Eclipse window.

Start ES Monitor and Control (ESMAC)

1. On the Enterprise Server Administration Home page, click the Details button located in the Status column for the CWSPROV region.
2. On the Server > Control page, click ES Monitor & Control. This starts the ESMAC utility where you can view the defined resources.

View defined resources

1. On the ESMAC menu, select Active from the drop-down list located under Resources.
2. Click the WebSvc button. You should see the LOANPAYM Web service listed and marked as INSERVICE.
3. Click the Details button that corresponds to the LOANPAYM Web service.

   Notice the value for WSBIND. This value is determined by the information stored in your project.

4. On the ESMAC menu, click Pipeline; then click the Details button that corresponds to PROVPIPE. The Pipeline resource sets the response wait period, identifies the SOAP configuration file, and the Web Service directory.
5. On the ESMAC menu, click URIMAP; then click the Details button that corresponds to PIPELINE and /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.

6. Close Enterprise Server Administration.