Install Apache Tomcat

  1. As a prerequisite, the Java Runtime Environment 1.5Start of change or laterEnd of change (31–bit) must be installed under z/OS.
  2. Start of changeAlthough any version of Tomcat above 5.5 can be used, to properly secure RMM using SAF/RACF, we recommend downloading the "T:Z - Quickstart for Tomcat" package provided by Dovetailed Technologies LLC. It can be downloaded from the following site: http://dovetail.com/downloads/tomcat/index.html.

    Please follow the instructions provided by Dovetailed Technologies, LLC to download, transmit and extract Tomcat to the Tomcat installation directory within the UNIX system services on your target z/OS system

    End of change
  3. Ensure these environmental variables are set: Start of change
    $CATALINA_HOME=tomcat_directory
    End of change Start of change(Replace tomcat_directory by your actual Tomcat installation directory.) End of changeYou can make these settings by appropriate "export" statements within $HOME/.profile or /etc/profile. For example:
    export CATALINA_HOME=$HOME/tomcat/apache-tomcat-Start of changex.x.xEnd of change
    export _BPXK_AUTOCVT=ON
    Also verify that the $JAVA_HOME variable is set to the actual Java home directory and that the $PATH variable contains $JAVA_HOME/bin. The $LIBPATH must contain $JAVA_HOME/bin and $JAVA_HOME/bin/classic.
  4. To make the Tomcat script files executable, tag them as follows:
    chtag -t -c ISO8859-1 $CATALINA_HOME/bin/*.sh
  5. The DFSMSrmm Web service uses a C++ DLL from the z/OS Link List. The program object is called EDGXHCLL. To make this DLL available for the DFSMSrmm Web service, install a link in the systems library path ($LIB_PATH). Go to the library path in the file system, for example: /usr/lib, and type "ln -e EDGXHCLL libEDGXHCLL.so". This step establishes an external link to the DLL in LINKLST.