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 Default [127.0.0.1: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 Default [127.0.0.1:86].

   Note: If CWSREQ is not showing, expand Default [127.0.0.1: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 Common Web Administration

After CWSREQ has started:

• From the Eclipse Server Explorer, right-click the Local [localhost:10086] node, and then select Open Administration Page from the context menu.

  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\basicsoap11requester.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

Ensure you have the DFHWEB and DFHPIPE resource groups in 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, ensure that the resource groups DFHPIPE, DFHWEB are checked, and check MYCWSREQ.
3. Click Select.

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

4. Click 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.