Bankdemo Application

This project provides tutorials and demonstrations of features in the Rocket® Enterprise Developer and Rocket® Enterprise Server products. To use these materials, download the assets of the project release that matches the version of the product you will be using. Check and follow the appropriate READMEs for instructions.

Rocket® Enterprise Suite products provide a proprietary runtime engine to enable compatibility for customers’ IBM CICS applications. IBM and CICS are registered trademarks of International Business Machines Corp. Rocket Enterprise Suite products do not include an IBM CICS engine and are not affiliated with IBM.

Contents

1. Introduction
2. License
3. Using The Bankdemo Application
   1. Enterprise Developer Introductory Tutorial
   2. On Premises Enterprise Server Capabilities

Introduction

The Bankdemo application is a simplified mainframe "green screen" banking application which runs under Rocket Enterprise Server. This project provides demonstrations and tutorials of several ways you can configure or modify the application to suit differing requirements which could then be used as a template for running and configuring your own application.

The project demonstrates a selection of the capabilities of Rocket Enterprise Server and these options will be extended over time. It demonstrates applications running on premises and includes introductory tutorials for the use of the Rocket Enterprise Developer for Eclipse and Visual Studio integrated development environments.

In the simplest configuration, it demonstrates an application comprising CICS online and JCL components that access banking data held in indexed (VSAM) files on disk. However, it can also be configured to access data from a PostgreSQL database and database hosted VSAM files using the Rocket Database File Handler. Further demonstrations would be added in the future to show more complex deployments such as scale-out and cloud deployments.

License

Copyright 2010 – 2025 Rocket Software, Inc. or its affiliates. This software may be used, modified, and distributed (provided this notice is included without modification) solely for internal demonstration purposes with other Rocket® products, and is otherwise subject to the EULA at https://www.rocketsoftware.com/company/trust/agreements.

THIS SOFTWARE IS PROVIDED "AS IS" AND ALL IMPLIED WARRANTIES, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, SHALL NOT APPLY. TO THE EXTENT PERMITTED BY LAW, IN NO EVENT WILL ROCKET SOFTWARE HAVE ANY LIABILITY WHATSOEVER IN CONNECTION WITH THIS SOFTWARE.

Using the Bankdemo Application

To use the project, download the source.zip or source.tar.gz from the release that matches the product version you want to use, then follow the relevant readme instructions. You can use the project in one of the following ways:

1. As the basis of the introductory tutorials for the Rocket Enterprise Developer for Eclipse and Visual Studio integrated development environments.

   • Prerequisite software:
     • Rocket Enterprise Developer for Eclipse or Rocket Enterprise Developer for Visual Studio 2022
   • Available tutorials:
     • Getting Started with Enterprise Developer for Eclipse (Windows)
     • Getting Started with Enterprise Developer for Eclipse (Linux)
     • Getting Started with Enterprise Developer for Visual Studio
     • Open PL/I Bankdemo Application in Enterprise Developer for Eclipse
     • Open PL/I Bankdemo Application in Enterprise Development for Visual Studio
   • Requirements:
     • Ensure that the Directory Server (MFDS) service is running
       • Ensure that the Enterprise Server Common Web Administration (ESCWA) service is running and listening on the default localhost port - 10086.

2. Demonstrations of the Rocket Enterprise Server capabilities in "on premises" scenarios:

   • Prerequisite software:
     • Rocket Enterprise Server or Enterprise Developer on Windows or on a supported Linux distribution.
     • Python 3 with the requests and for the PostgreSQL demo psycopg2-binary packages (use the following command to install the packages: python -m pip install requests psycopg2-binary)
     • Check the tutorial or demonstration instruction for any additional requirements
   • Available demonstrations:
     • Deploying and Running Bankdemo with VSAM Data
     • Deploying and Running Bankdemo with PostgreSQL
     • Deploying and Running Bankdemo with VSAM stored in PostgreSQL using MFDBFH
     • Deploying and Running Bankdemo in a Performance and Availability Cluster with PostgreSQL
   • Requirements:
     • Ensure that the Directory Server (mfds) service is running
     • Ensure that the Enterprise Server Common Web Administration (ESCWA) service is running and listening on the default localhost port - 10086.

Use the Issues tab to report issues, or to raise questions.