The following steps are required to install the
T:Z Quickstart for Tomcat package.
Download the zip file to your workstation and extract the contents to a local directory.
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
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]](images/note.gif)
Note If you get an error
"Unable to issue message with prompt for reply", then enable prompting with the following TSO command:profile prompt
Customize the
INSTALLmember of theINSTJCLPDS, following the comments included in the JCL. TheTCHOMEJCL 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]](images/note.gif)
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.