Update the CWSDEMO Enterprise Server Region

Guides you through the process of configuring CWSDEMO resources, and installing and verifying those resources.

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.
Attention: You might encounter an Enterprise Server Sign On dialog box as you perform the steps required to create, configure, start, or stop an enterprise server region from the Server Explorer. If you do, ensure that the Server requires credentials, Use specific server credentials, or Server is secured box is unchecked, and then click OK. Also, if prompted to disable password recovery, click No.

Configure CWSDEMO resources

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

Start the CWSDEMO enterprise server region
  • On the Server Explorer, if the CWSDEMO enterprise server region is not already started,right-click CWSDEMO, and select Start from the context menu.
Start Enterprise Server Common Web Administration
After CWSDEMO has started:
  • On the Server Explorer, right-click Micro Focus Servers, and then click Administration.

    ESCWA starts in your default browser.

Access the CICS resource settings for the server
  1. After CWSDEMO has started, select it from the default Directory Servers list in ESCWA.
  2. In the task bar, click CICS > By Group > Resources.
Create the MYCWSREQ resource group
  1. In the Resources Navigation pane on the left, click the Groups node to view the available commands and groups.
  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 C:\tutorials\CICS\Reverse\Requester\
  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 CWSDEMO 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 CWSDEMO; then select Restart. This stops and then starts the CWSDEMO enterprise server region, automatically installing and loading the newly added resources on the startup list.
  2. After CWSDEMO 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.