Skip to content

Commit 23469c2

Browse files
authored
Update link to CICS TS V5.5
Update link from CICS TS V5.3 to V5.5, and minor editing.
1 parent a3ab1bc commit 23469c2

File tree

1 file changed

+8
-15
lines changed

1 file changed

+8
-15
lines changed

README.md

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
cics-java-jcics-samples
2-
================
3-
Sample CICS Java programs demonstrating how to use the JCICS API in an OSGi JVM server environment
1+
# cics-java-jcics-samples
2+
3+
Sample CICS Java programs demonstrating how to use the JCICS API in an OSGi JVM server environment.
44

55
## Samples overview
66

@@ -11,50 +11,43 @@ Sample CICS Java programs demonstrating how to use the JCICS API in an OSGi JVM
1111
* [`com.ibm.cicsdev.tsq`](projects/com.ibm.cicsdev.tsq) - Accessing temporary storage queues.
1212
* [`com.ibm.cicsdev.vsam`](projects/com.ibm.cicsdev.vsam) - Accessing KSDS, ESDS, and RRDS VSAM files.
1313

14-
1514
## Repository structure
1615

1716
* [`etc/`](etc) - Supporting materials used to define CICS and z/OS resources needed for the samples.
1817
* [`projects/`](projects) - Complete Eclipse projects suitable for importing into a CICS Explorer environment.
1918
* [`src/`](src) - Supporting source code for non-Java programs.
2019

21-
2220
## Pre-requisites
2321

2422
* CICS TS V5.1 or later, due to the usage of the `getString()` methods.
2523
* Java SE 7 or later on the z/OS system.
2624
* Java SE 7 or later on the workstation.
2725
* Eclipse with CICS Explorer SDK installed.
2826

29-
3027
## Configuration
3128

3229
The sample Java classes are designed to be added to an OSGi bundle and deployed into a CICS OSGi JVM server, but can also be used as the basis for extending Web applications deployed into a Liberty JVM server.
3330

34-
3531
### Starting a JVM server in CICS
3632

3733
1. Enable Java support in the CICS region by adding the `SDFJAUTH` library to the `STEPLIB` concatenation and setting `USSHOME` and the `JVMPROFILE` SIT parameters.
3834
1. Define an OSGi JVM server called `DFHJVMS` using the CICS-supplied sample definition in the CSD group `DFH$OSGI`.
3935
1. Copy the CICS supplied `DFHOSGI.jvmprofile` zFS file to the zFS directory specified by the `JVMPROFILE` SIT parameter, and ensure the `JAVA_HOME` variable is set correctly.
4036
1. Install the `DFHJVMS` resource defined in step 2 and ensure it becomes enabled.
4137

42-
4338
### To deploy the samples into a CICS region
39+
4440
1. Using the CICS Explorer export the `com.ibm.cicsdev.*.cicsbundle` projects to a zFS directory. The sample definitions use the following style of zFS location `/u/cics1/com.ibm.cicsdev.link.cicsbundle_1.0.0`.
4541
1. Define and install CICS `BUNDLE` resource defintions referring to the deployed bundle directory in step 1, and ensure all resources are enabled.
4642
1. Create the required transaction and program definitions using either the supplied `DFHCSD.txt` files as input to a CSD define job, or using the supplied CICS bundle projects.
4743
1. See the individual project directories for any additional supporting resources required.
4844

49-
5045
## License
51-
This project is licensed under [Apache License Version 2.0](LICENSE).
5246

47+
This project is licensed under [Apache License Version 2.0](LICENSE).
5348

5449
## Reference
5550

56-
* For further details on the JCICS APIs used in this sample refer to this [developer center article](https://developer.ibm.com/cics/2017/02/27/jcics-the-java-api-for-cics/)
57-
* For further details on using the IBM JZOS record generator see this [developer center article](https://developer.ibm.com/cics/2016/05/12/java-cics-using-ibmjzos/)
58-
* For details on how to define a CICS OSGi JVM server refer to the Knowledge Center topic [Configuring an OSGi JVM server](http://www.ibm.com/support/knowledgecenter/SSGMCP_5.3.0/com.ibm.cics.ts.java.doc/JVMserver/config_jvmserver_app.html)
59-
60-
51+
* For further details on the JCICS APIs used in this sample refer to this [developer center article](https://developer.ibm.com/cics/2017/02/27/jcics-the-java-api-for-cics/).
52+
* For further details on using the IBM JZOS record generator see this [developer center article](https://developer.ibm.com/cics/2016/05/12/java-cics-using-ibmjzos/).
53+
* For details on how to define a CICS OSGi JVM server refer to the Knowledge Center topic [Configuring an OSGi JVM server](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/configuring/java/config_jvmserver_app.html).

0 commit comments

Comments
 (0)