This wiki page tells you how to run the JBoss application server on OS/390 and
z/OS. OS/390 and z/OS operate identically as z/OS is the newer replacement for
OS/390 and we'll use z/OS in the documentation. Also, JBoss is run under the
Unix Systems Services environment on your z/OS system.
NOTE: These instructions show how to install JBoss AS 3.x on JDK 1.3. The instructions should be almost identical for JBoss AS 4.x on JDK 1.4.
The first thing to note is this environment is NOT an ASCII environment.
All shell scripts MUST be in EBCDIC. The Java environment can run in ASCII mode
against the ASCII encoded components in JBoss and is started using the javacmd
shell script that sets up the ASCII execution and pipes the console output
through an ASCII to EBCDIC filter for printing on the terminal.
To install JBoss on z/OS:
1. Insure that you have IBM's z/OS JDK 1.3.1 installed.
$ java -version java version "1.3.1" Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1) Classic VM (build 1.3.1, J2RE 1.3.1 IBM OS/390 Persistent Reusable VM build m131s-20021114a (JIT enabled: jitc))
2. Copy the JBoss installation zip file to your system, be sure to specify
$ ftp zossystem ftp> user youruser Password: yourpassword ftp> cd /tmp ftp> bin ftp> put jboss-3.0.4.zip ftp> quit
3. Copy the z/OS specific files to your z/OS system, be sure to specify binary.
$ ftp zossystem ftp> user youruser Password: yourpassword ftp> cd /tmp ftp> bin ftp> put os390.tar.Z ftp> quit
4. On your z/OS system change to the directory where you want JBoss installed:
$ cd /usr/local
5. Usr jar to extract the JBoss zip file
$ jar xf /tmp/jboss-3.0.4.zip
6. Extract the z/OS specific files:
$ cd jboss-3.0.4/bin $ pax -rzf /tmp/os390.tar.Z
7. Copy up the EBCDIC shell scripts to bin:
$ cp os390/*.sh ./ $ chmod +x *.sh
8. You are now ready to run JBoss.
Some support programs for z/OS under the .../bin/os390 directory:
1. a2e - An ASCII to EBCDIC pipe.
2. acnv - An ASCII to EBCDIC conversion script.
3. avi - An ASCII editor (Converts the file to EBCDIC and runs vi).
4. e2a - An EBCDIC to ASCII pipe.
Some release notes:
1. Clustering does not work as there are know problems with multicast on this
2. All the JBoss text files are in ASCII and you need to use the avi, acnv or
a2e to process them. This includes the log files.
Contributions on installing newer versions of JBoss on OS390 and AS/400 platforms.