{"id":45741605,"url":"https://github.com/cicsdev/cics-banking-sample-application-cbsa","last_synced_at":"2026-03-05T12:03:54.444Z","repository":{"id":192095470,"uuid":"520443862","full_name":"cicsdev/cics-banking-sample-application-cbsa","owner":"cicsdev","description":"CICS® banking sample application","archived":false,"fork":false,"pushed_at":"2025-12-19T11:59:04.000Z","size":46716,"stargazers_count":33,"open_issues_count":4,"forks_count":42,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-02-25T16:51:17.415Z","etag":null,"topics":["java","maven-pom","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"COBOL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cicsdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":"MAINTAINERS.md","copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-08-02T10:02:52.000Z","updated_at":"2026-02-18T16:24:03.000Z","dependencies_parsed_at":"2023-09-02T14:44:05.156Z","dependency_job_id":"393a3c19-dd7d-4c64-a8a5-1f5a08063270","html_url":"https://github.com/cicsdev/cics-banking-sample-application-cbsa","commit_stats":null,"previous_names":["cicsdev/cics-banking-sample-application-cbsa"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cicsdev/cics-banking-sample-application-cbsa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicsdev%2Fcics-banking-sample-application-cbsa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicsdev%2Fcics-banking-sample-application-cbsa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicsdev%2Fcics-banking-sample-application-cbsa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicsdev%2Fcics-banking-sample-application-cbsa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cicsdev","download_url":"https://codeload.github.com/cicsdev/cics-banking-sample-application-cbsa/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cicsdev%2Fcics-banking-sample-application-cbsa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30123735,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T11:11:57.947Z","status":"ssl_error","status_checked_at":"2026-03-05T11:11:29.001Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","maven-pom","spring-boot"],"created_at":"2026-02-25T14:53:50.594Z","updated_at":"2026-03-05T12:03:54.438Z","avatar_url":"https://github.com/cicsdev.png","language":"COBOL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cics-banking-sample-application-cbsa\nThe **C**ICS **B**ank **S**ample **A**pplication (CBSA) is an application which simulates the operation of a bank, from the point of view of the Bank Teller. CBSA has multiple uses\nhere are a few examples:\n  - CBSA can be used as a teaching/learning aid, as all source code is provided. It demonstrates how various technologies can be integrated together; CICS, COBOL, BMS, Db2, SQL, Java, Liberty, Spring Boot etc.\n  - CBSA provides an example of a traditionally written CICS application that has been extended over time, and is structured in a way that is recognisable to most CICS TS customers - so\n    it can be used a conversation piece for discussions around the application development lifecycle.\n  - CBSA can be used straight out of the box for testing purposes. For example: the testing of CICS interactions, or for testing verification/validation/interaction of IBM and vendor tool offerings.\n  - CBSA can be used as the building block for application modernisation conversations.\n\n\n## Table of Contents\n\n- [About](#about)\n- [Architecture](#architecture)\n- [Requirements](#requirements)\n- [Downloading](#downloading)\n- [Installing](#installing)\n- [Usage](#usage)\n- [Contributors](#contributors)\n\n## About\nThere are multiple different interfaces exploiting a range of different underlying technologies.\n\nThe first interface is the **base COBOL (BMS) interface**:\n\u003e![Main Menu](./doc/images/Architecture/Baseinstall_CBSA_MAIN_MENU.jpg)\n\u003c/br\u003e\n\nThe second interface is the **Carbon React UI interface**:\n\u003e ![Carbon React Main Menu](./doc/images/Architecture/CarbonReactUI_MainMenu.png)\n\u003c/br\u003e\n\nThe third interface is the **Customer Services interface**:\n\u003e ![CS Landing Page](./doc/images/Architecture/Landing_Page_Small.jpg)\n\u003c/br\u003e\n\nThe fourth interface is the **Payment interface**:\n\u003e ![Payment Landing Page](./doc/images/Architecture/Payment_Landing_page_small.jpg)\n\u003c/br\u003e\n\nThere is also a **RESTful API** please refer to the [CBSA RESTful API Guide](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/usage/springBoot/doc/CBSA_Restful_API_guide.md) for more detailed information.\n\u003c/br\u003e\n\nThe interfaces are designed to exploit the underlying banking functionality, which includes functions to:\n\u003e - Pay money in\n\u003e - Take money out\n\u003e - Transfer funds\n\u003e - Open new accounts etc. etc.\n\n## Architecture\n![Payment and CS architecture diagram2](./doc/images/Architecture/Payment_and_Customer_Services_UI_CBSA_architecture_diagram2.jpg)\n\n\u003e Please refer to the [Architecture documentation](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/doc/CBSA_Architecture_guide.md) for more detailed information.\n\n## Requirements\n- An existing CICS TS region running at V6.1 with APAR PH60795 applied, or later\n- A Db2 subsystem (V12 or later)\n- A Liberty JVM server in CICS (set up and configured during the installation process) for the Carbon React UI and Spring Boot interfaces\n- Java 17\n- Yarn to build the web front-end\n- Various VSAM files (set up and configured during the installation process)\n- A z/OS Connect server (if the RESTful API or the Customer Services or Payment interfaces are required)\n- A Maven wrapper is used to build the Java components. This is included for your convenience.\n\n\n\n## Downloading\n- Clone the repository using your IDEs support, such as the Eclipse Git plugin\n- **or**, download the sample as a [ZIP] from the release page and then follow the installation instructions (see Installing).\n\n\u003e*Tip: Eclipse Git provides an 'Import existing Projects' check-box when cloning a repository.*\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes.\n\n## Installing\nInstallation instructions:\n\u003c/br\u003e\n\nInstallation of CBSA is split into 3 parts :\n  1. The base COBOL(BMS) installation, this is mandatory and should be installed first. See the [base COBOL installation documentation.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/install/base/doc/README.md)\n  2. The Carbon React UI installation, this is optional, requires a JVM server to be running in the CICS region (this gets set up as part of installation process). See [the Carbon React UI installation documentation.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/install/carbonReactUI/doc/CBSA_Carbon_React_UI_installation_deployment_guide.md)\n  3. The Customer Service and Payment interface installation (also optional). See [deploying the Payment and Customer Services documentation.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/install/springBootUI/doc/CBSA_Deploying_the_Payment_Customer_Services_Springboot_apps.md)\n\n## Usage\nVarious user guides are provided:\n\n  1. For the base/COBOL(BMS) interface please refer to the [CBSA BMS User Guide.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/usage/base/doc/CBSA_BMS_User_Guide.md)\n  2. For the Carbon React UI please refer to the [CBSA Carbon React UI User Guide.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/usage/libertyUI/doc/CBSA_Liberty_UI_User_Guide.md)\n  3. For the Customer Services interface please refer to the [CBSA Customer Service User Interface User Guide.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/usage/springBoot/doc/CBSA_Customer_Services_Interface_User_Guide.md)\n  4. For the Payment interface please refer to the [CBSA Payment Interface User Guide.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/usage/springBoot/doc/CBSA_Payment_Interface_User_Guide.md)\n  5. For the RESTful API guide please refer to the [CBSA RESTful Api Guide.](https://github.com/cicsdev/cics-banking-sample-application-cbsa/tree/main/etc/usage/springBoot/doc/CBSA_Restful_API_guide.md)\n\n\n## Contributors\n \u003e Jon Collett - JonCollettIBM\n \u003e\n \u003e James O'Grady - JAMOGRAD\n \u003e\n \u003e Tom Slattery - Tom-Slattery\n \u003e\n \u003e Christopher Clash - ChristopherClash\n\n## License\nThis project is licensed under [Eclipse Public License - v 2.0](LICENSE).\n\n## Usage terms\nBy downloading, installing, and/or using this sample, you acknowledge that separate license terms may apply to any dependencies that might be required as part of the installation and/or execution and/or automated build of the sample, including the following IBM license terms for relevant IBM components:\n\n- IBM CICS development components terms: https://www.ibm.com/support/customer/csol/terms/?id=L-ACRR-BBZLGX\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcicsdev%2Fcics-banking-sample-application-cbsa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcicsdev%2Fcics-banking-sample-application-cbsa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcicsdev%2Fcics-banking-sample-application-cbsa/lists"}