This ppt created to have high level over view on CICS Web Service. It explain how to send and receive the message from other syste

1. CICS WEB INTERFACE
(OVERVIEW)
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 1

2. DO YOU KNOW?
We can code HTML tag in cics
We can code java program into the cics
We can code scripting language into cics.
Some other facility also are provided
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 2

3. CICS WEB APPLICATION
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM
Description:
CICS web interface are use in business logic interface to link to other
services , and Eventually ,to the target CICS application program.
Benefits:
Provide Web access to existing CICS programs without requiring a Web
Server, without reprogramming a existing business logic,
Support access by methods other than the Web using the business logic
interface
The 3270 Bridge provide
- a turnkey solution,
- Support BMS MAP customization for the Web.
3

4. CICS WEB APPLICATION OVERVIEW
CICS
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM
TCP/IP
SUPPORT
CICS
Web
Support
Business
Logic
Interface
CICS
Application
Program
COMMAREA
HTTP
WEB
Browser
4

5. CREATED BY : BAL MUKUND BIHARI EMAIL:
MUKUND4LIFE@GMAIL.COM
CWI High Level Flow
TCP/IP
SUPPORT
Sockets
Listener
Task
Web Attach
Task
Code Conversion
Analyzer
Code Conversion
Alias
Transaction
Business
Logic
Interface
Converter
CICS Application
Code Conversion
5
CICS System

6. MAIN COMPONENTS OF CWI
TCP/IP Support: all the request communicated through TCP/IP port assigned
to the CICS region.
 Web attached task: its links to a series of programs
 converter : convert the HTTP request header from code page to EBCDIC.
 Analyzer: analyze the content for further decisions
 Web Attach Task: it start remaining task into cics like normal cics
processing
 Alias transaction:: it link to business logic interface under option HTTP
request get decoded into COMMAREA and also it link to the target
application program
 BLI return to alias which link to the code conversion program one last
time to convert the output from EBCDIC to code page of client.
 The CWI return this HTML response to the originating Wb browser.
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 6

7. INITIATING A CICS TRANSACTION
URL:
http:serverIP:port/cics/cwba/cicspgm?data=110
http: protocol being used for the above request
ServerIP: The IP address of the server this is nothing but IP address of cics
port: port number assigned to CWI
Cics: the converter that used , CICS is a default analyzer not to ask for converter.
Cwba: transaction name
Cicspgm: cics application program to be executed
Data=110 : user data to be passed the application.
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 7

8. PROCESSING HTTP REQUESTS
Retrieve the method version, URL path etc from an inbound request
EXEC CICS
EXTRACT HTTPMETHOD (data-area1) HTTPVERSION (data-area2) PATH
(data-area3)
Browse through all the version various HTTP headers in an inbound request
STARTBROWSE HTTPHEADER READNEXT HTTPHEADER (data-area)
VALUE (data-area2)
END BROWSE HTTPHEADER
Receive HTTP request body or entire non-HTTP request
RECEIVE INTO (data-area)
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 8

9. WRITING A COVERTOR PROGRAM
 Converter name specified by analyzer
 Linked by Business logic interface (BLI)
 Executes under Alias transaction ID
 Runs in the same region where request received
 Each request uses same program for both encode and decode.
 Decode function builds COMMAREA for target program
 Encode function builds HTTP response
 Purpose: remove HTTP and HTML considerations from target
program
 Architected COMMREA
 COPY books for parameters and constants
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 9

10. DOCUMENT TEMPLATE
Build HTML templates offline
Use Template manager or
EXEC CICS DOCMENTS CREATE a new documents
SET value for symbols
INSERT object into documents
Text strings Symbols
values bookmarks
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM
NAME=xxxxxx&PHON=999999
Heading
Bookmarks
More text
Bookmarks
Template
...
Data
10

11. CREATING THE TEMPLATE
It can be stored into portioned data set member or in TDQ (Transient
data queue) or TS ( temporary storage) or VSAM file etc.
Template content :
 HTML TAGS and attributes
 Variables : Begin with & and End with ;
 Template Is case sensitive
<html>
<p> customer &NAME;
<p>phone &PHON;
</html>
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM
11

12. USING THE DOCUMENTS API
EXEC CICS DOCUMENTS CREATE DOCTOKEN (token)
TEMPLATE(‘inquiry-heading)
DOCUMENT SET DOCTOKEN (token)
SYMBOL(‘NAME’) VALUE( cust-name)
DOCUMENT SET DOCTOKEN (token)
SYMBOL(‘name’) VALUE( cust-name)
EXEC CICS DOCUMENT INSERT DOCTOKEN(TOKEN)
TEMPALTE(‘inquiry-footing’)
EXEC CICS WEB SEND DOCTOKEN (token)
<html><head>
<title> Customer inquiry
</title></head>
<body>
<p>Customer &NAME;
<p>Phone: &PHON;
</body</html>
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM
12

13. EXEC CICS DOCUMENT : It assembling HTML documents
EXEC CICS Web : it access the HTTP web command request and used to send
the response.
Create : it start a new document using a header template and return the
document token that is used to for subsequent call.
SET : it manipulates symbols and there associated value.
INSERT: Place an object into the document like footing or heading
WEB SEND : It schedule the document for out put
CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 13

14. CREATED BY : BAL MUKUND BIHARI EMAIL: MUKUND4LIFE@GMAIL.COM 14