Set Up the CWSREQ Enterprise Server Region

Start the Server Explorer

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 Local [localhost:86]; 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 Local [localhost:86].

   Note: If CWSREQ is not showing, expand Local [localhost:86].

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 Administration

After CWSREQ has started:

• 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 CWSREQ region.
2. On the Server > Control page, click ES Monitor & Control.

Add resource groups

Here, you add the DFHWEB and DFHPIPE resource groups to the startup list, and add the MYCWSREQ resource group name to the startup list. At this point, you have neither created nor defined the MYCWSREQ group and its respective resources. Those tasks are completed in the next few sections of this tutorial.

1. On the ESMAC menu ribbon, click the Resources drop-down list; then select by Group.
2. Click Startup.
3. Click the Details button that corresponds to the DEMOSTRT startup list.
4. On the CICS STARTUP - DEMOSTRT page, scroll down to the end of the list and type DFHWEB into the empty field at the bottom; then click Apply. ESMAC adds the DFHWEB group, and adds another empty field at the end of the list.
5. In the new empty field, type DFHPIPE; then click Apply.
6. In the new empty field, type MYCWSREQ; then click Apply.

   Now you can create the MYCWSREQ resource group.

Create the MYCWSREQ resource group

1. On the ESMAC menu, click the Groups button located under Resources.
2. On the CICS Resource Groups page, click New.
3. In the Name field, type MYCWSREQ.
4. In the Description field, type CICS Web Services Requester Resources, and then click Add.

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.

1. On the CICS Group MYCWSREQ page, click Pipeline.
2. Complete these fields:

   Name	REQPIPE
   Description	My CICS Requester Pipeline
   Resp Wait	DEFT
   Config file	$IDE_XML_LOC\basicsoap11requester.xml
   WebSvc Dir	$IDE_LOADLIB\

3. Click Add and then Apply.
4. Click Group List to return to the CICS Group MYCWSREQ page.
5. Click PCT.
6. Complete these fields:

   Name	INVK
   Description	CWS transaction to invoke the reverse service
   Program Name	INVKREV

7. Click Add; then click Apply.
8. To return to the Administration Home page, click Home at the top of the ESMAC menu.

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 ESMAC Active feature to verify that the MYCWSREQ resources are installed and active, just as you did in the previous tutorial.
3. Close Enterprise Server Administration.

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.