CICS Web Services As A Provider and Requestor
CICS Web Services As A Provider and Requestor
CICS Web Services As A Provider and Requestor
Requestor
Ezriel Gross
Circle Software Incorporated
Request
Network
(Often, the Internet, or a
corporate IP network)
Response
Internet
or intranet
? Data Your CICS
(IP network)
area application
CICS
Pipeline
CICS
IP Data Data Your
network
web SOAP
area area program
support
A pipeline of programs
Your program can
CICS manages unwraps data from SOAP
continue to work with
IP and HTTP XML into a data area, and
data areas
vice versa
CICS as a web service provider
Tasks
Listens for Pipeline
requests Application
CICS web Message handler
SOAP
support handler(s)
Your program
Sends
responses
INVOKE WEBSERVICE
can optionally refer to a URIMAP PIPELINE WEBSERVICE
Resources dynamic
Also known as a “wrapper” program. Extracts data from XML, calls your CICS
application program, converts returned data back into XML.
Web service binding (wsbind) file
SOAP
Terminal message COMMAREA Your
message body
handler or container program
contents
wsbind file
wsbind file: pickup and shelf directories
SOAP
Web service
request
provider
Web service
Network
requester Your
SOAP CICS program
response
Methods for creating a web service
provider in CICS
SOAP
Web service
request
requester
Web service
Network
Your provider
CICS program SOAP
response
Methods for creating a web service
requester in CICS
03 PAYBUSOperation.
06 wsXpayrollXdata. <wsXpayrollXdata>
09 wsXrequest PIC X(4). <wsXrequest>DISP</wsXrequest>
09 wsXkey. <wsXkey>
12 wsXdepartment PIC X(1). <wsXdepartment>1</wsXdepartment>
12 wsXemployeeXno PIC X(5). <wsXemployeeXno>00001</wsXemployeeXno>
09 wsXname PIC X(20). </wsXkey>
09 wsXaddr1 PIC X(20). <wsXname>CIRCLE COMPUTER 1 </wsXname>
09 wsXaddr2 PIC X(20). ...
09 wsXaddr3 PIC X(20).
09 wsXphoneXno PIC X(8).
09 wsXtimestamp PIC X(8). XML allows hyphens in element
09 wsXsalary PIC X(8). names, but some applications and
09 wsXstartXdate PIC X(8).
09 wsXremarks PIC X(32). programming languages interpret such
09 wsXmsg PIC X(60). hyphens as minus signs (mathematical
... operators), with undesirable results
Sending a request to a web service from
a CICS COBOL program
EXEC CICS INVOKE
WEBSERVICE(CV-WEBSERVICE)
CHANNEL(CV-CHANNEL-NAME)
OPERATION(CV-OPERATION)
URI(CV-URI)
RESP(WS-EIB-RESP)
The RDz wizard generates
END-EXEC. a sample CICS COBOL
program that does this
Creating a requester using RDz
WSDL
The equivalent CICS
Web Service Description
Language file web services assistant
batch utility
(DFHWS2LS) does not
create this
RDz
interactive wizard
in Eclipse GUI
transport_
handler handler handler name handler_
list
service handler
service_ terminal_
handler_ handler
list