Java Connectors for CICS - IBM Redbooks

1 Connectorsfor CICSF eaturing the J2EE Connector ArchitecturePhil WakelinMartin KeenRichard JohnsonDaniel Cerecedo DiazUse cics J2EE resource adapters and deploy applications to WebSphereDevelop applications using the Enterprise Access BuilderUnderstand the J2EE CCI and the CTG base classesFront coverJava Connectors for cics :Featuring the J2EE Connector ArchitectureMarch 2002 International Technical Support OrganizationSG24-6401-00 Copyright International Business Machines Corporation 2002. All rights to Government Users Documentation related to restricted rights Use, duplication or disclosure is subject torestrictions set forth in GSA ADP Schedule Contract with IBM Edition (March 2002)This edition applies to cics Transaction Gateway , VisualAge for java , WebSphere Studio Application Developer V4, WebSphere Application Server Advanced Edition may be addressed to:IBM Corporation, International Technical Support OrganizationDept.

2 QXXE Building 80-E2650 Harry RoadSan Jose, California 95120-6099 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to Note! Before using this information and the product it supports, be sure to read the general information in Special notices on page vii. Copyright IBM Corp. 2002iiiContentsSpecial notices.. viiIBM trademarks .. viiiPreface .. ixThe team that wrote this redbook .. xNotice .. xiComments welcome .. xiPart 1. Introduction.. 1 Chapter 1. java Connectors for cics .. cics Transaction Gateway .. CTG APIs .. cics CCF connector.. cics Connector for cics TS.

3 J2EE Connectors .. 7 Chapter 2. cics Transaction Gateway .. CTG: interfaces .. CTG: infrastructure .. Gateway daemon .. Client daemon .. Configuration tool .. Terminal Servlet .. 16 Chapter 3. cics and the J2EE Connector Architecture.. J2EE Connector Architecture .. Components of the J2EE Connector Architecture .. Managed and non-managed environments .. The Common Connector Framework .. Common Client Interface.. CCI overview .. Using the CCI classes .. System contracts .. Connection management .. Transaction management .. Security management .. cics resource adapters .. 29iv java Connectors for ECI resource adapter.

4 EPI resource adapter .. 30 Part 2. Connecting to COMMAREA based cics programs.. 33 Chapter 4. ECI and ESI applications .. Base classes overview .. JavaGateway overview .. ECIR equest overview .. ESIR equest overview .. Synchronous ECI calls .. ECIR equest configuration .. Program flow .. Asynchronous ECI calls .. Reply solicitation calls .. Program flow .. Callback objects .. ESI calls .. Extended logical units of work .. Tracing .. Exception handling .. ECI return codes .. ESI return codes .. Implementing an exception handling framework .. 66 Chapter 5. CCI applications: ECI based .. Using the CCI .. Writing a simple CCI application.

5 Tracing .. Using the Enterprise Access Builder .. Creating a Record out of a COMMAREA .. Creating a Command bean .. Migrating a CCF application .. Asynchronous calls .. Extended logical units of work .. Using JNDI .. Using JNDI with the CCI .. Using JNDI with the EAB .. Using JNDI with a Command bean .. Exception handling .. Developing an exception handling routine .. 109 Chapter 6. CCI applications in a managed environment .. WebSphere managed environment.. 112 Contents Configuring WebSphere Application Server .. Creating the CCI application .. Configuring WebSphere Studio Application Developer.. Creating an enterprise bean.

6 Editing the EJB deployment descriptor .. Testing the enterprise bean.. Deploying the application to WebSphere .. Enabling JNDI in the application .. Exporting the application from Application Developer.. Installing the EAR file into WebSphere .. 150 Part 3. Connecting to 3270 based cics transactions.. 153 Chapter 7. EPI support classes .. Creating a simple EPI application .. Using the EPIG ateway class .. Using the Terminal class .. Using the Screen and Field classes .. Extending the EPI application .. Using the Map class and the BMSMapConvert utility .. Exception handling .. Connecting to secured cics transactions .. Signon capable terminals.

7 Signon incapable terminals .. 178 Chapter 8. CCI applications: EPI based .. Using the CCI .. Writing a simple CCI application .. Extending a CCI application .. Tracing .. Using the Enterprise Access Builder .. Writing a simple EAB application .. Extending an EAB application .. Migrating a CCF application .. Connecting to secured cics transactions .. Signon capable terminals .. Signon incapable terminals .. 214 Part 4. Appendices .. 217 Appendix A. Configuring the cics Connectors in VisualAge for java .. Installing VisualAge for java .. Configuring VisualAge for java .. Updating the Enterprise Access Builder .. 221vi java Connectors for Updating the connector projects with specification classes.

8 222 Appendix B. Data conversion.. Conversion within java .. Conversion within cics : DFHCNV templates .. EAB and the java Record Framework .. 237 Appendix C. Sample cics programs.. ECIADDER .. ECIPROG .. EPIPROG .. SWAP .. TRADER .. 253 Appendix D. Additional material .. 261 Locating the Web material .. 261 Using the Web material .. 262 System requirements for downloading the Web material .. 263 How to use the Web material .. 263 Abbreviations and acronyms .. 265 Related publications .. 267 IBM Redbooks .. 267 Other resources .. 267 Referenced Web sites .. 267 How to get IBM Redbooks .. 268 IBM Redbooks collections .. 268 Index .. 269 Copyright IBM Corp. 2002viiSpecial noticesReferences in this publication to IBM products, programs or services do not imply that IBM intends to make these available in all countries in which IBM operates.

9 Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent program that does not infringe any of IBM's intellectual property rights may be used instead of the IBM product, program or in this book was developed in conjunction with use of the equipment specified, and is limited in application to those specific hardware and software products and may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact IBM Corporation, Dept.

10 600A, Mail Drop 1329, Somers, NY 10589 information may be available, subject to appropriate terms and conditions, including in some cases, payment of a information contained in this document has not been submitted to any formal IBM test and is distributed AS IS. The use of this information or the implementation of any of these techniques is a customer responsibility and depends on the customer's ability to evaluate and integrate them into the customer's operational environment. While each item may have been reviewed by IBM for accuracy in a specific situation, there is no guarantee that the same or similar results will be obtained elsewhere. Customers attempting to adapt these techniques to their own environments do so at their own pointers in this publication to external Web sites are provided for convenience only and do not in any manner serve as an endorsement of these Web java Connectors for CICSIBM trademarksThe following terms are trademarks of the International Business Machines Corporation in the United States and/or other countries:The following terms are trademarks of the International Business Machines Corporation in the United States and/or other countries:Other company trademarksThe following terms are trademarks of other companies:C-bus is a trademark of Corollary, Inc.