Guides you through the process of creating the JSONREQ
enterprise server region, and configuring
JSONREQ resources, and installing and verifying those resources.
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.
Create an
enterprise server region
Here you use the
Server Explorer to create an
enterprise server region on which to run the requester Web service.
- On the
Server Explorer, expand
Local [localhost:10086] > Default [127.0.0.1:86]
- Right-click
Default [127.0.0.1:86]; then select
New > Enterprise Server.
- In the
Name field, type
JSONREQ.
- Click the
Browse button that corresponds to the
Template field, and navigate to the
CICSWebServicesTemplate.xml file located in the
InvokeReverseJSON project folder.
- Double-click
CICSWebServicesTemplate.xml.
- On the list next to
Associate with projects, check
InvokeReverseJSON.
- Click
Finish.
The
Server Explorer should now show the
JSONREQ
enterprise server region listed under
Local [localhost:10086] > Default [127.0.0.1:86].
Configure JSONREQ resources
- Start the JSONREQ
enterprise server region
-
- On the
Server Explorer, right-click
JSONREQ; then select
Start.
Note: If this is the first time you have started the server, you see a sign-on dialog box. If
Server is secured is checked, uncheck it; then click
OK. Unchecking
Server is secured prevents this dialog box from showing when you subsequently start the region. If
Server is secured is not checked, simply click
OK to clear the dialog box. Also,
if prompted to disable password recovery, click
No. If a
Secure Storage prompt appears, click
No.
- Start
Enterprise Server Common Web Administration (ESCWA)
-
- Access the CICS resource settings for the server
-
- After
JSONREQ has started, select it from the default
Directory Servers list in ESCWA.
- At the top of the right pane, click
CICS > Resources.
- Create the JSONREQ resource group
-
- On the
RESOURCES page, expand the
Groups node.
- Click
NEW in the
GROUPS pane.
- In the
Name field, type
JSONREQ.
- In the
Description field, type
CICS Web Services JSON Requester Resources; then click
SAVE. This invokes the
JSONREQ page where you can create and define resources for the group.
- Create resources
- The
invkRevJ program requires a URIMap resource, a pair of Bundle resources, and a PCT resource used to invoke the Reverse Web service
from the Rumba+ TN3270 terminal emulator.
- Define a URIMap resource
-
- On the
JSONREQ page, click
NEW and then click
URIMap 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
|
REVRSURI
|
Description
|
URIMAP for JSON reverseJ request
|
Usage
|
Client
|
Port
|
5482
|
Host
|
localhost
|
Path
|
/cics/services/json/reverse
|
- Click
SAVE.
- Click
BACK to return to the
JSONREQ page.
- Define Bundle resources
-
- On the
JSONREQ page, click
NEW and then select
Bundle from the drop-down list.
- Complete these fields:
Name
|
REQBNDL
|
Description
|
Input bundle to map the data structure to a JSON request
|
Bundle Directory
|
$IDE_BUNDLE_LOC
\
REQBNDL
|
- Click
SAVE.
- Click
BACK to return to the
JSONREQ page.
- Click
NEW and then select
Bundle from the drop-down list.
- Complete these fields:
Name
|
RESPBNDL
|
Description
|
Output bundle to map the JSON response to a data structure
|
Bundle Directory
|
$IDE_BUNDLE_LOC
\
RESPBNDL
|
- Click
SAVE.
- Click
BACK to return to the
JSONREQ page.
- Define a PCT resource
-
- On the
JSONREQ page, click
NEW and then select
PCT from the drop-down list.
- Complete these fields:
Name
|
INVJ
|
Description
|
CWS transaction to invoke the reverse service
|
Program Name
|
invkRevJ
|
- Click
SAVE.
- Open the DEMOSTRT startup list
-
- Expand
Startup Lists to see the list of CICS
STARTUP LISTS.
The
JSONREQ region uses the default startup list, named DEMOSTRT.
- Click
DEMOSTRT.
This opens the
DEMOSTRT page in the right pane.
- Add resource groups to the startup list
- As with the JSONPROV
enterprise server region, the JSONREQ region requires the DFHWEB and DFHPIPE resource groups, and the new JSONREQ resource group containing the requester
resources.
- On the
DEMOSTRT page under
GROUPS, click
ADD.
- On the
Available Groups list, check the
DFHPIPE,
DFHWEB, and
JSONREQ groups.
- Click
Select.
This adds all groups to the end of the list.
- Cllick
APPLY.
Install resources
You can install new and changed resources by stopping and starting the region.
- From the
Server Explorer in
Eclipse , right-click
JSONREQ; then select
Restart. This stops and then starts the
JSONREQ
enterprise server region, automatically installing and loading the newly added resources on the startup list.
Verify Resources
After
JSONREQ is started, you can verify that the resources you have defined are installed and active.
- From the ESCWA UI, click the
JSONREQ server in default list.
- From the
CICS drop-down list in the right pane, select
Resources.
- Set the first field to the right of
RESOURCES to
Active.
- On the resulting list of active resources, click
Bundle. You should see the
REQBNDL and
RESPBNDL bundles listed and marked as
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/json/reverse.
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 JSON 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.