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.


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:

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.
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.
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.
The program associated with the AC03 transaction. It completes a request for printing of a customer record, which was processed initially by transaction AC01.
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.
The program associated with AC01 transaction SEARCH BY NAME requests that originate on the Web.
The BMS mapset used by the ACCT application.
The record definition for the ACCTFIL VSAM file used by the application.


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: