Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
# cics-java-osgi-jdbc
[![Build](https://github.com/cicsdev/cics-java-osgi-jdbc/actions/workflows/java.yaml/badge.svg?branch=cicsts/v5.5)](https://github.com/cicsdev/cics-java-osgi-jdbc/actions/workflows/java.yaml)

This sample demonstrates how to code, build, and deploy a CICS Java OSGi application that makes JDBC calls to Db2. It makes use of the employee sample table supplied with Db2 for z/OS, and allows you to display employee information from the table EMP.

Expand Down Expand Up @@ -125,7 +124,6 @@ DB2CONN=YES
...
// DD DISP=SHR,DSN=SYS2.DB2.&DB2..SDSNLOAD
// DD DISP=SHR,DSN=SYS2.DB2.&DB2..SDSNLOD2
// DD DISP=SHR,DSN=DSN&DB2.P2.RUNLIB.LOAD
```

### Configure the JVM Profile
Expand All @@ -149,7 +147,7 @@ Ensure a CICS DB2CONN is installed and connected.
CEDA DEFINE DB2CONN(JODBCONN) GROUP(CDEVJODB)
```
```
CEDA INSTALL DB2CONN(CDEVJODB) GROUP(CDEVJODB)
CEDA INSTALL DB2CONN(JODBCONN) GROUP(CDEVJODB)
```

### Option 2 - Configure the DB2CONN with CICS Explorer
Expand All @@ -164,6 +162,8 @@ CEDA INSTALL DB2CONN(CDEVJODB) GROUP(CDEVJODB)
---

## Deploying to CICS
CICS resource definitions for the bundle, programs, transactions and a JVM server are supplied in a group CDEVJODB as a DFHCSDUP sample input stream supplied in [`DFHCSD.txt`](etc/DFHCSD.txt). Alternatively they can be installed using the bundle parts supplied with the cics-java-osgi-jdbc-bundle project.

### Option 1 - Deploying using CICS Explorer SDK and the provided CICS bundle project
1. Deploy the CICS bundle project 'com.ibm.cics.server.examples.osgi.jdbc.bundle' from CICS Explorer using the **Export Bundle Project to z/OS UNIX File System** wizard. This CICS bundle includes the osgi bundlepart, the JODB transaction and the CDEVJODB program to run the sample.

Expand Down Expand Up @@ -241,7 +241,7 @@ JODB
The actual contents will be based on the values in the `EMP` table in the database.

## License
This project is licensed under [Apache License Version 2.0](LICENSE).
This project is licensed under [Eclipse Public License - v 2.0](LICENSE).

## Usage terms
By 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:
Expand Down
22 changes: 22 additions & 0 deletions etc/DFHCSD.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
DELETE GROUP(CDEVJODB)

DEFINE JVMSERVER(DFHOSGI) GROUP(CDEVJODB)
DESCRIPTION(Example JVM server definition)
JVMPROFILE(DFHOSGI)

DEFINE DB2CONN(JODBCONN) GROUP(CDEVJODB)
DB2ID(DBID)

DEFINE PROGRAM(CDEVJODB) GROUP(CDEVJODB)
JVM(YES) JVMCLASS(com.ibm.cicsdev.java.osgi.jdbc.cicsmainclass.*
JDBCQueryProgram)
JVMSERVER(DFHOSGI)
CONCURRENCY(REQUIRED)
EXECKEY(CICS)

DEFINE TRANSACTION(JODB) GROUP(CDEVJODB)
PROGRAM(CDEVJODB)

DEFINE BUNDLE(CDEVJODB) GROUP(CDEVJODB)
DESCRIPTION(CICS OSGi Java JDBC samples)
BUNDLEDIR(/u/cics/cics-java-osgi-jdbc-bundle-1.0.0)
Loading