Set Up the CWSREQ Enterprise Server Region

Guides you through the process of creating the CWSREQ enterprise server region, and configuring CWSREQ resources, and installing and verifying those resources.

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.

Create an enterprise server region

Here you use Enterprise Server to create an enterprise server region on which to run the Web service.

  1. Right-click Default []; then select New > Enterprise Server.
  2. In the Name field, type CWSREQ. This is the name for the new enterprise server region.
  3. Click the Browse button that corresponds to the Template field, and navigate to the CICSWebServicesProjectTemplate.xml file located in the ESTemplates project folder.
  4. Double-click CICSWebServicesProjectTemplate.xml. This populates the Template field.
  5. On the list next to Associate with projects, check InvokeReverse.
  6. Click Finish.

    The Server Explorer should now show the CWSREQ enterprise server region listed under Default [].

    Note: If CWSREQ is not showing, expand Default [].

Configure CWSREQ resources

As with the CWSPROV enterprise server region created in the previous tutorial, you need to add the appropriate resources to the startup list and add and configure additional resources required by the CICS program.

Start the CWSREQ enterprise server region
  • On the Server Explorer, right-click CWSREQ, 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 Common Web Administration
After CWSREQ has started:
  • From the Eclipse Server Explorer, expand Local [localhost:10086].
  • Right-click Default [] and then click Open Administration Page.

    The Region and Server List page in ESCWA is displayed in your default browser.

Access the CICS resource settings for the server
  1. After CWSREQ has started, select it from the default Directory Servers list in ESCWA.
  2. At the top of the right pane, click CICS > Resources.
Create the MYCWSREQ resource group
  1. On the RESOURCES page, expand the Groups node.
  2. Click NEW in the GROUPS pane.
  3. In the Name field, type MYCWSREQ.
  4. In the Description field, type CICS Web Services Requester Resources; then click SAVE. This invokes the MYCWSREQ page where you can create and define resources for the group.
Create resources
The InvokeReverse program requires a resource to support a pipeline, and a PCT resource used to invoke the Reverse Web service from a TN3270 terminal emulator.
Define a Pipeline resource
  1. On the MYCWSREQ page, click NEW and then click Pipeline from the drop-down list.
    Important: If the Pipeline button is not present, check to be sure that you have properly installed the CCSID tables specified in the Tutorials: CICS Web Services topic.
  2. Complete these fields:
    Name REQPIPE
    Description My CICS Requester Pipeline
    Response Wait Time Check System Default
    Config file $IDE_XML_LOC\basicsoap11provider.xml
    Web Directory $IDE_LOADLIB\
  3. Click SAVE.
  4. Click BACK to return to the MYCWSREQ page.
Define a PCT resource
  1. On the MYCWSREQ page, click NEW and then select PCT from the drop-down list.
  2. Complete these fields:
    Name INVK
    Description CWS transaction to invoke the reverse service
    Program Name INVKREV
  3. Click SAVE.
  4. Click BACK to return to the MYCWSREQ page.
Open the DEMOSTRT startup list
  1. Expand Startup Lists to see the list of CICS STARTUP LISTS.

    The CWSREQ region uses the default startup list, named DEMOSTRT.

  2. Click DEMOSTRT.

    This opens the DEMOSTRT page in the right pane.

Add resource groups to the startup list
Here, you add the DFHWEB and DFHPIPE resource groups to the startup list, and add the new MYCWSREQ resource group name to the startup list.
  1. On the DEMOSTRT page under GROUPS, click ADD.
  2. On the Available Groups list, check the DFHPIPE, DFHWEB, and MYCWSREQ groups.
  3. Click Select.

    This adds the all groups to the end of the list.

  4. Cllick APPLY.

Install and verify resources

You can install the new resources by stopping and starting the region.

  1. On the Server Explorer, right-click CWSREQ; then select Restart. This stops and then starts the CWSREQ enterprise server region, automatically installing and loading the newly added resources on the startup list.
  2. After CWSREQ is started, use the ESCWA Active resources feature to verify that the MYCWSREQ resources are installed and active, just as you did in the previous tutorial.
  3. Close ESCWA.

Start the CWSPROV Region

Because your new CICS Web service requester sends requests to the CICS Web service provider you created in the previous tutorial, start the CWSPROV region before proceeding.