Sei sulla pagina 1di 25
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

CICS/TSCICS/TSCICS/TSCICS/TS SoapSoapSoapSoap XMLXMLXMLXML DevelopmeDevelopmentsDevelopmeDevelopmentsntsnts

DevelopmeDevelopmentsDevelopmeDevelopmentsntsnts David Clancy The mainframe breakfast network 5th November

David Clancy The mainframe breakfast network 5th November 2003

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

AcknowledgmentsAcknowledgmentsAcknowledgmentsAcknowledgments

The following are trademarks of International Business Machines Corporation in the United States, other countries, or both:

IBM, CICS, CICS/TS, CICS Transaction Server, DB2, MQSeries, OS/390, Z/OS, WebSphere.

Java, JavaBeans, and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, and service names and logos may be trademarks or service marks of others.

Dacworks Limited, Steepdown House, The Crescent, Steyning, West Sussex, BN44 3GD, England, United Kingdom. telephone: 44 (0) 1903 814731 web: http://www.dacworks.co.uk email: dacworks@btinternet.com

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

IntroductionIntroductionIntroductionIntroduction

IBM SOAP for CICS featureIntroductionIntroductionIntroductionIntroduction SOAP overview SOAP request and response examples Inbound

SOAP overviewIBM SOAP for CICS feature SOAP request and response examples Inbound CICS support

SOAP request and response examplesIBM SOAP for CICS feature SOAP overview Inbound CICS support Outbound CICS support DFHWBCLI

Inbound CICS supportfeature SOAP overview SOAP request and response examples Outbound CICS support DFHWBCLI Enterprise compilers XML

Outbound CICS supportSOAP request and response examples Inbound CICS support DFHWBCLI Enterprise compilers XML parse support Unicode

DFHWBCLIresponse examples Inbound CICS support Outbound CICS support Enterprise compilers XML parse support Unicode support

Enterprise compilersexamples Inbound CICS support Outbound CICS support DFHWBCLI XML parse support Unicode support Message generation

XML parse support

XML parse support

Unicode support

Unicode support

Message generationEnterprise compilers XML parse support Unicode support Using CICS document commands CICS/TS 2.3 enhancements JCICS

Using CICS document commandsXML parse support Unicode support Message generation CICS/TS 2.3 enhancements JCICS support for document commands

CICS/TS 2.3 enhancementssupport Message generation Using CICS document commands JCICS support for document commands Summary Nov 5th 2003

JCICS support for document commandsgeneration Using CICS document commands CICS/TS 2.3 enhancements Summary Nov 5th 2003 © Dacworks limited Page

Summarydocument commands CICS/TS 2.3 enhancements JCICS support for document commands Nov 5th 2003 © Dacworks limited

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

AvailabilityAvailabilityAvailabilityAvailability

IBM SOAP for CICS featureAvailabilityAvailabilityAvailabilityAvailability Delivers fully supported SOAP access to CICS Replaces CICS

Delivers fully supported SOAP access to CICSIBM SOAP for CICS feature Replaces CICS Technology Preview made available as

Replaces CICS Technology Preview made available as SupportPac CA1MCICS feature Delivers fully supported SOAP access to CICS Available since September for CICS/TS 2.2 CICS/TS

Available since September for CICS/TS 2.2CICS Technology Preview made available as SupportPac CA1M CICS/TS 2.3 announced 28th October Planned availability

CICS/TS 2.3 announced 28th Octoberas SupportPac CA1M Available since September for CICS/TS 2.2 Planned availability December 19, 2003 Price There

Planned availability December 19, 2003September for CICS/TS 2.2 CICS/TS 2.3 announced 28th October Price There is no charge for the

Price28th October Planned availability December 19, 2003 There is no charge for the IBM SOAP for

There is no charge for the IBM SOAP for CICS feature2.3 announced 28th October Planned availability December 19, 2003 Price Nov 5th 2003 © Dacworks limited

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

SimpleSimpleSimpleSimple ObjectObjectObjectObject AccessAccessAccessAccess ProtocolProtocolProtocolProtocol

AccessAccessAccessAccess ProtocolProtocolProtocolProtocol Provides a firewall-friendly way for exchanging XML with

Provides a firewall-friendly way for exchanging XML with CICS

Transports are provided over Hypertext Transfer Protocol (HTTP) and WebSphere MQ WebSphere MQ

Includes support for Secure Sockets Layer (SSL) via HTTPSover Hypertext Transfer Protocol (HTTP) and WebSphere MQ Both inbound and outbound function is provided The

Both inbound and outbound function is providedMQ Includes support for Secure Sockets Layer (SSL) via HTTPS The CICS implementation supports SOAP 1.1.

The CICS implementation supports SOAP 1.1.via HTTPS Both inbound and outbound function is provided Allows Microsoft and distributed client community direct

Allows Microsoft and distributed client community direct access to CICS in a format they understand - XMLfunction is provided The CICS implementation supports SOAP 1.1. CICS Servers Nov 5th 2003 © Dacworks

community direct access to CICS in a format they understand - XML CICS Servers Nov 5th
community direct access to CICS in a format they understand - XML CICS Servers Nov 5th
community direct access to CICS in a format they understand - XML CICS Servers Nov 5th
community direct access to CICS in a format they understand - XML CICS Servers Nov 5th

CICS

Servers

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

IBMIBMIBMIBM SOAPSOAPSOAPSOAP forforforfor CICSCICSCICSCICS featurefeaturefeaturefeature

Allows CICS/TS 2.2 to be an HTTP client as well as an HTTP serverforforforfor CICSCICSCICSCICS featurefeaturefeaturefeature IBM SOAP for CICS Permits existing CICS COMMAREA-based

IBM SOAP for CICSCICS/TS 2.2 to be an HTTP client as well as an HTTP server Permits existing CICS

Permits existing CICS COMMAREA-based applications to be driven via XML-formatted SOAP messagesan HTTP client as well as an HTTP server IBM SOAP for CICS Can also be

Can also be used for new XML-aware applications driven via SOAP messages messages

Enables CICS applications to issue outbound SOAP messages targeted via SOAP or XML messaging to remote applicationsfor new XML-aware applications driven via SOAP messages Client Soap Request Soap over http(s) Server Soap

Client Soap Request

Soap over http(s)
Soap over
http(s)

Server Soap Response

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

SOAPSOAPSOAPSOAP RequestRequestRequestRequest exampleexampleexampleexample

<?xml version="1.0" encoding="utf-8" ?> <soap:Envelope

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <GetUKLocationByTown xmlns="http://www.webserviceX.NET"> <Town>Steyning</Town> </GetUKLocationByTown> </soap:Body> </soap:Envelope>

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

SOAPSOAPSOAPSOAP ResponseResponseResponseResponse exampleexampleexampleexample

<?xml version="1.0" encoding="utf-8" ?>

- <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

- <soap:Body>

- <GetUKLocationByTownResponse xmlns="http://www.webserviceX.NET"> <GetUKLocationByTownResult> <NewDataSet> <Table> <Town>Steyning</Town> <County>West Sussex</County> <PostCode>BN44</PostCode> </Table> </NewDataSet></GetUKLocationByTownResult> </GetUKLocationByTownResponse> </soap:Body> </soap:Envelope>

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

IBMIBMIBMIBM SOAPSOAPSOAPSOAP forforforfor CICSCICSCICSCICS featurefeaturefeaturefeature inboundinboundinboundinbound

featurefeaturefeaturefeature inboundinboundinboundinbound When a SOAP message arrives The SOAP request needs to be

When a SOAP message arrives

The SOAP request needs to be parsed and passed to a CICS application program somewhere in the CICSplexinboundinboundinboundinbound When a SOAP message arrives A SOAP response or SOAP fault message is returned to

A SOAP response or SOAP fault message is returned to the clientto a CICS application program somewhere in the CICSplex Use IBM SOAP for CICS feature provided

Use IBM SOAP for CICS feature provided utilities, or roll your ownresponse or SOAP fault message is returned to the client XML Input Message Parse Mapping External

XML Input Message Parse Mapping External Application Client in CICSplex Message Output Message Generator
XML
Input
Message
Parse
Mapping
External
Application
Client
in CICSplex
Message
Output
Message
Generator Mapping
CICS SOAP SERVER
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

IBMIBMIBMIBM SOAPSOAPSOAPSOAP forforforfor CICSCICSCICSCICS featurefeaturefeaturefeature inboundinboundinboundinbound

featurefeaturefeaturefeature inboundinboundinboundinbound Which clients can work with CICS? Any external client that

Which clients can work with CICS?

Any external client that understands SOAP can communicate with CICSWhich clients can work with CICS? No need for gateways or environments doing TCPIP-SNA

No need for gateways or environments doing TCPIP-SNA protocol conversionclient that understands SOAP can communicate with CICS <?xml version="1.0"

<?xml version="1.0" encoding="utf-8"?> < instance soap:Envelope xmlns:xsi " xmlns:xsd
<?xml version="1.0" encoding="utf-8"?>
<
instance
soap:Envelope xmlns:xsi
"
xmlns:xsd
="
http://www.w3.org/2001/XMLSchema
=" http://www.w3.org/2001/XMLSchema-
"
xmlns:soap ="
http://schemas.xmlsoap.org/soap/envelope/
">
<
soap:Body
>
< request1
command
="
view
">
<
account
>
< department
>
1
</
department
>
< employeeNumber
>
00001
</
employeeNumber
>
</
account
>
</
request1
>
</
soap:Body
>
SOAP request
</
soap:Envelope
>
soap:Body > SOAP request </ soap:Envelope > < items command ="view” result =" success
soap:Body > SOAP request </ soap:Envelope > < items command ="view” result =" success
< items command ="view” result =" success "> < record > < department > 1
< items command
="view”
result
="
success
">
<
record
>
< department
>
1
</
department
>
< employeeNumber
>
00001
</
employeeNumber
>
< name
>
DAVID CLANCY
</
name
>
<
address1
>DACWORKS</
address1
>
<
address2
>STEYNING</
address2
>
<
address3
>
ENGLAND
</
address3
>
<
phone
>
12345678
</
phone
>
<
salary
>
12345600
</
salary
>
<
startDate
>01082003</
startDate
>
<
timeStamp
><![CDATA[
003243164395910C
]]></
timeStamp
>
<
remarks
>www.dacworks.co.uk</
remarks
>
</
record
>
</
items
>
SOAP response
External Client
External
Client

CICS

SOAP

SERVER

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
IBMIBMIBMIBM SOAPSOAPSOAPSOAP forforforfor CICSCICSCICSCICS

IBMIBMIBMIBM SOAPSOAPSOAPSOAP forforforfor CICSCICSCICSCICS featurefeaturefeaturefeature outboundoutboundoutboundoutbound

Program DFHWBCLI

This a utility program invoked via EXEC CICS LINK to provide outbound HTTP(S) support HTTP(S) support

DFHWBCLI may also be used independently of SOAP for CICSvia EXEC CICS LINK to provide outbound HTTP(S) support Input to DFHWBCLI URL of the destination

Input to DFHWBCLI

URL of the destination server URL of any proxy server Method HTTP request headers Optional CICS Document token

DFHWBCLI

HTTP request headers Optional CICS Document token DFHWBCLI External Web Server Output includes SOAP Response -

External

Web

Server

CICS Document token DFHWBCLI External Web Server Output includes SOAP Response -
CICS Document token DFHWBCLI External Web Server Output includes SOAP Response -
CICS Document token DFHWBCLI External Web Server Output includes SOAP Response -

Output includes SOAP Response

- <GetUKLocationByTownResponse xmlns="http://www.webserviceX.NET"> <GetUKLocationByTownResult> <NewDataSet> <Table> <Town>Steyning</Town> <County>West Sussex</County>

<PostCode>BN44</PostCode>

</Table>

</NewDataSet>

</GetUKLocationByTownResult>

</GetUKLocationByTownResponse>

Input to DFHWBCLI includes the SOAP request

<?xml version="1.0" encoding="utf-8" ?> <soap:Envelope

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<GetUKLocationByTown xmlns="http://www.webserviceX.NET">

<Town>Steyning</Town>

</GetUKLocationByTown>

</soap:Body>

</soap:Envelope>

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

IBMIBMIBMIBM ENTERPRISEENTERPRISEENTERPRISEENTERPRISE COBOLCOBOLCOBOLCOBOL &&&& PL1PL1PL1PL1

COBOLCOBOLCOBOLCOBOL &&&& PL1PL1PL1PL1 XML PARSER Gives capability to transform XML documents into

XML PARSER

&&&& PL1PL1PL1PL1 XML PARSER Gives capability to transform XML documents into COBOL or

Gives capability to transform XML documents into COBOL or PL1 data structures

Message Input XML HTTP Parser Mapper SOURCE WEBSPHERE EXCI Z/OS Message Output Generator Mapper WEBSPHERE
Message
Input
XML
HTTP
Parser
Mapper
SOURCE
WEBSPHERE
EXCI
Z/OS
Message
Output
Generator
Mapper
WEBSPHERE
XML
IIOP
ECI
DISTRIBUTED
SOURCE
CICS/TS
32k Commarea
constraint
No constraint on
message size
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

MessageMessageMessageMessage parserparserparserparser

WebSphere Studio Enterprise Developer (WSED)MessageMessageMessageMessage parserparserparserparser Provides a tool to generate converter routines from COBOL

Provides a tool to generate converter routines from COBOL copybooksWebSphere Studio Enterprise Developer (WSED) Enterprise COBOL V3 and Enterprise PL/I V3 Support a highly

Enterprise COBOL V3 and Enterprise PL/I V3a tool to generate converter routines from COBOL copybooks Support a highly efficient event-based parser to

Support a highly efficient event-based parser to roll your own mappingsCOBOL copybooks Enterprise COBOL V3 and Enterprise PL/I V3 < items command < record > ="

< items command

<

record

>

="

update " result

="

success

">

</

</

<

< employeeNumber

<

<

<

<

<

<

< >01082003</

<

<

><![CDATA[

department

name

>

1

</

department

>

00001

</

>

employeeNumber

>

>

</

name

00001 </ > employeeNumber > > </ name > DAVID CLANCY address1 >DACWORKS</

>

DAVID CLANCY

address1

>DACWORKS</

address1

address2

>STEYNING</

address2

>

address3

>

ENGLAND

</

address3

>

phone

salary

>

>

12345678

</

phone

>

12345600

</

salary

>

startDate

>

timeStamp

remarks

>

>www.dacworks.co.uk</

record

>

startDate

003243164395910C

]]></

timeStamp

>

remarks

>

items

>

Start of document: length=00000450 characters. Start element tag: <items> Attribute name: <command> Attribute value characters: <update> Attribute name: <result> Attribute value characters: <success> Content characters: < > Start element tag: <record> Start element tag: <department> Content characters: <1> End element tag: <department> Start element tag: <employeeNumber>

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

IBMIBMIBMIBM SOAPSOAPSOAPSOAP forforforfor CICSCICSCICSCICS featurefeaturefeaturefeature

SOAP messages are transmitted in unicode (UTF-8)forforforfor CICSCICSCICSCICS featurefeaturefeaturefeature Nearest supported CICS codepage is iso-8859-1 Message needs

Nearest supported CICS codepage is iso-8859-1SOAP messages are transmitted in unicode (UTF-8) Message needs to be translated to EBCDIC host page

Message needs to be translated to EBCDIC host page(UTF-8) Nearest supported CICS codepage is iso-8859-1 Problems with x'BA' and x'BB' a.k.a.

Problems with x'BA' and x'BB' a.k.a. '[' and ']'Message needs to be translated to EBCDIC host page Solution Use Enterprise compilers codepage conversion

Solutionand x'BB' a.k.a. '[' and ']' Use Enterprise compilers codepage conversion services To

Use Enterprise compilers codepage conversion servicesx'BB' a.k.a. '[' and ']' Solution To process UTF-8 data, first convert the data to UTF-16

To process UTF-8 data, first convert the data to UTF-16 in a national data itemUse Enterprise compilers codepage conversion services After processing the national data, convert it back to UTF-8

After processing the national data, convert it back to UTF-8 for outputfirst convert the data to UTF-16 in a national data item Client Soap Request Soap over

Client Soap Request

Soap over http(s)
Soap over
http(s)

Server Soap Response

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

COBOLCOBOLCOBOLCOBOL UNICODEUNICODEUNICODEUNICODE SUPPORTSUPPORTSUPPORTSUPPORT

National data itemsUNICODEUNICODE UNICODE UNICODE SUPPORTSUPPORTSUPPORT SUPPORT 01 davids-national-data PIC N(32000) usage national.

01 davids-national-data

PIC N(32000) usage national.

Enterprise COBOL uses UTF-16 for the national data typeitems 01 davids-national-data PIC N(32000) usage national. Coded character set identifier (CCSID) 1200 SOAP requires

Coded character set identifier (CCSID) 1200Enterprise COBOL uses UTF-16 for the national data type SOAP requires UTF-8 Coded character set identifier

SOAP requires UTF-8data type Coded character set identifier (CCSID) 1200 Coded character set identifier (CCSID) 1208 National-of:

Coded character set identifier (CCSID) 1208character set identifier (CCSID) 1200 SOAP requires UTF-8 National-of: converting UTF-8 TO UTF-16 move function

National-of: converting UTF-8 TO UTF-16requires UTF-8 Coded character set identifier (CCSID) 1208 move function national-of(davids-utf8-data, 1208) to

move function national-of(davids-utf8-data, 1208) to davids-national-data

Display-of: converting to a chosen codepagenational-of(davids-utf8-data, 1208) to davids-national-data move function display-of(davids-national-data, 1140) to

move function display-of(davids-national-data, 1140) to davids-ebcdic-data

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

CodeCodeCodeCode pagespagespagespages supportingsupportingsupportingsupporting thethethethe €uro€uro€uro€uro

 

Nearest

 

Euro

Pre-euro

 

CCSID

Description

CCSID

 
 

923

819

ISO/IEC 8859 part 15.

924

500 and

EBCDIC codepage with same character set as 923.

1047

1140

37

EBCDIC USA, Canada, Netherlands, Portugal, Brazil, Australia, New Zealand

1141

273

EBCDIC Austria, Germany

1142

277

EBCDIC Denmark, Norway

1143

278

EBCDIC Finland, Sweden

1144

280

EBCDIC Italy

1145

284

EBCDIC Spain, Latin America (Spanish)

1146

285

EBCDIC UK

1147

297

EBCDIC France

1148

285

EBCDIC Belgium, Canada, Switzerland

1149

871

EBCDIC Iceland

Canada, Switzerland 1149 871 EBCDIC Iceland SomeSomeSomeSome z/OSz/OSz/OSz/OS

SomeSomeSomeSome z/OSz/OSz/OSz/OS configurationconfigurationconfigurationconfiguration isisisis requiredrequiredrequiredrequired forforforfor compilerscompilerscompilerscompilers totototo workworkworkwork withwithwithwith UNICODEUNICODEUNICODEUNICODE

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

PassingPassingPassingPassing datadatadatadata betweenbetweenbetweenbetween CICSCICSCICSCICS programsprogramsprogramsprograms

Traditional commarea 32KCICSCICSCICSCICS programsprogramsprogramsprograms Showing its age but may be required for existing CICS

Showing its age but may be required for existing CICS applicationsprogramsprogramsprogramsprograms Traditional commarea 32K The SOAP for CICS feature Uses functions provided by CICS

The SOAP for CICS featureits age but may be required for existing CICS applications Uses functions provided by CICS Business

Uses functions provided by CICS Business Transaction Services (CICS/TS 1.3)for existing CICS applications The SOAP for CICS feature Sysplex enabled Output Includes SOAP Response -

Sysplex enabledprovided by CICS Business Transaction Services (CICS/TS 1.3) Output Includes SOAP Response -

Output Includes SOAP Response

- <GetUKLocationByTownResponse xmlns="http://www.webserviceX.NET"> <GetUKLocationByTownResult> <NewDataSet> <Table> <Town>Steyning</Town> <County>West Sussex</County>

<PostCode>BN44</PostCode>

</Table>

</NewDataSet>

</GetUKLocationByTownResult>

</GetUKLocationByTownResponse>

CBTS CONTAINERS

STATE DATA XML Mapping Parse CICS COMMAREA
STATE DATA
XML
Mapping
Parse
CICS
COMMAREA
32K
32K
STATE DATA XML Mapping Parse CICS COMMAREA 32K New or modified CICS application Commarea based CICS

New or modified CICS application

Commarea based CICS application

COMMAREA 32K New or modified CICS application Commarea based CICS application Nov 5th 2003 © Dacworks
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
MessageMessageMessageMessage

MessageMessageMessageMessage generationgenerationgenerationgeneration

CICS Web Support Document commands (CICS/TS 1.3)

EXEC CICS DOCUMENT CREATECICS Web Support Document commands (CICS/TS 1.3) EXEC CICS DOCUMENT INSERT EXEC CICS DOCUMENT SET EXEC

EXEC CICS DOCUMENT INSERTDocument commands (CICS/TS 1.3) EXEC CICS DOCUMENT CREATE EXEC CICS DOCUMENT SET EXEC CICS DOCUMENT RETRIEVE

EXEC CICS DOCUMENT SET1.3) EXEC CICS DOCUMENT CREATE EXEC CICS DOCUMENT INSERT EXEC CICS DOCUMENT RETRIEVE CBTS CONTAINERS STATE

EXEC CICS DOCUMENT RETRIEVECREATE EXEC CICS DOCUMENT INSERT EXEC CICS DOCUMENT SET CBTS CONTAINERS STATE DATA New or modified

CBTS CONTAINERS

STATE DATA
STATE DATA

New or modified CICS application

New or modified CICS application
New or modified CICS application
New or modified CICS application

CBTS CONTAINERS

STATE DATA
STATE DATA

CICS

COMMAREA 32K
COMMAREA
32K

Commarea based CICS application

Commarea based CICS application
Commarea based CICS application
Commarea based CICS application
DATA CICS COMMAREA 32K Commarea based CICS application CICS COMMAREA 32K Message generation Mapping Nov 5th

CICS

COMMAREA

COMMAREA 32K Commarea based CICS application CICS COMMAREA 32K Message generation Mapping Nov 5th 2003 ©
32K
32K

Message

generation

Mapping

based CICS application CICS COMMAREA 32K Message generation Mapping Nov 5th 2003 © Dacworks limited Page
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

MessageMessageMessageMessage generationgenerationgenerationgeneration ---- 1111

generationgenerationgenerationgeneration ---- 1111 DOCUMENT CREATE Creates a document buffer up to 1Gb in size

DOCUMENT CREATE

Creates a document buffer up to 1Gb in size---- 1111 DOCUMENT CREATE Could be html, xml, wml, soap, gif, jpg - i.e. any MIME

Could be html, xml, wml, soap, gif, jpg - i.e. any MIME typeDOCUMENT CREATE Creates a document buffer up to 1Gb in size Can be sent with CWS

Can be sent with CWS WEB SEND command over http(s) or RETRIEVED for alternative transmission alternative transmission

EXEC CICS DOCUMENT CREATE DOCTOKEN(WS-TOKEN) DOCSIZE(WS-RETRIEVE-LENGTH)

TEMPLATE('DACP04')

SYMBOLLIST(WS-SYMBOLS) LISTLENGTH(LENGTH OF WS-SYMBOLS) END-EXEC

SYMBOLLIST(WS-SYMBOLS) LISTLENGTH(LENGTH OF WS-SYMBOLS) END-EXEC Nov 5th 2003 © Dacworks limited Page 19
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

MessageMessageMessageMessage generationgenerationgenerationgeneration ---- 2222

generationgenerationgenerationgeneration ---- 2222 DOCUMENT INSERT Allows the document to be composed from

DOCUMENT INSERT

Allows the document to be composed from multiple templates---- 2222 DOCUMENT INSERT Templates simplify building dynamic content - alternative to

Templates simplify building dynamic content - alternative to jspAllows the document to be composed from multiple templates CICS templates can be built with any

CICS templates can be built with any editor, WSED, FRONTPAGE etc.simplify building dynamic content - alternative to jsp EXEC CICS DOCUMENT INSERT D O C T

EXEC CICS DOCUMENT INSERT DOCTOKEN(WS-TOKEN) DOCSIZE(WS-RETRIEVE-LENGTH) TEMPLATE('DACPREC') END-EXEC.

D O C T O K E N ( W S - T O K E
D O C T O K E N ( W S - T O K E
D O C T O K E N ( W S - T O K E
TEMPLATE('DACPREC') END-EXEC. <BODY> Userid: &Userid; or Userid

<BODY>

Userid: &Userid; or Userid <!--#echo var=Userid-->

<jsp:useBean id="md" type="my.package.MyData” scope="request"/> <BODY>

Userid:

<%=md.getUserid() %>

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

MessageMessageMessageMessage generationgenerationgenerationgeneration ---- 3333

generationgenerationgenerationgeneration ---- 3333 DOCUMENT SET Allows for symbol substitution in document

DOCUMENT SET

Allows for symbol substitution in document templates---- 3333 DOCUMENT SET Symbol values may be fixed or variable length Symbols may be

Symbol values may be fixed or variable lengthSET Allows for symbol substitution in document templates Symbols may be updated individually or in groups

Symbols may be updated individually or in groups (symbol lists)templates Symbol values may be fixed or variable length MOVE 'Userid’ TO WS-SYMBOL-NAME EXEC CICS DOCUMENT

MOVE 'Userid’ TO WS-SYMBOL-NAME

EXEC CICS DOCUMENT SET DOCTOKEN(WS-TOKEN) SYMBOL (WS-SYMBOL-NAME) VALUE (TRANSACTION-USERID) LENGTH (USERID-LENGTH) END-EXEC

CICS DOCUMENT SET DOCTOKEN(WS-TOKEN) SYMBOL (WS-SYMBOL-NAME) VALUE (TRANSACTION-USERID) LENGTH (USERID-LENGTH) END-EXEC
CICS DOCUMENT SET DOCTOKEN(WS-TOKEN) SYMBOL (WS-SYMBOL-NAME) VALUE (TRANSACTION-USERID) LENGTH (USERID-LENGTH) END-EXEC
CICS DOCUMENT SET DOCTOKEN(WS-TOKEN) SYMBOL (WS-SYMBOL-NAME) VALUE (TRANSACTION-USERID) LENGTH (USERID-LENGTH) END-EXEC
CICS DOCUMENT SET DOCTOKEN(WS-TOKEN) SYMBOL (WS-SYMBOL-NAME) VALUE (TRANSACTION-USERID) LENGTH (USERID-LENGTH) END-EXEC
(WS-SYMBOL-NAME) VALUE (TRANSACTION-USERID) LENGTH (USERID-LENGTH) END-EXEC Nov 5th 2003 © Dacworks limited Page 21
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

MessageMessageMessageMessage generationgenerationgenerationgeneration ---- 4444

generationgenerationgenerationgeneration ---- 4444 DOCUMENT RETRIEVE (optional) Allows access to document

DOCUMENT RETRIEVE (optional)

Allows access to document buffer for alternative transmission from CICS---- 4444 DOCUMENT RETRIEVE (optional) The message can be delivered by any CICS mechanism:

The message can be delivered by any CICS mechanism: commarea, transient data queue, WebSphere MQ, IIOP or HTTP(S)to document buffer for alternative transmission from CICS <?xml version="1.0"

<?xml version="1.0" encoding="utf-8"?> < soap:Envelope xmlns:xsi ="
<?xml version="1.0" encoding="utf-8"?>
<
soap:Envelope xmlns:xsi
=" http://www.w3.org/2001/XMLSchema-
instance
"
xmlns:xsd
="
http://www.w3.org/2001/XMLSchema
"
xmlns:soap ="
http://schemas.xmlsoap.org/soap/envelope/
">
<
soap:Body
>
EXEC CICS
DOCUMENT RETRIEVE
DOCTOKEN(WS-TOKEN)
<
items command
="view”
result
="
success
">
<
record
>
<
department
>
1
</
department
>
<
employeeNumber
>
00001
</
employeeNumber
>
INTO(LS-RETRIEVE-DOC1)
<
name
>
DAVID CLANCY
</
name
>
LENGTH(WS-RETRIEVE-SAVE)
<
address1
>DACWORKS</
address1
>
SOAP response
MAXLENGTH(WS-DOCSIZE-LENGTH)
<
address2
>STEYNING</
address2
>
<
address3
>
ENGLAND
</
address3
>
END-EXEC
<
phone
>
12345678
</
phone
>
<
salary
>
12345600
</
salary
>
<
startDate
>01082003</
startDate
>
<
timeStamp
><![CDATA[
003243164395910C
]]></
timeStamp
>
<
remarks
>www.dacworks.co.uk</
remarks
>
</
record
>
</
items
>
</
soap:Body
>
</
soap:Envelope
>
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

CICS/TSCICS/TSCICS/TSCICS/TS 2.32.32.32.3 JCICSJCICSJCICSJCICS EnhancementsEnhancementsEnhancementsEnhancements

EnhancementsEnhancementsEnhancementsEnhancements JCICS now supports the DOCUMENT API Allows Java application

JCICS now supports the DOCUMENT API

JCICS now supports the DOCUMENT API Allows Java application programmers to access CICS Web

Allows Java application programmers to access CICS Web support data and develop CICS Web applications without using servlets and JSPs.

Methods

EXEC CICS Commands

create()

DOCUMENT CREATE

insert()

DOCUMENT INSERT

setSymbolList()

DOCUMENT SET

retrieve()

DOCUMENT RETRIEVE

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
SummarySummarySummarySummary IBM SOAP for CICS feature

SummarySummarySummarySummary

IBM SOAP for CICS feature

Provides a firewall-friendly way for exchanging XML with CICSSummarySummarySummarySummary IBM SOAP for CICS feature Message parsing, mapping and message generation run under

Message parsing, mapping and message generation run under CICSa firewall-friendly way for exchanging XML with CICS Supports very large messages UTF-8 to host codepage

Supports very large messagesparsing, mapping and message generation run under CICS UTF-8 to host codepage conversion now possible with

UTF-8 to host codepage conversion now possible with Enterprise compilersgeneration run under CICS Supports very large messages Allows Microsoft and distributed client community direct

Allows Microsoft and distributed client community direct access to CICS in a format they understand - XML/SOAP format they understand - XML/SOAP

direct access to CICS in a format they understand - XML/SOAP CICS Servers Nov 5th 2003
direct access to CICS in a format they understand - XML/SOAP CICS Servers Nov 5th 2003
direct access to CICS in a format they understand - XML/SOAP CICS Servers Nov 5th 2003
direct access to CICS in a format they understand - XML/SOAP CICS Servers Nov 5th 2003

CICS

Servers

DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS
DACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKSDACWORKS

FurtherFurtherFurtherFurther ininformationininformationformationformation

IBM SOAP for CICS featureininformationininformationformationformation http://www.ibm.com/software/htp/cics/soap/ CICS/TS 2.3

http://www.ibm.com/software/htp/cics/soap/

CICS/TS 2.3 Announcementfor CICS feature http://www.ibm.com/software/htp/cics/soap/ http://www-3.ibm.com/software/htp/cics/tserver/v23/

http://www-3.ibm.com/software/htp/cics/tserver/v23/

Enterprise COBOLhttp://www-3.ibm.com/software/htp/cics/tserver/v23/ http://www-3.ibm.com/software/ad/cobol/zos/library/ XML 1.1

http://www-3.ibm.com/software/ad/cobol/zos/library/

XML 1.1 specificationCOBOL http://www-3.ibm.com/software/ad/cobol/zos/library/ http://www.w3.org/TR/xml11/ SOAP 1.1 specification

http://www.w3.org/TR/xml11/

SOAP 1.1 specificationXML 1.1 specification http://www.w3.org/TR/xml11/ http://www.w3.org/TR/SOAP/ CICS SOAP and JCICS workshops

http://www.w3.org/TR/SOAP/

CICS SOAP and JCICS workshopsSOAP 1.1 specification http://www.w3.org/TR/SOAP/ http://www.dacworks.co.uk Nov 5th 2003 © Dacworks limited

http://www.dacworks.co.uk