Tutorial: CICS Screen Web Service

Guides you through the process of using the Interface Mapping Toolkit (IMTK) to create and configure all of the components required to define and run a CICS SOAP Web service derived from the BMS map component of a CICS COBOL application.

Prerequisites

Ensure you have completed general setup requirements
Review the Assumptions and Before you begin these tutorials sections in the Tutorials: Interface Mapping Toolkit (IMTK) - Mainframe topic to ensure that your environment is set up properly.
Set Host Access for the Cloud TN3270 options
  1. In Visual Studio, click Tools > Options; then expand Micro Focus Tools and click TN3270 Display.
  2. In the right frame, ensure that Host Access for the Cloud is selected, and then click OK.
  3. Close the Options page.
Start the HACloud Session Server

To start the HACloud session server on Windows:

  1. Ensure you have a 64-bit Java installed and added to the PATH environment variable.
  2. Open the Windows Services Manager.
  3. Click Micro Focus HA Cloud, and click Start the service.
  4. Alternatively, you can execute the following command from a command prompt to start the service: 
    net start mfhacloud

Demonstration application - ACCT

The ACCT demonstration application is the standard example application that IBM supplies with CICS systems. 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 the AC01 transaction. 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.
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. Create and Configure CICSEXT
    Provides instructions for creating the CICSEXT enterprise server region on which to run the existing ACCT application, and to configure the region to eventually run the CICSScreenWS Web service that you create later in this tutorial.
  2. Set Up and Run the ACCT Application
    Walks you through the process of configuring the Host Access for the Cloud TN3270 emulator to run the ACCT application, and then running and interacting with the ACCT application.
  3. Create and Populate the CICSScreenWS Project
    Provides instructions for creating the CICSScreenWS project in Visual Studio, and adding the ACCT application files required to create a CICS screen service interface.
  4. Create the ACCTWS Service Interface
    Guides you through the steps required to create the ACCTWS service interface, which defines a Web service derived from CICS screen source code.
  5. Define ACCTWS Operations
    Guides you through the process of adding the operations that enable the ACCTWS Web service to interact with the ACCT application.
  6. Create and Configure a deploy Directory
    Provides instructions for creating and configuring a deploy directory where ED writes deployed components of the ACCTWS Web service.
  7. Deploy the ACCTWS Service Interface
    Walks you through the process of creating a deployment directory, starting the CICSEXT enterprise server region, and deploying the ACCTWS service interface to Enterprise Server as a Web service.
  8. Generate Console and WPF Clients
    Provides instructions for generating both console and WPF client applications that can be used to access the deployed Web service.
  9. Run the ACCTWSWPFApp and ACCTWSClientApp Clients
    Walks you through the process of using the Visual Studio debugger to run each generated client application and interact with the ACCTWS Web service running on the enterprise server region.
Parent topic: Tutorials: Interface Mapping Toolkit - Mainframe