Skip to content

Commit d9856f3

Browse files
Improve documentation
* Remove references to unused wrappers. * Remove unused SpringBoot references. * Added details on controlling the JVM server in the CICS bundle.
1 parent c0ea6da commit d9856f3

File tree

1 file changed

+19
-29
lines changed

1 file changed

+19
-29
lines changed

README.md

Lines changed: 19 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@ This is a set of sample Eclipse projects for Link to Liberty, demonstrating how
1212
- [etc/eclipse_projects/com.ibm.cics.server.examples.wlp.link.bundle](./etc/eclipse_projects/com.ibm.cics.server.examples.wlp.link.bundle) - CICS bundle project (CICS Explorer)
1313

1414
## Prerequisites
15-
* CICS TS V5.4 or later
15+
* CICS TS V5.5 or later
1616
* Java SE 1.8 or later on the workstation
1717
* Eclipse with the IBM CICS SDK for Java EE, Jakarta EE and Liberty, or any IDE that supports usage of the Maven Central artifact [com.ibm.cics:com.ibm.cics.server.](https://search.maven.org/artifact/com.ibm.cics/com.ibm.cics.server)
18-
* Either Gradle or Apache Maven on the workstation (optional if using Wrappers)
18+
* Either Gradle or Apache Maven on the workstation
1919

2020
## Downloading
2121

@@ -52,17 +52,14 @@ Maven (POM.xml):
5252

5353
## Building
5454

55-
You can build the sample using an IDE of your choice, or you can build it from the command line. For both approaches, using the supplied Gradle or Maven wrapper is the recommended way to get a consistent version of build tooling.
56-
57-
On the command line, you simply swap the Gradle or Maven command for the wrapper equivalent, `gradlew` or `mvnw` respectively.
55+
You can build the sample using an IDE of your choice, or you can build it from the command line. For both approaches, using Gradle or Maven is the recommended way to get a consistent version of build tooling.
5856

59-
For an IDE, taking Eclipse as an example, the plug-ins for Gradle *buildship* and Maven *m2e* will integrate with the "Run As..." capability, allowing you to specify whether you want to build the project with a Wrapper, or a specific version of your chosen build tool.
60-
61-
The required build-tasks are typically `clean bootWar` for Gradle and `clean package` for Maven. Once run, Gradle will generate a WAR file in the `build/libs` directory, while Maven will generate it in the `target` directory.
57+
For an IDE, taking Eclipse as an example, the plug-ins for Gradle *buildship* and Maven *m2e* will integrate with the "Run As..." capability, allowing you to specify a specific version of your chosen build tool.
6258

63-
**Note:** When building a WAR file for deployment to Liberty it is good practice to exclude Tomcat from the final runtime artifact. We demonstrate this in the pom.xml with the *provided* scope, and in build.gradle with the *providedRuntime()* dependency.
59+
The required build-tasks are typically `clean build` for Gradle and `clean package` for Maven. Once run, Gradle will generate a WAR file in the `build/libs` directory, while Maven will generate it in the `target` directory.
6460

65-
**Note:** If you import the project to your IDE, you might experience local project compile errors. To resolve these errors you should run a tooling refresh on that project. For example, in Eclipse: right-click on "Project", select "Gradle -> Refresh Gradle Project", **or** right-click on "Project", select "Maven -> Update Project...".
61+
> [!NOTE]
62+
> If you import the project to your IDE, you might experience local project compile errors. To resolve these errors you should run a tooling refresh on that project. For example, in Eclipse: right-click on "Project", select "Gradle -> Refresh Gradle Project", **or** right-click on "Project", select "Maven -> Update Project...".
6663
6764
> [!TIP]
6865
> In Eclipse, Gradle (buildship) is able to fully refresh and resolve the local classpath even if the project was previously updated by Maven. However, Maven (m2e) does not currently reciprocate that capability. If you previously refreshed the project with Gradle, you'll need to manually remove the 'Project Dependencies' entry on the Java build-path of your Project Properties to avoid duplication errors when performing a Maven Project Update.
@@ -72,41 +69,34 @@ The required build-tasks are typically `clean bootWar` for Gradle and `clean pac
7269
Import the projects into CICS Explorer using File → Import → General → Existing projects into workspace.
7370
> **Note:** If using the egit client, you can just clone the repo and tick the button to import all projects.
7471
75-
### Gradle Wrapper (command line)
72+
### Gradle (command line)
7673

7774
Run the following in a local command prompt:
7875

79-
On Linux or Mac:
80-
8176
```shell
82-
./gradlew clean bootWar
77+
gradle clean build
8378
```
84-
On Windows:
79+
80+
This creates a WAR file inside the `cics-java-liberty-link-app/build/libs` directory and a CICS bundle ZIP file inside the `cics-java-liberty-link-bundle/build/distribution` directory.
81+
82+
The JVM server the CICS bundle is targeted at is controlled through the `jvmserver` property, defined in the [`gradle.properties`](gradle.properties) file, or in the command line:
8583

8684
```shell
87-
gradlew.bat clean bootWar
85+
gradle clean build -Pjvmserver=MYJVMS
8886
```
8987

90-
This creates a WAR file inside the `build/libs` directory.
91-
92-
### Maven Wrapper (command line)
88+
### Maven (command line)
9389

9490

9591
Run the following in a local command prompt:
9692

97-
On Linux or Mac:
98-
9993
```shell
100-
./mvnw clean package
94+
mvn clean package
10195
```
10296

103-
On Windows:
104-
105-
```shell
106-
mvnw.cmd clean package
107-
```
97+
This creates a WAR file inside the `cics-java-liberty-link-app/target` directory and a CICS bundle zIP file inside the `cics-java-liberty-link-bundle/target` directory.
10898

109-
This creates a WAR file inside the `target` directory.
99+
The JVM server the CICS bundle is targeted at is controlled throught the `jvmserver` property, defined in [`cics-java-liberty-link-bundle/pom.xml`](cics-java-liberty-link-bundle/pom.xm) file under the `defaultjvmserver` configuration property.
110100

111101
## Deploying to a Liberty JVM server
112102

@@ -155,4 +145,4 @@ CECI LINK PROG(HELLOWLP) CHANNEL(CHAN)
155145
Alternatively, the enterprise Java program can be run using the provided `WLPH` transaction.
156146

157147
## Find out more
158-
For more information about invoking Java EE applications in a Liberty JVM server from CICS programs, see [Linking to Java applications in a Liberty JVM server by using the @CICSProgram annotation](https://www.ibm.com/docs/en/cics-ts/6.1?topic=djariljs-linking-java-applications-in-liberty-jvm-server-by-using-cicsprogram-annotation).
148+
For more information about invoking Java EE applications in a Liberty JVM server from CICS programs, see [Linking to Java applications in a Liberty JVM server by using the @CICSProgram annotation](https://www.ibm.com/docs/en/cics-ts/latest?topic=djariljs-linking-java-applications-in-liberty-jvm-server-by-using-cicsprogram-annotation).

0 commit comments

Comments
 (0)