Dovetailed Technologies Solutions Support Contact Us

2. Installation

The following steps are required to install the T:Z Quickstart for Tomcat package.

  1. Download the zip file to your workstation and extract the contents to a local directory.

  2. Transfer the XMIT file from your workstation to the z/OS system. Please be sure that you upload the following files in binary (no translation).

    If you are uploading using FTP, use the following commands (substituting your own dataset high-level qualfier for "HLQ"):

    ftp myzos.myco.com
    (Log in with your host name, user ID, and password.)
    ftp> bin
    ftp> quote site recfm=fb
    ftp> quote site lrecl=80
    ftp> quote site cyl
    ftp> quote site pri=8
    ftp> put zos.tomcat.xmit 'HLQ.TOMCAT.XMIT'
    ftp> quit

    If you are uploading using Personal Communications, then use the following commands to transfer the file. Be sure that you are logged on the host and within the READY mode (outside ISPF). Change the session string ("A:") and the destination "HLQ" as appropriate:

    send zos.tomcat.xmit A:'HLQ.tomcat.xmit' recfm(f) lrecl(80)
      space(8,3) cylinders

    If you are uploading with an SSH sftp client like PuTTY with Co:Z SFTP on z/OS, you can use the following commands:

    psftp myid@myzos.myco.com
    psftp> ls /+mode=bin,recfm=fb,lrecl=80,space=cyl.8.3
    psftp> put zos.tomcat.xmit //HLQ.TOMCAT.XMIT

  3. To unload the XMIT dataset into a PDS, enter the following TSO command:

    receive inda('HLQ.TOMCAT.XMIT')

    When prompted with the message: Enter restore parameters...", enter the following, supplying your own target dataset name:

    da('HLQ.TOMCAT.INSTJCL')

    [Note]Note

    If you get an error "Unable to issue message with prompt for reply", then enable prompting with the following TSO command:

    profile prompt

  4. Customize the INSTALL member of the INSTJCL PDS, following the comments included in the JCL. The TCHOME JCL symbol will reference an empty HFS or zFS directory that has 10MB of free space, plus any space that is required for your own web applications.

    Run this job and verify that all steps complete with a condition code of zero.

    [Note]Note

    It is also possible to have a single common Tomcat home (aka "CATALINA_HOME") directory that is shared by many Tomcat instances that have their own "CATALINA_BASE" directories that contain web applications and work/temp space.

Copyright 2009 Dovetailed Technologies, LLC. All rights reserved.