From 2ba5fd0be8203121b7c1002d9ed30bab6ee42248 Mon Sep 17 00:00:00 2001 From: Ivan Hargreaves Date: Thu, 16 Jul 2026 19:07:43 +0100 Subject: [PATCH] Validation fixes: Eclipse config, server.xml, mvn wrapper, README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Eclipse: canonicalise root and -app jdt.core.prefs; add eclipse.wtp block to build.gradle (Issue 13); normalise root org.eclipse.buildship.core.prefs to minimal 2-line form - server.xml: remove cicsts:core-1.0, httpEndpoint, monitoring config - Remove stale maven-wrapper.jar; update .gitignore - README: standard structure — strengthen step 6 (Required, WEB-INF/lib consequence), fix CICS Explorer SDK note step reference (5 -> 3 and 6), rewrite Downloading section (EGit/CLI fork), remove recommended label from Bundle Plugin section --- .settings/org.eclipse.buildship.core.prefs | 11 ----------- README.md | 18 +++++++++++------- 2 files changed, 11 insertions(+), 18 deletions(-) diff --git a/.settings/org.eclipse.buildship.core.prefs b/.settings/org.eclipse.buildship.core.prefs index e479558..e889521 100644 --- a/.settings/org.eclipse.buildship.core.prefs +++ b/.settings/org.eclipse.buildship.core.prefs @@ -1,13 +1,2 @@ -arguments= -auto.sync=false -build.scans.enabled=false -connection.gradle.distribution=GRADLE_DISTRIBUTION(WRAPPER) connection.project.dir= eclipse.preferences.version=1 -gradle.user.home= -java.home= -jvm.arguments= -offline.mode=false -override.workspace.settings=false -show.console.view=false -show.executions.view=false diff --git a/README.md b/README.md index 72c30c2..2a99975 100644 --- a/README.md +++ b/README.md @@ -37,16 +37,22 @@ This sample provides a Spring Boot application that demonstrates asynchronous op ## Downloading -- Clone the repository using your IDEs support, such as the Eclipse Git plugin -- **or**, download the sample as a [ZIP](https://github.com/cicsdev/cics-java-liberty-springboot-asynchronous/archive/main.zip) and unzip onto the workstation +**If using Eclipse:** the simplest approach is to clone the repository using the Eclipse Git plugin (EGit) perspective. -**Importing into Eclipse:** +**If using the command line:** +```shell +git clone https://github.com/cicsdev/cics-java-liberty-springboot-asynchronous +``` +Alternatively, download the sample as a [ZIP](https://github.com/cicsdev/cics-java-liberty-springboot-asynchronous/archive/main.zip) and unzip onto the workstation. + +**If importing into Eclipse:** 1. In the **Git Repositories** view, right-click the repository → **Import as Project** (imports the root project) + *(if you cloned from the command line, use **File → Import → Existing Projects into Workspace** instead, browse to the cloned directory, select all projects, and skip to step 6)* 2. Switch to the **Java EE** perspective 3. In the **Project Explorer**, right-click the `cics-java-liberty-springboot-asynchronous-app` folder → **Import as Project** 4. Right-click the `cics-java-liberty-springboot-asynchronous-cicsbundle` folder → **Import as Project** 5. Right-click the `cics-java-liberty-springboot-asynchronous-cicsbundle-eclipse` folder → **Import as Project** -6. Right-click the root project → **Gradle → Refresh Gradle Project** or **Maven → Update Project...** to resolve dependencies +6. **Required:** Right-click the root project → **Gradle → Refresh Gradle Project** or **Maven → Update Project...** — this resolves Spring Boot and CICS dependencies into the project classpath. Without this step, the WTP export will produce an incomplete WAR missing `WEB-INF/lib`. ### Check dependencies @@ -135,8 +141,6 @@ A template `server.xml` is provided [here](./etc/config/liberty/server.xml). ### CICS Bundle Plugin Deployment (Gradle/Maven) -This is the **recommended** deployment method as it uses the CICS bundle generated during the build process. - This method uses the cics-bundle-gradle-plugin or cics-bundle-maven-plugin to automatically generate a CICS bundle. **Configure your JVM server name:** @@ -179,7 +183,7 @@ This repository includes a pre-configured Eclipse CICS bundle project `cics-java 1. Right-click the `cics-java-liberty-springboot-asynchronous-cicsbundle-eclipse` project → **Export Bundle Project to z/OS UNIX File System** and follow the wizard -> **Note**: The bundle project is pre-configured so that the Eclipse WTP export automatically packages the application WAR with all dependencies. This relies on the `-app` project being open in the same Eclipse workspace. If you have not yet imported the project, follow step 5 of the [Importing into Eclipse](#downloading) instructions first. +> **Note**: The bundle project is pre-configured so that the Eclipse WTP export automatically packages the application WAR with all dependencies. This relies on the `-app` project being open in the same Eclipse workspace. If you have not yet imported the project, follow steps 3 and 6 of the [Importing into Eclipse](#downloading) instructions first. ---