Skip to content

Commit 95001d4

Browse files
committed
main readme update
1 parent a719b0c commit 95001d4

File tree

1 file changed

+0
-47
lines changed

1 file changed

+0
-47
lines changed

README.md

Lines changed: 0 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -21,53 +21,6 @@ to DB2 by obtaining a DataSource via a JNDI lookup and returns the current times
2121
| 5.5, 5.6 | [cicsts/v5.5](/../../tree/cicsts/v5.5) | 8 | [![Build](https://github.com/cicsdev/cics-java-liberty-jdbc/actions/workflows/java.yaml/badge.svg?branch=cicsts%2Fv5.5)](https://github.com/cicsdev/cics-java-liberty-jdbc/actions/workflows/java.yaml) |
2222
| 6.1 | [cicsts/v6.1](/../../tree/cicsts/v6.1) | 8 | [![Build](https://github.com/cicsdev/cics-java-liberty-jdbc/actions/workflows/java.yaml/badge.svg?branch=cicsts%2Fv6.1)](https://github.com/cicsdev/cics-java-liberty-jdbc/actions/workflows/java.yaml) |
2323

24-
## Pre-requisites
25-
* CICS TS V5.3 with APAR PI77502 or CICS TS V5.4
26-
* Java SE 7 or later on the z/OS system
27-
* CICS Explorer V5.4 with the IBM CICS SDK for Java EE and Liberty feature installed [available here](https://developer.ibm.com/mainframe/products/downloads)
28-
* IBM Db2 for z/OS
29-
30-
## Configuration
31-
The sample code can be deployed as a WAR file into a CICS Liberty JVM server. CICS Liberty can be configured to use either a local DB2 database with
32-
JDBC type 2 connectivity, or a remote database with a JDBC type 4 connectivity. The SimpleJDBCServlet servlet can then be used to display the current
33-
timestamp from DB2
34-
35-
### To import the samples into Eclipse
36-
1. Import the projects into CICS Explorer using **File -> Import -> General -> Existing projects into workspace**
37-
1. Resolve the build path errors on the Dynamic web project using the following menu from the web project: **Build Path -> Configure Build Path -> Libraries -> Add Library -> CICS with Java EE and Liberty** and select the version of CICS TS for deployment (either CICS TS V5.3 or CICS TS V5.4)
38-
39-
### To configure CICS for JDBC type 2 connectivity to DB2
40-
1. Create a Liberty JVM server as described in [4 easy steps](https://developer.ibm.com/cics/2015/06/04/starting-a-cics-liberty-jvm-server-in-4-easy-steps/)
41-
1. Update the CICS STEPLIB with the DB2 SDSNLOAD and SDSNLOD2 libraries
42-
1. Configure CICS DB2CONN, DB2TRAN and DB2ENTRY resource definitions as described in [How you can define the CICS DB2 connection](https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.4.0/configuring/databases/dfhtk2c.html)
43-
1. Bind the DB2 plan that is specified in the CICS DB2CONN or DB2ENTRY definition with a PKLIST of NULLID.*
44-
1. Add the following properties in the JVM profile to set the location of the DB2 drivers to allow CICS to automatically configure the default DataSource
45-
46-
```
47-
-Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true
48-
-Dcom.ibm.cics.jvmserver.wlp.jdbc.driver.location=/usr/lpp/db2v12/jdbc
49-
```
50-
Where ```/usr/lpp/db2v12/jdbc``` is the location of the DB2 JDBC driver
51-
52-
An example Liberty server configuration of a DataSource with a type 2 connection is supplied in [etc/config/type-2-server.xml](etc/config/type-2-server.xml). Configuration with DataSource and a type 4 connection is in [etc/config/type-4-server.xml](etc/config/type-4-server.xml)
53-
54-
### To deploy the sample into a CICS region
55-
1. Change the name of the JVMSERVER in the .warbundle file from DFHWLP to the name of the JVMSERVER resource defined in CICS.
56-
1. Using the CICS Explorer export the ```com.ibm.cicsdev.jdbc.web.cicsbundle``` project to a zFS directory.
57-
1. Define and install a CICS BUNDLE resource definition referring to the deployed bundle directory on zFS in step 2, and ensure all resources are enabled.
58-
59-
## Running the sample
60-
* The servlet is accessed with the following URL:
61-
[http://host:port/com.ibm.cicsdev.jdbc.web/](http://host:port/com.ibm.cicsdev.jdbc.web/)
62-
63-
If the test is successful, you will see a response similar to the following written to the browser:
64-
65-
`SimpleJDBCServlet: DB2 CurrentTimeStamp = 2017-08-02 11:28:46.18055`
66-
67-
## Reference
68-
* Sample SQLJ Git repository [cics-java-liberty-sqlj](https://github.com/cicsdev/cics-java-liberty-sqlj)
69-
* CICS Knowledge Center [Configuring a Liberty JVM server](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.4.0/configuring/java/config_jvmserver_liberty.html)
70-
* CICS Knowledge Center [Configuring a JVM server to support DB2](https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.4.0/applications/developing/database/dfhtk4b.html)
7124

7225
## License
7326
This project is licensed under [Apache License Version 2.0](LICENSE).

0 commit comments

Comments
 (0)