-
Notifications
You must be signed in to change notification settings - Fork 30
/
Copy pathreadme.html
192 lines (139 loc) · 8.39 KB
/
readme.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
<HTML>
<HEAD>
<TITLE>JTOpen README</TITLE>
</HEAD>
<BODY>
<H2>IBM Toolbox for Java - JTOpen Version</H2>
<PRE>
Copyright (C) 1997-2024 International Business Machines Corporation and
others. All rights reserved.
File: README
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="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
IBM Toolbox for Java web site:
<A HREF="https://www.ibm.com/support/pages/node/1118781">https://www.ibm.com/support/pages/node/1118781</A>
<HR><H3>Contents</H3>
<A HREF="#what">What is the Toolbox?</A>
<A HREF="#why">Why Open Source?</A>
<A HREF="#diff">Differences between JTOpen and the Toolbox LPP</A>
<A HREF="#down">Download and installation of JTOpen</A>
<A HREF="#req">Requirements</A>
<A HREF="#files">Files</A>
<A HREF="#use">Building and Using JTOpen</A>
<A HREF="#toolbox">Using the Toolbox LPP</A>
<A HREF="#info">Support information</A>
<HR><A NAME="what"><H3>What is the Toolbox?</H3></A>
The IBM Toolbox for Java is a set of Java classes that allow you to
access IBM i, i5/OS, or OS/400 data through a Java program. With these classes,
you can write client/server applications, applets, and servlets that work
with data on your IBM i, i5/OS, or OS/400 system. You can also run Java
applications that use the IBM Toolbox for Java on the IBM i, i5/OS, or
OS/400 Java Virtual Machine.
The Toolbox is available as an installable licensed program for the iSeries
as of OS/400 V7R5. Here is a breakdown of the supported
Toolbox releases versus operating system versions:
Toolbox Installs on Connects to
release LPP release OS/400 version OS/400 version
------- -------------- -------------- --------------
JTOpen 6.1+ 5761JC1 V6R1M0 V5R3 and up V5R3 and up
JTOpen 7.0+ 5770SS1 V7R1M0 V5R4 and up V5R4 and up
JTOpen 8.0+ 5770SS1 V7R2M0 V6R1 and up V6R1 and up
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.
Newer versions of the Toolbox are backwards-compatible with earlier
versions. Upgrading to a newer version is usually recommended, with the one
main exception being that the Toolbox is only supported for connection
to servers running an in-service release of i5/OS or OS/400.
<HR><A NAME="why"><H3>Why Open Source?</H3></A>
We have chosen to make the Toolbox code open source for the following reasons:
1. To obtain new functions and features from the Toolbox user community.
2. To respond with customer and business partners requirements as rapidly
as possible.
3. To improve the ability for our customers to build and debug their own
applications when using the Toolbox functions.
4. To continue the drive to keep the IBM i platform a leader with Java technology
for application development.
<HR><A NAME="diff"><H3>Differences between JTOpen and the Toolbox LPP</H3></A>
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.
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
to the Toolbox LPP and made available in a future PTF or service pack.
3. Any new functionality that is committed to JTOpen will be subsequently
added, when applicable, into the Toolbox LPP and made available in a
future PTF or service pack.
Note: All changes to JTOpen are made under the control and at the
discretion of the JTOpen Core Team. All changes to the Toolbox LPP
are made under the control and at the discretion of IBM.
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 <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.
<HR><A NAME="down"><H3>Download and installation of JTOpen</H3></A>
<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.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 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
communicate with the server from a client.
c. If the Java application using JTOpen is being run directly on a server
running IBM i, i5/OS, or OS/400, then certain JTOpen functions might use
native API and/or local socket calls to improve performance.
This will only occur under certain conditions, and only if the file
jt400Native.jar is included in the application's CLASSPATH.
<A NAME="files"><H4><U>Files</U></H4></A>
JTOpen is comprised of the following files:
Jar file Contents
-------- --------
jt400-_._._-sources.jar This is a zip file of all the source files in the repository.
It is not a Java jar file.
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.
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.
jt400-_._._-java11.jar This is the main JTOpen jar file compiled for Java 11.
A Java 11 JVM is required to use this class.
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.
-->
<A NAME="use"><H4><U>Building and Using JTOpen</U></H4></A>
Instructions for using JTOpen:
1. Download the JTOpen jt400.jar.
2. Add it to your CLASSPATH.
3. 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>
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.
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>
</HTML>