Skip to content

Commit

Permalink
Update readme.html (#224)
Browse files Browse the repository at this point in the history 
Signed-off-by: John Eberhard <102746950+jeber-ibm@users.noreply.github.com>
  • Loading branch information
@jeber-ibm
jeber-ibm authored Dec 10, 2024
1 parent b1dd01c commit 0c29a26
Showing 1 changed file with 26 additions and 109 deletions.
135 changes: 26 additions & 109 deletions readme.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,17 @@
<BODY>
<H2>IBM Toolbox for Java - JTOpen Version</H2>
<PRE>
Copyright (C) 1997-2017 International Business Machines Corporation and
Copyright (C) 1997-2024 International Business Machines Corporation and
others. All rights reserved.

File: README
Last updated: 2017-01-12
Last updated: 2024-12-10

The term "JTOpen" refers to the open source software product "IBM Toolbox for Java"
plus any additional Enhancements provided by the open source community.
JTOpen, which is governed by the <A HREF="http://www.opensource.org/licenses/ibmpl.php">IBM Public License</A>, as well as its Java source code,
is contained in the open source repository located off of:
<A HREF="http://jt400.sourceforge.net/">http://jt400.sourceforge.net/</A>
<A HREF="https://github.com/IBM/JTOpen">https://github.com/IBM/JTOpen</A>

The terms "Toolbox" and "Toolbox LPP" refer to the IBM Licensed Program Product
"IBM Toolbox for Java", which is supported by IBM and can be obtained from the
Expand Down Expand Up @@ -49,7 +49,7 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>
OS/400 Java Virtual Machine.

The Toolbox is available as an installable licensed program for the iSeries
as of OS/400 V5R1. Here is a breakdown of the supported
as of OS/400 V7R5. Here is a breakdown of the supported
Toolbox releases versus operating system versions:

Toolbox Installs on Connects to
Expand All @@ -61,7 +61,7 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>
JTOpen 9.0+ 5770SS1 V7R3M0 V7R1 and up V7R1 and up
JTOpen 10.0+ 5770SS1 V7R4M0 V7R2 and up V7R2 and up
JTOpen 11.0+ 5770SS1 V7R5M0 V7R3 and up V7R3 and up

JTOpen 20.0+ 5770SS1 V7R5M0 V7R3 and up V7R3 and up

Note: As of IBM i 7.1 (V7R1), the "JC1" product is no longer shipped.
The Toolbox LPP is available under product 5770SS1 Option 3.
Expand Down Expand Up @@ -91,9 +91,7 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>

1. The initial release of the source code for JTOpen used the V4R5
Toolbox codebase. That is, the Java code in the open source repository
is the same code that was used to build the V4R5 Toolbox LPP. JTOpen 2.0x
uses the V5R1 Toolbox as its codebase. The latest release of JTOpen
(JTOpen 7.x) uses the V7R1 Toolbox as its codebase.
is the same code that was used to build the V4R5 Toolbox LPP.

2. When bugs are reported, fixes will be committed to JTOpen as soon as
they are realized. When applicable, these same fixes will be committed
Expand All @@ -110,7 +108,7 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>
4. In general, the Toolbox LPP is supported directly by IBM. JTOpen
is supported by the JTOpen user community, in which IBM participates
and contributes, specifically through developer email, the JTOpen
mailing list, and the <A HREF="https://www.ibm.com/mysupport/s/forumsquestion?language=en_US&id=0D50z000060GKjGCAW">JTOpen Web forum</A>
mailing list, and <A HREF="https://github.com/IBM/JTOpen/issues">JTOpen github issues</A>

5. Pursuant to the <A HREF="http://www.opensource.org/licenses/ibmpl.php">IBM Public License</A>, programmers are free to alter the
JTOpen source code and to distribute it with their own applications.
Expand All @@ -120,14 +118,14 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>
<A NAME="req"><H4><U>Requirements</U></H4></A>
Briefly, the requirements for using the JTOpen code are as follows:

1. A Java Virtual Machine (JVM) with a 1.4.x or higher JDK/JRE. The JTOpen
1. A Java Virtual Machine (JVM) with a 1.7.x or higher JDK/JRE. The JTOpen
team highly recommends moving to the latest supported release of the JDK/JRE, as
maintaining backwards-compatible code with older releases becomes
increasingly difficult to support over time.

2. Almost all JTOpen functions require a TCP/IP connection to an IBM i server.

a. The server must be IBM i, i5/OS, or OS/400 V4R3 or higher.
a. The server must be IBM i, i5/OS, or OS/400 V7R3 or higher.

b. The server must have the Option 12 Host Servers installed and
running. JTOpen uses the host servers as TCP/IP endpoints to
Expand All @@ -139,82 +137,32 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>
This will only occur under certain conditions, and only if the file
jt400Native.jar is included in the application's CLASSPATH.

3. For GUI programming, either Java 2 or Swing 1.1 or higher is required.

<A NAME="files"><H4><U>Files</U></H4></A>
JTOpen is comprised of the following files:

Jar file Contents
-------- --------

jtopen_x_x_source.zip This is a zip file of all the source files in the repository.
It is not a Java jar file.

jtopen_x_x_javadoc.zip This is a zip file of the javadoc (in HTML format) for
the JTOpen source files. It is not a Java jar file.
jt400-_._._-sources.jar This is a zip file of all the source files in the repository.
It is not a Java jar file.

jt400.jar(*) This is the main JTOpen jar file. It contains almost all open
source code (except for the few Toolbox classes that could
not be open-sourced), including the utilities package,
and the JDBC driver (JDBC 3.0).

jt400android.jar(*) This is the main JTOpen jar file, compiled for use on
android. Some Java features that are not supported
on android are disabled.

java6/jt400.jar(*) This is the main JTOpen jar file compiled for Java 6.
A Java 6 JVM is required to use this class.

java8/jt400.jar(*) This is the main JTOpen jar file compiled for Java 8.
A Java 8 JVM is required to use this class.

java9/jt400.jar(*) This is the main JTOpen jar file compiled for Java 9.
A Java 9 JVM is required to use this class.
jt400-_._._-javadoc.jar This is a zip file of the javadoc (in HTML format) for
the JTOpen source files. It is not a Java jar file.

jtopenlite.jar(*) This contains the JTOpenLite classes, optimized for
small devices.
jt400-_._._.jar This is the main JTOpen jar file. It contains almost all open
source code (except for the few Toolbox classes that could
not be open-sourced), including the utilities package,
and the JDBC driver.
j400-_._._-java8.jar This is the main JTOpen jar file compiled for Java 8.
A Java 8 JVM is required to use this class.

jt400Micro.jar(*) This contains the deprecated ToolboxME (Micro Edition)
classes for use on a handheld device. This will be
removed in a future JTOpen release.

jt400Native.jar Previously known as jt400Access.zip, this jar does not
contain the vaccess package. It does contain the native
optimization classes necessary for running performance-enhanced
applications on IBM i, i5/OS, or OS/400 JVM. This is shipped
via PTF on the IBM i.

jt400Proxy.jar(*) This jar contains just the classes needed to run a client
application using the Toolbox proxy server. It is
especially useful in environments where a smaller jar
is needed.

jt400Servlet.jar(*) This jar contains the html and servlet packages.

jui400.jar(*) Contains the PDML runtime packages as provided by
the Graphical Toolbox.

uitools.jar(*) Contains the GUI Builder packages as provided by the
Graphical Toolbox.

util400.jar(*) Contains various utilities.

composer.jar(*) Contains XSL stylesheet composer classes.
jt400-_._._-java11.jar This is the main JTOpen jar file compiled for Java 11.
A Java 11 JVM is required to use this class.

reportwriter.jar(*) Contains XSL report processor classes.

outputwriters.jar(*) Contains PDF, PCL, and font classes.

tes.jar(*) Contains the IBM i Graphical Debugger.



(*) Files contained in file jtopen_x_x.zip.

There are additional jar files shipped in the download for JTOpen off of the Toolbox
downloads page. Those jar files do not contain JTOpen code. They are
provided as a convenience to the developer and to mirror the objects that ship
with the Toolbox LPP.
jt400-_._._-native.jar Jar file containing the native optimization classes necessary
for running performance-enhanced applications on IBM i, i5/OS, or
OS/400 JVM.

<!--
As of JTOpen 3.3, MD5 checksums are provided to verify download integrity.
Expand All @@ -225,50 +173,19 @@ <H2>IBM Toolbox for Java - JTOpen Version</H2>
2. Add it to your CLASSPATH.
3. Run your application.

Instructions for building all or part of the JTOpen source code:
<i>Note: Complete build instructions are specified in the commentary in file
/build/build.xml</i>
1. Download the JTOpen jt400.jar.
2. Download any source files you want to change. The src.zip file includes
all of the source in the repository for convenience.
3. Set up your CLASSPATH to include everything in the correct order:
a. Your source files should be in your CLASSPATH first. Note that you
cannot point to src.zip - you must unzip it, since it contains only
source files.
b. Next, add jt400.jar.
c. Your CLASSPATH should look something like this:
CLASSPATH=C:\jt400\MyApp;C:\jt400\jt400.jar;...
4. Compile your source.
5. Run your application.

<HR><A NAME="info"><H3>Support information</H3></A>

Documentation for JTOpen can be found on the Toolbox
web site at <A HREF="https://www.ibm.com/support/pages/node/1118781">https://www.ibm.com/support/pages/node/1118781</A>

The <A HREF="https://www.ibm.com/mysupport/s/forumsquestion?language=en_US&id=0D50z000060GKjGCAW">JTOpen Web forum</A> is available off in the community - IBM Toolbox for Java and JTOpen.

To subscribe/unsubscribe or view information about the JTOpen mailing list,
see <A HREF="https://lists.sourceforge.net/lists/listinfo/jt400-news">https://lists.sourceforge.net/lists/listinfo/jt400-news</A>
Please do not send messages to the JTOpen mailing list, as they will be bounced.
Instead, post your comments and questions to the <A HREF="https://www.ibm.com/mysupport/s/forumsquestion?language=en_US&id=0D50z000060GKjGCAW">JTOpen Web forum</A>.

For bug reports, please use the JTOpen bug database located at
<A HREF="http://sourceforge.net/tracker/?group_id=128806&atid=712772">http://sourceforge.net/tracker/?group_id=128806&atid=712772</A>
Other enhancements or fixes can be sent to <A HREF="mailto:rchjt400@us.ibm.com">rchjt400@us.ibm.com</A> (monitored weekly)
or posted to the <A HREF="https://www.ibm.com/mysupport/s/forumsquestion?language=en_US&id=0D50z000060GKjGCAW">JTOpen Web forum</A> (monitored daily).

<!--
The preferred channel for questions and comments is the Web forum.
The following individuals are the JTOpen Core Team members:
Name E-mail Company
------------------- --------------------------- ----------------------
Steve Johnson-Evers severs@everbrite.com <A HREF="http://www.everbrite.com">Everbrite, Inc.</A>
John Eberhard jeber@us.ibm.com <A HREF="http://www.ibm.com">IBM Corporation</A>
Wang Hui Qin wanghuiq@cn.ibm.com <A HREF="http://www.ibm.com">IBM Corporation</A>
Joe Pluta joepluta@plutabrothers.com <A HREF="http://www.plutabrothers.com">Pluta Brothers Design</A>
-->
For bug reports, please use github issues located at
<A HREF="/~https://github.com/IBM/JTOpen/issues">/~https://github.com/IBM/JTOpen/issues</A>.

</PRE>
</BODY>
Expand Down

0 comments on commit 0c29a26

Please sign in to comment.