Walks you through the steps required to update the
CWSPROV
enterprise server region to run the loanPaym Web service.
Configure the
enterprise server region
This tutorial uses the
CWSPROV
enterprise server region created in
Tutorial: CICS Web Service Provider from WSDL, Top-down Method to run the Web service provider.
Do one of the following:
- If you did not complete
Tutorial: CICS Web Service Provider from WSDL, Top-down Method:
- Open the
Set Up the CWSPROV Enterprise Server Region topic.
- Complete the sections titled
Create the
CWSPROV
enterprise server region and
Configure
CWSPROV
resources. However, when selecting a project with which to associate the new region, check the
LoanDemo project instead of the
Reverse project.
- From this point, proceed directly to the
Verify Resources section later in this topic.
- If you did complete
Tutorial: CICS Web Service Provider from WSDL, Top-down Method, then you created and configured
CWSPROV in the process. In that case, perform the steps presented in this section before moving on to the
Verify Resources section.
- Update the
dfhdrdat file
- When you create an
enterprise server region from the
Server Explorer, it stores some configuration information in the project's
system\dfhdrdat file. Therefore, to update the LoanDemo project with this information, you can copy the file from the Reverse project to
the LoanDemo project:
- On the
Application Explorer view, expand the
Reverse project and locate the
system\dfhdrdat file.
- Right-click
dfhrdat; then select
Copy.
- Expand the
LoanDemo project and locate its
system\dfhdrdat file.
- Right-click
dfhrdat; then select
Paste.
- Answer
Yes to the prompt to overwrite the existing file.
- 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.
If asked to provide a password, enter your UNIX logon password.
- Associate the LoanDemo project
- In previous tutorials, you have associated your project with an
enterprise server region as part of the steps to create the region. Because the region you are using here was previously associated with the Reverse
project, you need to change the association to the LoanDemo project.
- On the
Server Explorer, right-click
CWSPROV; then select
Associate with project.
Note: If a check mark shows next to
Reverse, click
Reverse to remove the association; then repeat this step and continue with step
2.
- Click
LoanDemo to create an association.
- If you are prompted to restart the server, answer
Yes; if you are not prompted, right-click
CWSPROV and select
Start from the context menu.
Verify resources
After
CWSPROV is started, you can verify that the resources you have defined are installed and active.
- Start the
CWSPROV
enterprise server region
-
- On the
Server Explorer,
CWSPROV
enterprise server region is not already started,right-click
CWSPROV, and select
Start from the context menu.
- Start
Enterprise Server Common Web Administration (ESCWA)
-
- View defined resources
-
- From the ESCWA UI, click the
CWSPROV server in default list.
- From the
CICS drop-down list in the right pane, select
Active in the
Resources group of the menu.
- On the resulting list of active resources in the left-hand pane, click
WebSvc. You should see the
LOANPAYM 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
/cics/services/loanpaym.
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.