EJB CICS Sample Application task guide

This is a task guide for working with, and recreating, the EJB CICS sample application supplied with version 2.1 of the CICS Transaction Server for z/OS. This task guide leads you through all the stages involved in creating, deploying and running the sample application. You can also use this task guide to identify the steps involved in modifying the sample, and in building a similar application using your own resources.

To read about the concepts underlying these tasks, and for generalised task descriptions see entries for the EJB CICS sample application in the CICS Transaction Server Information Centre.

IBM CICS Transaction Server for z/OS

Press the Task tab in the tab bar to see the task steps.


The EJB CICS Sample Application

The EJB CICS sample application demonstrates how you can use enterprise beans to make existing, CICS-controlled, information available to Web users. The sample application extracts customer information from data tables and returns it to the user of a Web browser.

This is how the sample works:

  1. The user starts the application from a Web browser. A form is displayed.
  2. The form requests a customer number from the user. When the user has entered a customer number and pressed the SUBMIT button, the servlet is invoked and sends the number to the enterprise bean.
  3. The enterprise bean uses the CCF interface of the CICS connector for CICS TS to link to the CICS server programs, passing the customer number.
  4. The server programs use the specified number as the key to the DB2 records for this customer. They retrieve the customer's details from the DB2 data tables and return the account number, balance, and address to the enterprise bean.
  5. The enterprise bean returns the customer's details to the servlet, which uses Java Server Pages to display them on the user's browser. If the customer number is not valid, the browser displays an error page.