Tutorial: Web-enabled CICS Acting as a Web Server

Walks you through the process of implementing and running the Web-enabled version of the ACCT demonstration application.

This tutorial covers many of the concepts covered in Tutorial: CICS Support in that the project and enterprise server region setup is much the same. However, the demonstration application has been modified to Web-enable just the function that searches by name. Once you have the project and enterprise server region ready to go, you first interact with the application via a TN3270 session to add VSAM data. Following that, you then interact with the application via a Web browser to retrieve that data by searching for a name. The tutorial concludes with an exercise in which you debug the Web-enabled portion of the application from Enterprise Developer.

Prerequisite

Review the Assumptions and Before you begin a tutorial sections in the Tutorials: CICS topic to ensure that your environment is set up properly.

Demonstration application - Web-enabled server ACCT

This Web-enabled ACCT demonstration application is the standard example application that IBM supplies with CICS systems with one exception. An additional COBOL program file, ACCTWEB.cbl has been added to Web-enable the SEARCH BY NAME function. It includes the following source code files, supplied with Enterprise Developer:

ACCT00.cbl
The program associated with the ACCT transaction. It displays a menu screen for the on-line account file application, which prompts the user for input. Transaction AC01 is invoked when that input is received.
ACCT01.cbl
The program associated with all functions of the AC01 transaction except the SEARCH BY NAME function when it originates from the Web (see ACCTWEB.cbl below). Analyzes all requests, and completes those for name inquiries and record displays. For update transactions, it sends the appropriate data entry screen and sets the next transaction identifier to AC02, which completes the update operation. For print requests, it starts transaction AC03 to do the actual printing.
ACCT02.cbl
The program associated with the AC02 transaction. It completes requests for account file updates (adds, modifies, and deletes), after the user entered the update information.
ACCT03.cbl
The program associated with the AC03 transaction. It completes a request for printing of a customer record, which was processed initially by transaction AC01.
ACCT04.cbl
The program associated with the AC04 transaction. It is a general purpose error routine that is invoked by other programs in the online account file application when an unrecoverable error has occurred. It sends a message to the input terminal describing the type of error and prompts the operator to report it. It then exits, backing out any updates made in the uncompleted transaction.
ACCTWEB.cbl
The program associated with AC01 transaction SEARCH BY NAME requests that originate on the Web.
acctset.bms
The BMS mapset used by the ACCT application.
ACCTREC.cpy
The record definition for the ACCTFIL VSAM file used by the application.

Sequence

To complete this tutorial, progress through these topics in the order presented here. The bottom of each topic provides Next topic and Previous topic navigational links to help you proceed in the proper sequence:

  1. Set up the ACCTWEB Project
    Guides you through all of the project-centric steps of this tutorial, including creating the ACCTWEB project, importing the ACCTWEB demonstration files, and configuring the project in Eclipse
  2. Set Up the ESACCTSV Enterprise Server Region
    Provides step-by-step instructions to complete the creation and configuration of the ESACCTSV enterprise server region on which to run the ACCT Web-enabled application.
  3. Run the ACCTWEB Application in TN3270 Mode
    Provides instructions for running the ACCTWEB application on the ESACCTSV enterprise server region from the Rumba+ Desktop TN3270 terminal display, and add two data records. This sets up the application data such that you can access it from a Web browser later in the tutorial.
  4. Run the ACCTWEB Application in a Web Browser
    Walks you through the process of running the ACCTWEB application from a Web browser to access the data you added while interacting with the application in TN3270 mode.
  5. Debug the ACCT Transaction
    Guides you through the process of creating a debug configuration and debugging the ACCT transaction using the Enterprise Developer debugger in Eclipse.
Parent topic: Tutorials: CICS