Front cover Application Development for IBM CICS Web Services Overview of Web services in CICS updated for CICS TS 5.2 New Web service performance measurements for CICS TS 5.2 New SOA patterns for CICS TS 5.2 James O’Grady Ian Burnett Jim Harrison San Yong Liu Xue Yong Zhang ibm.com/redbooks International Technical Support Organization Application Development for IBM CICS Web Services January 2015 SG24-7126-02 Note: Before using this information and the product it supports, read the information in “Notices” on page xiii. Third Edition (January 2015) This edition applies to Version 5, Release 2, of IBM CICS Transaction Server. © Copyright International Business Machines Corporation 2015. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . xiii Trademarks . xiv IBM Redbooks promotions . xv Preface . xvii Authors . xvii Now you can become a published author, too! . xix Comments welcome. xx Stay connected to IBM Redbooks . xx Summary of changes . xxi January 2015, Third Edition . xxi Part 1. Introduction . 1 Chapter 1. Overview of Web services . 3 1.1 Introduction . 4 1.2 Service-oriented architecture . 4 1.2.1 Characteristics . 6 1.2.2 Web services versus SOAs. 6 1.3 Web services. 7 1.3.1 Properties of a Web service . 7 1.3.2 Core standards . 8 1.3.3 Web Services Interoperability group . 11 1.3.4 Additional standards . 11 1.4 IBM WebSphere Service Registry and Repository . 13 1.5 SOAP . 13 1.5.1 The envelope . 13 1.5.2 Communication styles . 18 1.5.3 Encodings . 18 1.5.4 Messaging modes . 19 1.6 WSDL . 20 1.6.1 WSDL Document . 20 1.6.2 WSDL document anatomy . 21 1.6.3 WSDL definition . 25 1.6.4 WSDL bindings . 31 Chapter 2. CICS TS implementation of Web services . 35 © Copyright IBM Corp. 2015. All rights reserved. iii 2.1 Support for Web services in CICS TS . 36 2.1.1 Core aspects of Web services in CICS . 36 2.2 Tools for application deployment. 38 2.2.1 CICS Web Services Assistant. 38 2.2.2 IBM Rational Developer for System z v9.1 . 39 2.2.3 Other Options . 39 2.3 CICS as a service provider . 40 2.3.1 Preparing to run a CICS application as a service provider . 41 2.3.2 Processing the inbound service request . 43 2.4 CICS as a service requester . 44 2.4.1 Preparing to run a CICS application as a service requester . 45 2.4.2 Processing the outbound service request . 46 2.5 The CICS resource definitions . 47 2.5.1 URIMAP . 48 2.5.2 PIPELINE . 49 2.5.3 WEBSERVICE . 52 2.5.4 The Web service binding file (WSBind). 54 2.5.5 SOAPFAULT commands . 56 2.5.6 Mapping levels . 57 2.5.7 Enhancements with CICS TS V3.2 . 59 2.5.8 Additional enhancements with CICS TS 4.1 . 61 2.5.9 Use of WS-Addressing in CICS TS V4.1 applications . 63 2.5.10 AXIS2 Provider PIPELINEs in CICS TS V4.2 . 63 2.5.11 CICS Transaction Server V5.1 makes CONTAINERs easier . 63 2.5.12 Further enhancements in CICS TS V5.2. 63 2.5.13 Comparing releases of CICS Transaction Server . 64 Chapter 3. Development approaches . 67 3.1 Introduction . 68 3.2 Bottom-up approach . 69 3.3 Top-down approach . 71 3.4 Meet-in-the-middle approach . 72 3.5 The advantages of using Rational Developer for System z . 74 3.6 Web services versus CICS TCP/IP connectivity . 76 3.7 Conclusions. 77 Chapter 4. CICS catalog manager example application . 79 4.1 Samples for use with CICS Web Services . 80 4.2 Introduction to the catalog manager application . 80 4.3 Installation and setup of the base application . 81 4.3.1 Creating the VSAM data sets . 82 4.3.2 Defining the base application to CICS . 82 4.3.3 Configuring the example application . 83 iv Application Development for IBM CICS Web Services 4.3.4 Configuring code page support . 86 4.4 Web service support for the example application . 87 4.4.1 The Web client front end . 87 4.4.2 The CICS Web service client front end . 88 4.4.3 Order dispatch Web services endpoints . 89 4.4.4 Alternative Web service provider configuration. 89 4.5 Web services setup . 90 4.5.1 Creating the zFS directories . 91 4.5.2 Creating the PIPELINE definition . 91 4.5.3 Creating a TCPIPSERVICE . 93 4.5.4 Dynamically installing WEBSERVICE and URIMAP resources . 94 4.5.5 Creating the WEBSERVICE resources with RDO . 97 4.5.6 Creating the URIMAP resources with RDO . 98 4.5.7 Completing the installation . 99 4.6 Installing the client application. 99 4.6.1 FTP the client application . 100 4.6.2 Install the client . 100 4.6.3 Start the client . ..