To do any Java Servlet or JSP development on the iSeries, you can use either Websphere Application Server or Apache Tomcat Server. RJS Software recommends the Apache Tomcat Server because it is a freely deployable Java servlet engine and can also serve up web pages. 
Since Apache Tomcat Server is difficult to set up on the iSeries, RJS has put together an automated installation procedure to jump-start your Apache Tomcat Server set-up. This installation procedure is FREE and without support, except for RJS Software customers who are using Tomcat with RJS products. This installation procedure has been tested on V5R1, V5R3, and i5 Model 520. 
If you have comments on this installation procedure, contact Technical Support.

Standard Disclaimer

No warranty is implied as to the usage or fitness of this software on your iSeries system. RJS Software Systems Inc. cannot be held liable for any problems or data loss that occurs on your iSeries system because of installation and use of this software. 


  • Apache Tomcat Server version 5.5.15.
  • V5R1 or above. 
  • IBM Java Virtual Machine version 1.5 (available from IBM via PTF). To check for this prerequisite, run:

    WRKLNK OBJ('/qibm/ProdData/Java400/jdk15')

  • TCP/IP port 7080 must be available. To check this port:
    • Observe the local ports.
    • If 7080 is already in use, see the Apache Tomcat documentation to change Tomcat's configuration.

      Note: If you need to change Tomcat's configuration, all Tomcat files are stored in IFS folder /TOMCAT5515. To access the Tomcat IFS folder:

      1. WRKLNK OBJ('/tomcat5515')
      2. On the folder where you need to change the Tomcat settings, use option 5.
      3. On the file you need to change, use option 2 to edit. 

Making Java Virtual Machine Version 1.5 the Default

To make the default Java Virtual Machine version 1.5:
Warning: If you have other applications using Java on the iSeries, don't make this change until off-hours when you can test.
  1. Edit the Java system properties file:

    EDTF STMF('/qibm/userdata/java400/')  

  2. Make the following changes:


  3. Save and exit the properties file.

Installing Apache Tomcat

To download and install Apache on the iSeries:
  1. Download and run the RJS Software Apache Tomcat 5.5.15 FTP Installer to upload and restore the library automatically.

    Note: Make sure to use a security officer level user with *ALLOBJ authority.

  2. After the RJSTOMC55 library is installed, run the following commands to restore the Apache Tomcat IFS Folder /TOMCAT5515:

      These commands may take a few minutes to run.

      Note: If you have trouble restoring objects:

      1. Check the job log to see if it is an ownership issue.
      2. If so, create a user profile named RJSOWNER and re-run the RSTTOMCAT command.
      3. After the objects have been restored, delete the RJSOWNER profile.
      4. Change the parameter for Owned object value to *CHGOWN and specify a profile name.
  3. Make sure the Tomcat folder was installed:

    WRKLNK OBJ('/tomcat5515')

  4. Start Apache Tomcat Server in the QSYSWRK subsystem:


    The initial Apache Tomcat Server start-up may take a few minutes because the iSeries needs to compile some of the Tomcat objects and JSP pages. This process happens automatically.

    Note: If you need to shut down Apache Tomcat Server in the QSYSWRK subsystem, use ENDTOMCAT.

  5. After Apache Tomcat Server is started, there a job in QSYSWRK named TOMCATSVR. To check that this job is running, use:


  6. Make sure that Apache Tomcat Server is using the TCP/IP port 7080 by checking the local ports:


  7. Use the following URL to access the Apache Tomcat home page, substituting your iSeries IP address for

    If the Apache Tomcat home page displays, you have correctly configured Apache Tomcat. 

  8. Install all your custom Tomcat Java, JSP, and Servlet applications in the /tomcat5515/webapps IFS folder.

    Once you have copied the applications into the WEBAPPS folder, you can access them with Apache Tomcat Server. 

You are now set up to develop Java and JSP pages on your iSeries and use Apache Tomcat Server.

Still have questions? We can help. Submit a case to technical support

Last Modified On:
You don't have the appropriate permissions.
No, open a new Support Case