|
1 | 1 | # cics-java-liberty-link |
2 | | -Samples for Link to Liberty |
| 2 | +Sample CICS Java program showing use of the com.ibm.cics.server.invocation.CICSProgram annotation for Link to Liberty |
3 | 3 |
|
4 | 4 | ## Contents |
5 | | -This is a set of sample projects for Link to Liberty, demonstrating how you can invoke a POJO packaged in a WAR in a Liberty JVM server from a CICS program. |
| 5 | +This is a set of sample Eclipse projects for Link to Liberty, demonstrating how you can annotate a POJO packaged in a WAR in a Liberty JVM server, to allow it be called from a CICS program. |
6 | 6 |
|
7 | 7 | - projects/com.ibm.cics.server.examples.wlp.link - Web project |
8 | 8 | - projects/com.ibm.cics.server.examples.wlp.link.bundle - CICS bundle project |
9 | 9 |
|
| 10 | +## Prerequisites |
| 11 | +- CICS TS V5.3 (or later) with APAR PI63005 |
| 12 | +- A configured Liberty JVM server |
| 13 | +- Java SE 1.7 or later on the z/OS system |
| 14 | +- Java SE 1.7 or later on the workstation |
| 15 | +- CICS Explorer with CICS SDK for Servlet and JSP support |
| 16 | + |
10 | 17 | ## Deploying the sample |
11 | 18 | 1. Import the projects into CICS Explorer using File -> Import -> General -> Existing projects into workspace. |
12 | 19 | - If using the egit client, you can just clone the repo and tick the button to import all projects. |
13 | | -2. Change the name of the JVMSERVER in the .warbundle file to a suitable value for your installation. |
| 20 | +2. Change the name of the JVMSERVER in the .warbundle file from DFHWLP to the name of the JVMSERVER resource defined in CICS. |
14 | 21 | 3. Export the bundle project to zFS by selecting 'Export Bundle project to z/OS Unix File System' from the contxt menu. |
15 | 22 | 4. Ensure the `cicsts:link-1.0` feature is present in server.xml and the JVMSERVER is ENABLED. |
16 | | -5. Create a bundle defintion pointing to the zFS location you just exported to, and install it. |
17 | | -6. Check for the dynamically created PROGRAM resource HELLOWLP. |
| 23 | +5. Create a bundle defintion, setting the bundle directory attribute to the zFS location you just exported to, and install it. |
| 24 | +6. Check the CICS region for the dynamically created PROGRAM resource HELLOWLP using the PROGRAMS view in CICS Explorer, or the CEMT INQUIRE PROGRAM commandl. |
18 | 25 |
|
19 | 26 | ## Trying out the sample |
20 | 27 | You can use CECI to invoke the sample program: |
|
0 commit comments