Running ActiveMQ on z/OS

It is relatively straightforward to run the ActiveMQ broker on z/OS.

There are a couple of steps:

1. Copy ActiveMQ to z/OS
2. Modify the configuration
3. Run using JZOS
4. Test

Copy ActiveMQ to z/OS

  • Ensure that the 1.5 JVM is available on z/OS, together with the JZOS component.
  • Download the .zip version of ActiveMQ from Apache.
  • FTP the broker to a suitable directory in USS.
  • Log into USS using rlogin or whatever has been configured at your site to do a login into USS.
  • Extract the zip file using the command: jar -xvf apache-activemq-5.0.0.zip
  • This will extract the whole package in ASCII, so do not except any of the files to be viewable on z/OS, except using special editors suitable for ASCII.
  • Maybe rename the directory to which the files were extracted to something shorter or create a softlink for more convenient access.

Modify the configuration

Currently, the Jetty plugin does not work on z/OS, so need to be disabled in the activemq.xml file.

  • FTP the activemq.xml file from the conf directory in the ActiveMQ installation to your PC in binary mode.
  • Edit the XML file using your XML editor or a text editor like Wordpad.
  • Search for "jetty" in the XML.
  • Change the comment block so that jetty is completely commented out.
  • Save the file.
  • FTP the file back into the location on z/OS it came from, again in binary mode, so that it is preserved as an ASCII file.

Run using JZOS

I have renamed the lib/optional directory in USS and shortened some of the lib/optional jar names to make the JCL easier to handle. The JCL to run the ActiveMQ broker is then:

ACTIVEMQ.JCL

Test

Once the broker has been started on z/OS, modify one of the example application to have the hostname of the z/OS system and run it to confirm that the broker is functioning correctly.

You can also gather information about the broker as usual using jmx.

© 2004-2011 The Apache Software Foundation.
Apache ActiveMQ, ActiveMQ, Apache, the Apache feather logo, and the Apache ActiveMQ project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Graphic Design By Hiram