This sample application simulates a fictitious bank (Cedar Bank) and demonstrates the major features of the .NET Framework and COMTI by retrieving customer account information using mainframe COBOL transactions by way of CICS or IMS. It also shows you how to call a COMTI Automation server from Web-based or other COM-based client applications. This sample application requires a live connection to a mainframe host environment. This sample application demonstrates:
The Cedar Bank sample application includes everything to put COMTI and Visual Studio .NET to work for you. Included are the following:
The following figure shows how COMTI is integrated with the .NET runtime environment, including interfaces to the mainframe environment.
.NET Runtime COMTI integration
The sample Automation client application uses the methods of a COMTI Automation server to run COBOL-based mainframe TPs. The sample Automation client sends parameters to and receives results from each TP by calling the methods of a COMTI Automation server (a COMTI component deployed in a COM+ application or MTS package) by way of the COMTI run-time environment.
The COMTI Automation server's interface contains two methods (getbal, and getaccts) that any COM-based client application (the Automation client) can call to retrieve bank account information using mainframe COBOL transactions by way of CICS or IMS.
The following diagram shows the connections between a .NET Windows client application, the .NET Runtime, and the COMTI methods, which then call the mainframe transaction programs.
Direct client to .NET Runtime to COMTI to mainframe
The following diagram shows the connections between either a browser or a Windows client application, the .NET Server Web Service, the .NET Runtime, and the COMTI methods, which then call the mainframe transaction programs.
Connecting the Web to the mainframe
The Cedar Bank sample application is designed to use host mainframe connectivity over TCP/IP or SNA (APPC/LU 6.2). COBOL source code is supplied to run COMTI over a live mainframe connection. Use this COBOL source code to create GETBAL and GETACCTS mainframe TPs, and then install them in CICS or IMS on your mainframe. See the "Running Cedar Bank with a Live Mainframe Connection" topic later in this chapter.
Note This sample application is based on the Cedar Bank Sample application that is installed with Host Integration Server 2000. The Cedar Bank sample application has been modified for the .NET Framework and requires not only Microsoft Host Integration Server 2000, but also Microsoft Visual Studio .NET as discussed later in this chapter.
The Cedar Bank Sample application supplied with Host Integration Server 2000 is programmed using Visual Studio version 6.0. The Host Integration Server 2000 documentation has complete information for the Cedar Bank sample application.