Guides you through the process of creating and configuring an
enterprise server region named
CWSPROV
. In addition, walks you through the process of verifying that the region contains the resources required to run the Reverse
Web service provider.
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
, 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.
Also, if prompted to disable password recovery, click
No.
- Create
CWSPROV
-
- Expand
Local [localhost:10086], right-click
Default [127.0.0.1:86]; then select
New > Enterprise Server.
- In the
Name field, type
CWSPROV
. This is the name for the new
enterprise server region.
- Click the
Browse button that corresponds to the
Template field, and navigate to the
CICSWebServicesTemplate.xml file located in the
ESTemplates project folder.
- Double-click
CICSWebServicesTemplate.xml. This populates the
Template field.
- On the list next to
Associate with projects, check
Reverse.
- 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
-
- Set environment variables
-
- In
ESCWA, click
Native.
- In the navigation pane, click
.
This opens the
General Properties page for the
CWSREQ server where you can set environment variables.
- In the
Configuration Information field,
type:
[ES-Environment]
IDE_PROJECT_LOC=C:\Users\username\workspace\Reverse
IDE_LOADLIB=$IDE_PROJECT_LOC\loadlib
- 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
-
- Access the CICS resources for the server
-
- After
CWSPROV
has started, in ESCWA, click
Edit for the
CWSPROV
region.
- In the taskbar, click the
CICS drop-down list, and then select
By Group in the
Resources section of the menu.
- Create the MYCWSPRV resource group
-
- See the
Resources Navigation pane on the left.
- Click the
Groups node to view the available commands and groups.
- Click
New in the
Groups pane.
- In the
Name field, type
MYCWSPRV.
- 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.
- On the
MYCWSPRV page, click
New and then click
TCPIPSv from the drop-down list.
- Complete these fields:
Name
|
CWSTCPIP
|
Description
|
My TCP/IP Service
|
Port No
|
5482
|
- Click
Save.
- Click
MYCWSPRV under
Group list to return to the
MYCWSPRV page.
- 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.
- 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
|
c:\tutorials\CICS\Reverse\Provider\
|
|
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.
|
- Click
Save.
- Open the DEMOSTRT startup list
-
- Click the arrow next to
CICS in the taskbar at the top of the properties pane, then click
By Group under the
Resources category.
- Click the
Startup Lists group in the left hand pane. This invokes a list of CICS
Startup Lists in the right pane.
The
CWSPROV
region uses the default startup list, named DEMOSTRT.
- 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:
- On the
DEMOSTRT page, click
Add.
- Check
DFHWEB,
DFHPIPE, and
MYCWSPRV; then click
Select.
This adds all of these groups to the end of the list.
- Click
Apply.
Install and verify resources
After
CWSPROV
is started, you can verify that the resources you have defined are installed and active.
- Go back to the list of Directory Servers.
You can install the new resources by stopping and starting the region.
- 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.
- From the ESCWA UI, click the
CWSPROV
server in the left pane.
- Click downward arrow next to
CICS in the taskbar at the top of the properties pane, then click
Active in the
Resources category.
- On the resulting list of active resources, click
WebSvc in the left-hand pane. You should see the
reverse Web service listed and marked as
Inservice.
- On the list, click
Pipeline > PROVPIPE. You should see that the PROVPIPE pipeline is enabled.
- 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.
- Close ESCWA.