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.

3 Introduction.. 1 Chapter 1. java Connectors for cics .. cics Transaction Gateway .. CTG APIs .. cics CCF connector.. cics Connector for cics TS .. 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.

4 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 .. 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.

5 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 .. Tracing .. Using the Enterprise Access Builder .. Creating a Record out of a COMMAREA .. Creating a Command bean.

6 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.

7 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.

8 Exception handling .. Connecting to secured cics transactions .. Signon capable terminals .. 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.

9 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 .. 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.

10 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.