Set Up the CWSPROV Enterprise Server Region, WSDL

Create the CWSPROV enterprise server region

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

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.

Attention: You might encounter an ESCWA Sign On dialog box as you perform the steps required to create, configure, start, or stop an enterprise server instance from the Server Explorer. If you do, ensure that the Server requires credentials, Use specific server credentials, or Server is secured , and the Store credentials boxes are unchecked, and then click OK. If asked to provide a password, enter your UNIX logon password.

Create CWSPROV

1. Expand Local [localhost:10086], right-click Default [127.0.0.1:86]; then select New > Enterprise Server.
2. In the Name field, type CWSPROV . 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 CICSWebServicesTemplate.xml file located in the ESTemplates project folder.
4. Double-click CICSWebServicesTemplate.xml. This populates the Template field.
5. On the list next to Associate with projects, check Reverse.
6. Click Finish.

   The Server Explorer should now show the CWSPROV enterprise server region listed under Local [localhost:10086] > Default [127.0.0.1:86].

   Note: If CWSPROV is not showing, expand Local [localhost:10086] > Default [127.0.0.1:86].

Set general properties in ESCWA

Start Enterprise Server Common Web Administration

• 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.

Set environment variables

1. In ESCWA, click Native.
2. In the navigation pane, click Directory Servers > Default > CWSREQ.

   This opens the General Properties page for the CWSREQ server where you can set environment variables.

3. In the Configuration Information field, type:

   [ES-Environment]
   IDE_PROJECT_LOC=C:\Users\username\workspace\Reverse
   IDE_LOADLIB=$IDE_PROJECT_LOC\loadlib

4. To save the changes, click Apply.

Configure CWSPROV resources

All enterprise server regions require access to certain resources, depending on the types of applications they run. Resources that are defined on a region's startup list are loaded during the startup routine, making them available for as long as the region is running.

CICS Web services use the underlying resources provided by the standard Enterprise Server CICS Web interface (CWI) and CICS Web Services (CWS) support. However, the CICSWebServicesTemplate used to create the CWS-PWTD region does not include these resources on the startup list; therefore, you need to add them manually. The CWI resources reside in a predefined resource group named DFHWEB. The CWS resources are in the predefined DFHPIPE group.

In addition, you need to create and define a resource group, MYCWSPRV, to contain the resources required by the Reverse program.

Start CWSPROV

• On the Server Explorer, right-click CWSPROV ; then select Start.

  As the region is starting, check the ESCWA UI. When the region is fully started, this is indicated in the region's Status column.

Access the CICS resources for the server

1. After CWSPROV has started, in ESCWA, click Edit for the CWSPROV region.
2. In the taskbar, click the CICS drop-down list, and then select Resources.

Create the MYCWSPRV resource group

1. On the Resources page, click the Groups node in the left pane.
2. Click New in the Groups pane.
3. In the Name field, type MYCWSPRV.
4. In the Description field, type CICS Web Services Provider Resources; then click Save. This invokes the MYCWSPRV page where you can create and define resources for the group.

Define MYCWSPRV resources

The Reverse program requires a resource for TCP/IP service, and a resource to support a pipeline.

1. On the MYCWSPRV page, click New and then click TCPIPSv from the drop-down list.
2. Complete these fields:

   Name	CWSTCPIP
   Description	My TCP/IP Service
   Port No	5482

3. Click Save.
4. Click MYCWSPRV under Group list to return to the MYCWSPRV page.
5. On the MYCWSPRV 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.
6. Complete these fields:

   Name	PROVPIPE
   Description	My CICS Provider Pipeline
   Response Wait Time	Check System Default	This is the number of seconds that an application waits for a response from the service. The default value is 10 seconds for HTTP and 60 seconds for MQ.
   Config file	$IDE_XML_LOC/basicsoap11provider.xml	The IDE_XML_LOC environment variable in CWS-PWTD points to the xml project folder.1
   Web Directory	$IDE_LOADLIB/	The IDE_LOADLIB environment variable points to the loadlib project folder.2
   1To see a list of environment variables defined for CWSPROV , from the list of Directory Servers, click the (EDIT) button that corresponds to the CWSPROV region. Click the downward arrow next to MONITOR at the top of the page, then click Environment Variables. 2The IDE_LOADLIB environment variable is set automatically when you start the enterprise server region from Server Explorer inside the IDE.

7. Click Save.

Open the DEMOSTRT startup list

1. Click the arrow next to CICS in the taskbar at the top of the properties pane, then click Resources.

   The default way to sort the list of resources is By Group.

2. Click the Startup Lists group. This invokes a list of CICS Startup Lists in the right pane.

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

3. Click the (Edit) button that corresponds to DEMOSTRT. This takes you to the DEMOSTRT page.

Add resource groups

Here, you add the DFHWEB, DFHPIPE, and the new MYCWSPRV resource groups to the startup list,

1. On the DEMOSTRT page, click Add.
2. Check DFHWEB, DFHPIPE, and MYCWSPRV; then click Select.

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

3. Click Apply.

Install and verify resources

After CWSPROV is started, you can verify that the resources you have defined are installed and active.

1. Go back to the list of Directory Servers.

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

2. From the Server Explorer in the IDE, right-click CWSPROV ; then select Restart. This stops and then starts the CWSPROV enterprise server region, automatically installing and loading the newly added resources on the startup list.
3. From the ESCWA UI, click the CWSPROV server in the left pane.
4. Click downward arrow next to CICS in the taskbar at the top of the properties pane, then click Resources.
5. Set the first field right next to Resources to Active.
6. On the resulting list of active resources, click WebSvc. You should see the Reverse Web service listed and marked as Inservice.
7. On the list, click Pipeline > PROVPIPE. You should see that the PROVPIPE pipeline is enabled.
8. On the list, click URIMap > £map-ref, where map-ref is an alphanumeric string generated by Enterprise Server. You should see the path specified as /cwsDemo/reverseMe.

   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.

9. Close ESCWA.